docdiagram-mcp

MCP server exposing the DocDiagram API to any MCP-compatible client (Claude Code, Cursor, Continue, Cody). The same surface area as the Claude Code skills in ../skills/, expressed as typed tool calls.

Install

uvx docdiagram-mcp        # one-shot, recommended
# or
pip install docdiagram-mcp

Configure

Set DOCDIAGRAM_API_KEY or create ~/.docdiagram/config.yaml:

api_key: dd_live_xxxxxxxxxxxxx
server_url: https://app.docdiagram.com   # optional, defaults to prod

Mint a key with the Claude Code plugin: claude /docdiagram:auth.

Tools

Repos

• repo_upsert - register or refresh a repo (idempotent on host_id)
• repo_lookup - look up by GitHub node id
• repo_get - fetch by DocDiagram UUID

Embedded diagrams

• embedded_diagram_create - bind a new diagram to (repo, docs_path, slot)
• embedded_diagram_revise - follow-up prompt against an existing binding
• embedded_diagram_regenerate - re-run the last prompt
• embedded_diagram_get - fetch a binding by id
• embedded_diagram_by_sidecar - fetch by (repo, docs_path, slot)
• embedded_diagram_list_for_repo - cursor-paginated list
• embedded_diagram_delete - soft-delete
• embedded_diagram_render_svg - return an SVG URL (bytes not inlined)
• embedded_diagram_render_png_url - return a PNG URL

Sync (requires GitHub App install per TECH-064)

• sync_start - open a PR with pending revisions
• sync_get_status - poll a sync run
• sync_list - list recent runs

Releasing

See RELEASING.md for the tagged-release publish flow and the registry submission runbook.

License

MIT