Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PD_EXENoPath to the Pure Data executable for headless sessions
PD_GUI_EXENoPath to the Pure Data executable for visible GUI sessions

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
pd_start_demoB

Generate a Vanilla Pure Data demo patch, launch Pd headless by default or with gui=true, optionally from an absolute targetPath, start DSP, and prepare FUDI control.

pd_open_patchA

Launch an existing absolute .pd patch path as the MCP-managed Pd process for status, preview, save, and stop.

pd_start_live_sessionC

Create and launch a visible live-edit Pd patch with an empty agent-managed canvas ready for pd_live_replace_graph.

pd_create_live_patchA

Write a live-edit bridge .pd file with known control/edit ports so the user can open it manually and Codex can attach later.

pd_attach_live_sessionB

Attach to an already-open MCP live-edit Pd patch by control/edit ports, optionally loading its patchPath for preview and save.

pd_set_paramsC

Update bounded live parameters on the running Pd demo patch.

pd_send_controlB

Send a safe raw control message to the running live patch control bus for parameter tweaks without rebuilding the canvas.

pd_live_add_objectA

Add one safe-palette object to the visible MCP live canvas. Use only for tiny follow-up edits; for complete musical patches, generate a full graph and call pd_live_replace_graph once.

pd_live_connectA

Connect two agent-created live objects by stable ids. Use only for small follow-up edits; prefer pd_live_replace_graph for full patch updates. Direct signal-to-dac~ connections are blocked.

pd_live_move_objectC

Move an agent-created live object by rebuilding the visible MCP live canvas at the new coordinates.

pd_live_remove_objectB

Remove an agent-created live object and its incident connections, then rebuild the visible MCP live canvas.

pd_live_disconnectA

Remove an agent-created live connection by stable id, then rebuild the visible MCP live canvas.

pd_live_update_objectB

Update an agent-created live object's type, arguments, or coordinates, then rebuild the visible MCP live canvas.

pd_live_replace_graphB

Preferred live composition path: replace the entire agent-managed live graph with a safe precomposed graph, then render it into the visible Pd GUI canvas.

pd_live_clearA

Clear the agent-managed MCP live canvas and reset its object ids.

pd_live_graphB

Return the agent-managed live patch object and connection graph.

pd_stopB

Silence and stop the currently running Pd process.

pd_statusA

Return Pd lifecycle state, patch path, parameters, and recent errors.

pd_list_audio_devicesA

Best-effort query of Pd audio devices using the configured Pd binary.

pd_preview_patchA

Return the current generated Vanilla .pd patch text.

pd_save_patchB

Write the current generated Pd patch, including the live canvas, to the active patch file or an absolute targetPath.

Prompts

Interactive templates invoked by user choice

NameDescription
pd-demo-soundcheckStart a quiet Pd demo and confirm audible output safely.
pd-natural-controlTranslate qualitative sound requests into bounded Pd parameter changes.
pd-debug-sessionInspect status, logs, and patch text when Pd does not make sound.
pd-live-patchingBuild and revise visible Pd GUI patches with safe live edit tools.
pd-live-composition-workflowEfficient workflow for generated music patches that remain live-editable.

Resources

Contextual data attached and managed by the client

NameDescription
pd-session-statusCurrent Pd lifecycle state and safe control parameters.
pd-current-patchGenerated Vanilla .pd patch text for the active or preview session.
pd-recent-logsBounded stdout/stderr lines from the Pd process.
pd-parameter-schemaMachine-readable ranges for controllable v0.1 sound parameters.
pd-live-graphAgent-managed live patch objects and connections.
pd-live-composition-workflowRecommended efficient workflow for substantial live-editable music patches.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/damagethundercat/PureData-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server