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.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowDeveloper ToolsMedia & Design

Overview

AI-generated 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.
Before you install
Requires an Umlout API key in the Authorization header; keep it private and rotate or revoke it in your account. Tools can create, change, delete and restore projects, boards, objects, relations, types and files, and can share a project publicly, so check scope before use. The assistant sees only projects your account can access, but project content is sent to the hosted Umlout service. Rate limits apply: 300 tool calls per minute and 600 write calls per hour.

Installation

In SourceWeft

  1. Open Umlout in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. 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.

Read the install guide the agent follows

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
bash
claude mcp add --transport http umlout https://www.umlout.com/mcp/http --header "Authorization: Bearer YOUR_API_KEY"

More options, including project scope: examples/claude-code.md.

Cursor · VS Code

~/.cursor/mcp.json:

json
{  "mcpServers": {    "umlout": {      "url": "https://www.umlout.com/mcp/http",      "headers": { "Authorization": "Bearer YOUR_API_KEY" }    }  }}

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):

json
{  "mcpServers": {    "umlout": {      "command": "npx",      "args": [        "-y", "mcp-remote", "https://www.umlout.com/mcp/http",        "--header", "Authorization: Bearer YOUR_API_KEY"      ]    }  }}

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:

clientfileaddress field
Cursor~/.cursor/mcp.jsonurl
Gemini CLI~/.gemini/settings.jsonhttpUrl
Antigravity~/.gemini/config/mcp_config.jsonserverUrl
Devin Desktop (formerly Windsurf)its mcp_config.json (MCPs → View raw config)serverUrl
json
{  "mcpServers": {    "umlout": {      "serverUrl": "https://www.umlout.com/mcp/http",      "headers": { "Authorization": "Bearer YOUR_API_KEY" }    }  }}
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:

bash
python3 scripts/check_connection.py --api-key YOUR_API_KEY

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.

AreaWhat the assistant can do
ProjectsCreate, list, read, rename, share publicly and delete projects
BoardsCreate boards in a project, find them by name, rename, point the camera, clear, delete and restore
Objects and foldersCreate objects, folders and relations in one call; update, merge duplicates, give an object its own detail board
RelationsCreate and update relations with UML detail; reverse a relation's direction
Types and fieldsBrowse the catalogue's types; declare the project's own types; describe each type's fields — text, number, yes/no, choice, markdown, reference, counter, computed, file, list of pairs — and the template an object of the type is drawn with
Shared fieldsDescribe a field once and use it in several types
Shapes and connectionsDraw figures of objects and free figures, UML classes with their compartments, connections with UML notation, sequence messages, custom anchor points; update and delete one at a time or hundreds per call
Composite figures and palettesSave a set of figures as one card and place it again; redraw older copies; arrange the toolbar's palettes
FilesUpload files into a project, rename, delete and restore them; show an image in an Image figure
CommentsAdd, list, resolve and delete comments and replies on any figure or line
Deleted itemsList what was deleted in a project and restore it — a board, an object, a relation, a type, a shared field or a file
Plan and limitsRead the plan's quotas and what is left of the rate-limit budgets

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 status field 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.

LimitValue
Tool calls300 per minute
Write tool calls600 per hour
Bulk write calls (bulk_*)600 per hour, in addition to the write budget

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

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v1.2.0LatestOct 6, 2026
  2. 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