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 13 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

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.

Release files for umlforge 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for umlforge 0.2.0
File	Size	Uploaded
umlforge-0.2.0.tar.gz	704.7 kB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for umlforge 0.2.0
File	Interpreter	ABI	Platform	Reset
umlforge-0.2.0-py3-none-any.whl 21.5 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 726.2 kB

Release files / umlforge-0.2.0.tar.gz

Download URL	umlforge-0.2.0.tar.gz
Size	704.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a5ce849ff99f9ea6e5d1be21110f830640a72578286a3189c9e8bbbcea6db03a`
BLAKE2b-256 checksum How to use checksums	`fb75a583c55b8430bfaa35d403eb38c429957a612a4e49e0ddbe23117669b419`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.5`

Release files / umlforge-0.2.0-py3-none-any.whl

Download URL	umlforge-0.2.0-py3-none-any.whl
Size	21.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6d3774e5f362e3510dce84e1f9a6f5ec05a7078fac09abd1ad4ec4d49adce602`
BLAKE2b-256 checksum How to use checksums	`bb8f3447f9ff3b03779a2a44ab112a726f5d355134866ccf3f6ad10d405b3b2e`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.5`