MCP

Assistants.

Fulmetry exposes an authenticated Model Context Protocol endpoint at /mcp. Connections are bound to one workspace and to scopes that can only narrow your own role.

Tools

• list_projects — projects in the connected workspace.
• get_project_summary — what the project contains at its head snapshot: boards, printable parts, imports, dependencies, checks and fit evidence, observations from physical units and open proposals.
• get_design_summary — one board's head revision, unrouted nets, unresolved parts and latest evidence.
• get_package_readiness — release-policy gates and findings for a PCB, printed-parts or combined package (read-only).
• propose_change — records board commands and/or project commands (parts, enclosures, assembly) as a proposal against a base revision or snapshot. Mechanical proposals are prepared on the CAD runner before review. Nothing changes until a person accepts it.
• get_agent_skill — the Fulmetry skill for clients that support skills.

Account linking

Production linking uses OAuth 2.1 with PKCE through a maintained authorization server (qualification in progress). Preview environments issue scoped tokens from Settings → Connected apps; revoking a connection stops it immediately.

curl -s https://your-host/mcp   -H "Authorization: Bearer fmcp_…"   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'