Metadata-Version: 2.4
Name: docdiagram-mcp
Version: 0.1.0
Summary: DocDiagram MCP Server - Embedded diagrams in MDX docs for AI assistants
Project-URL: Homepage, https://github.com/docdiagram/agents
Project-URL: Documentation, https://docs.docdiagram.com/mcp
Project-URL: Repository, https://github.com/docdiagram/agents
Project-URL: Issues, https://github.com/docdiagram/agents/issues
Author-email: DocDiagram <support@docdiagram.com>
License: MIT
License-File: LICENSE
Keywords: ai,claude,diagrams,docdiagram,mcp,mdx,mintlify
Requires-Python: >=3.11
Requires-Dist: fastmcp<4.0,>=3.3
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# 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

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

## Configure

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

```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](RELEASING.md) for the tagged-release publish flow and the
registry submission runbook.

## License

MIT
