MCP binding

MCP is the open wire. This page is only the mapping.

Resources

URIBody
synth://<id>Descriptor JSON
synth://<id>/presencePresence JSON

A host may also serve GET /synths/<id> and GET /synths/<id>/presence with the same bodies.

Tools

Tools on the synth are ordinary MCP tools. Names listed in the descriptortools array shall match tools/list.

Keep the tool count small. Five is a working ceiling for a local model. More tools means another synth, not a bigger toolbox.

What not to expose

Do not put construction specs, model deny lists, credentials, or prompt files on the MCP surface.

Instruments vs workers

The public instruments MCP at /mcp calculates thermal load and serves catalog facts. That is not a synth. A synth MCP serves a named worker: descriptor, presence, and the tools in her write allowlist.