UML Forge MCP Connector

Architecture intelligence, security analysis, and living documentation — inside your coding agent.

UML Forge gives Claude Code, Cursor, Windsurf, and any MCP-compatible coding agent a suite of 15 tools (14 diagram tools plus umlforge_get_result) for producing professional UML diagrams from your codebase, schema, or architecture descriptions.

Quick start

Claude Code:

{
  "mcpServers": {
    "umlforge": {
      "command": "uvx",
      "args": ["umlforge"],
      "env": { "UMLFORGE_API_KEY": "your-api-key" }
    }
  }
}

Cursor / Windsurf — add the same block to your MCP settings.

Get your API key at umlforge.dev.

Tools included

All diagram tools accept report_mode=True to generate a written analysis report alongside the diagram. Leave report_mode unset to follow your account's saved preference (the dashboard toggle); report_mode=False forces diagrams only.

Long-running generations

A detailed diagram can take a minute or two, and some MCP clients cancel any tool call after about 60 seconds. UML Forge tools therefore wait up to 45 seconds for the result. If a diagram is still generating, the tool replies with a job id and umlforge_get_result retrieves it when it is ready (results are kept for one hour). Clients with longer timeouts can wait longer by setting UMLFORGE_WAIT_SECONDS (5-200) in the env block of your MCP configuration.

Requirements

• Python 3.11+
• An API key from umlforge.dev (free tier available)

License

MIT — see LICENSE.