
Umlout
io.github.dmkorjPublished by GitHub account dmkorjv1.2.0Updated Oct 24, 2026
Build Umlout projects: objects with types and fields, relations, and boards that draw them.
Overview
Hosted Umlout MCP server that lets an assistant build projects, objects and relations in your Umlout workspace and draw UML, flowchart, wireframe and other kind
- What you can do
- Create, list, rename, share publicly and delete projects, and create, find, rename, clear, delete and restore boards within them. Create objects, folders and relations, update or merge duplicates, and browse the type catalogue, declare project types and describe their fields. Draw figures of objects and free figures, UML classes, connections, sequence messages and custom anchors, updating or deleting them one at a time or in bulk. Upload, rename, delete and restore project files and show images in image figures. Add, list, resolve and delete comments and replies on figures or lines, list and restore deleted items, and read plan quotas and rate-limit budgets.
- When to use it
- Use it when you want an assistant to build or edit diagrams in an Umlout workspace, such as turning requirements or an OpenAPI spec into UML class, sequence or component diagrams, sketching flows as wireframes, or reading a board to check for gaps.
- Requirements
- A remote endpoint; nothing to install locally. Needs an Umlout account and an API key sent in the Authorization header as a Bearer token, or browser OAuth sign-in for clients that support it. Claude Desktop needs the mcp-remote bridge and Node.js. Requires network access.
Installation
In SourceWeft
- Open Umlout in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.dmkorj%2Fumlout/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"umlout": {
"type": "http",
"url": "https://www.umlout.com/mcp/http"
}
}
}README
Umlout MCP Server
Let your AI assistant draw on a real whiteboard.
Umlout exposes a hosted Model Context Protocol server, so Claude, Cursor, VS Code Copilot and any other MCP client can build and edit projects in your Umlout workspace — UML class, sequence, activity and state boards, flowcharts, wireframes, agile and planning boards, floor plans, dashboards and cloud architecture drawn with the AWS, Azure and Kubernetes icon sets.
Nothing to install and nothing to run: the server is hosted at https://www.umlout.com/mcp/http
(Streamable HTTP). The older SSE address, /mcp/sse, still answers, but an SSE session does not
survive a restart of the service, so a client pointed at it fails after every deploy until it is
reconnected by hand. Use /mcp/http.
You only need an API key.
Quick start
1. Get an API key. Sign in at umlout.com, open Profile → AI clients, pick your client and create a key. The profile page gives the exact text for your client with the key already in it.
2. Add the server to your client.
Claude Code
More options, including project scope: examples/claude-code.md.
Cursor · VS Code
~/.cursor/mcp.json:
VS Code reads a different shape — servers, not mcpServers, and "type": "http" — so use
examples/vscode.json in .vscode/mcp.json. It prompts for the key and
keeps it in VS Code's secret storage instead of a committed file.
Claude Desktop — via the mcp-remote bridge
Claude Desktop's config file does not take a remote URL directly, so route it through
mcp-remote (needs Node.js). Edit
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or
%APPDATA%\Claude\claude_desktop_config.json (Windows):
Then quit Claude Desktop completely and reopen it — closing the window is not enough.
Codex · Gemini CLI · Antigravity · Devin Desktop · other clients
Codex keeps the key out of its config and reads it from an environment variable — see examples/codex.md.
Every other client takes a JSON file with an address and a headers object; only the name of the
address field differs:
ChatGPT · Claude connectors · Grok — clients that take only an address
No key: give the client https://www.umlout.com/mcp/http. It opens an Umlout page where you
sign in and allow it. See docs/authentication.md.
3. Ask for a board:
Create a project "Auth" and draw a UML sequence diagram of the OAuth2 authorization code flow on a board in it.
Verify your setup at any time:
What it can do
95 tools across twelve areas, plus 4 read-only resources. Full reference with every argument: docs/tools.md and docs/resources.md.
Umlout stores a project, and a board is one view of it. A project holds objects — each with a name, exactly one type, its own properties and a description — and the relations between them. A figure on a board is one drawing of an object, so the same object can be drawn on five boards and is still one object; a line on a board is one drawing of a relation.
The figure vocabulary covers 205 figures — basic geometry, UML (class, use case, state, activity, sequence, component, deployment, timing), flowchart, charts and dashboard figures, agile and retrospective cards, plans with stages and tasks, floor plans, and a full wireframe kit — plus the AWS, Azure and Kubernetes icon libraries.
Things worth asking for
- "Turn this OpenAPI spec into a component diagram."
- "Sketch the mobile onboarding flow as wireframes — three screens."
- "Read the board 'Checkout' and tell me which states have no outgoing transitions."
- "Build a project from these requirements: orders, invoices, customers — one type per noun, with their fields — and draw a class board of it."
- "Add a
statusfield to every Task and count the done ones on each Stage."
Authentication and limits
Every request carries your key in Authorization: Bearer <key> (or X-API-Key), or an OAuth
token for a client that signs in through the browser. Both are scoped to your account — the
assistant sees exactly the projects you can see, with the role you have in each, and nothing else.
Details, key rotation and revocation: docs/authentication.md. Something not working? docs/troubleshooting.md.
About this repository
This repo is the public home of the Umlout MCP connector: documentation, client configs, the registry manifest (server.json) and a connection checker. The server itself is a hosted service — there is no local installation, so there is no server source here.
Issues and questions about the MCP integration are welcome in Issues.
License
MIT — documentation and examples.
Source: README.md at commit 3aca44b
Tools
0Version history
2- v1.2.0LatestOct 6, 2026
- v1.0.0Sep 16, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts