{
  "markdown": "# Umlout MCP Server\n\nLet your AI assistant draw on a real whiteboard.\n\nUmlout exposes a hosted [Model Context Protocol](https://modelcontextprotocol.io/) server, so\nClaude, Cursor, VS Code Copilot and any other MCP client can create and edit diagrams in your\n[Umlout](https://www.umlout.com) workspace — UML class and sequence diagrams, flowcharts, activity\ndiagrams, wireframes and domain models.\n\nNothing to install and nothing to run: the server is hosted at `https://www.umlout.com/mcp/sse`.\nYou only need an API key.\n\n---\n\n## Quick start\n\n**1. Get an API key.** Sign in at [umlout.com](https://www.umlout.com), open **Profile → MCP API\nKeys**, and create a key.\n\n**2. Add the server to your client.**\n\n<details open>\n<summary><b>Claude Code</b></summary>\n\n```bash\nclaude mcp add --transport sse umlout https://www.umlout.com/mcp/sse --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\nMore options, including project scope: [examples/claude-code.md](examples/claude-code.md).\n</details>\n\n<details>\n<summary><b>Cursor</b> · <b>VS Code</b> — clients that speak remote SSE natively</summary>\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"umlout\": {\n      \"url\": \"https://www.umlout.com/mcp/sse\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\nFor VS Code Copilot use [examples/vscode.json](examples/vscode.json) — it prompts for the key and\nkeeps it in VS Code's secret storage instead of a committed file.\n</details>\n\n<details>\n<summary><b>Claude Desktop</b> — via the <code>mcp-remote</code> bridge</summary>\n\nClaude Desktop's config file does not take a remote URL directly, so route it through\n[`mcp-remote`](https://www.npmjs.com/package/mcp-remote) (needs Node.js). Edit\n`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or\n`%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"umlout\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \"mcp-remote\", \"https://www.umlout.com/mcp/sse\",\n        \"--header\", \"Authorization: Bearer YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\nThen **quit Claude Desktop completely** and reopen it — closing the window is not enough.\n</details>\n\n**3. Ask for a diagram:**\n\n> Draw a UML sequence diagram of an OAuth2 authorization code flow on a new board called \"Auth\".\n\nVerify your setup at any time:\n\n```bash\npython3 scripts/check_connection.py --api-key YOUR_API_KEY\n```\n\n---\n\n## What it can do\n\n**37 tools** across four areas, plus **4 read-only resources**. Full reference with every argument:\n[docs/tools.md](docs/tools.md) and [docs/resources.md](docs/resources.md).\n\n| Area | What the assistant can do |\n|---|---|\n| **Diagrams** | Create, list, find, rename, clear and delete boards |\n| **Shapes & connections** | Add and edit shapes, draw connections with UML notation, place sequence messages, define custom anchor points, bulk-create hundreds of elements in one call |\n| **Domain models** | Build nestable folders → elements → relations; create a whole model tree in a single call |\n| **Comments** | Add, list, resolve and delete comments and replies on any element |\n\nThe shape vocabulary covers **70 types** — basic geometry, UML class/interface/package, sequence\n(actor, lifeline, activation, fragment), activity (action, decision, fork/join, swimlanes), and a\nfull wireframe kit (screens, buttons, inputs, navbars, tables, cards).\n\n### Things worth asking for\n\n- *\"Turn this OpenAPI spec into a component diagram.\"*\n- *\"Sketch the mobile onboarding flow as wireframes — three screens.\"*\n- *\"Read the board 'Checkout' and tell me which states have no outgoing transitions.\"*\n- *\"Build a domain model from these requirements: orders, invoices, customers.\"*\n\n---\n\n## Authentication and limits\n\nEvery request carries your key in `Authorization: Bearer <key>` (or `X-API-Key`). Keys are scoped\nto your account — the assistant sees exactly the diagrams you can see, and nothing else.\n\n| Limit | Value |\n|---|---|\n| Requests | 60 per minute |\n| Write tool calls | 600 per hour |\n| Bulk write calls (`bulk_*`) | 60 per hour |\n\nDetails, key rotation and revocation: [docs/authentication.md](docs/authentication.md).\nSomething not working? [docs/troubleshooting.md](docs/troubleshooting.md).\n\n---\n\n## About this repository\n\nThis repo is the public home of the Umlout MCP **connector**: documentation, client configs, the\nregistry manifest ([server.json](server.json)) and a connection checker. The server itself is a\nhosted service — there is no local installation, so there is no server source here.\n\nIssues and questions about the MCP integration are welcome in\n[Issues](https://github.com/dmkorj/umlout-mcp/issues).\n\n## License\n\n[MIT](LICENSE) — documentation and examples.\n",
  "bytes": 4720,
  "sha": "56c40bf6a60fa9173cb9ac57b49f620280d3dd693df45b1d95e278ad99891f5d",
  "repo_slug": "dmkorj/umlout-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dmkorj_umlout_bf2fe23e/readme"
}