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 14 specialised tools 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

Tool	Description
`umlforge_suggest`	Start here. Describe your goal in plain English — returns the right tool and a ready-to-run call
`umlforge_reverse_engineer`	Class, sequence, and state diagrams from a codebase or GitHub URL
`umlforge_api_sequence`	Sequence diagrams for request flows across services
`umlforge_erd_schema`	Entity-relationship diagrams from domain descriptions or SQL schemas
`umlforge_state_machine`	State diagrams from entity lifecycles and business rules
`umlforge_frontend_components`	Component hierarchy and interaction diagrams for UI features
`umlforge_deployment`	Infrastructure and CI/CD pipeline diagrams
`umlforge_threat_model`	STRIDE threat model + attack surface diagram
`umlforge_event_driven`	Event flow and pub/sub architecture diagrams
`umlforge_ai_agent`	Agent topology and tool-call flow diagrams for LLM pipelines
`umlforge_stakeholder_arch`	C4 context diagrams for investors, CTOs, and non-technical stakeholders
`umlforge_living_docs`	Update existing diagrams to reflect sprint or PR changes
`umlforge_onboarding`	Day-one knowledge-transfer package for new team members
`umlforge_legacy_migration`	Legacy structure + modern architecture diagrams and 6-phase migration roadmap from COBOL, Fortran, ABAP, RPG, and other legacy languages

All tools accept report_mode=True to generate a written analysis report alongside the diagram.

Requirements

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

License

MIT — see LICENSE.