UML Forge
MCP server producing UML and architecture diagrams, threat models and docs from code
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- today
Similar MCP servers
About UML Forge
UML Forge is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
UML Forge's connector gives a coding agent 15 tools, 14 for diagrams plus umlforge_get_result. The generators cover reverse engineering a codebase or GitHub URL into class, sequence and state diagrams, API request-flow sequences, entity-relationship diagrams from descriptions or SQL, state machines, frontend component hierarchies, deployment and CI/CD pipelines, event-driven flows, agent topologies, C4 context diagrams for non-technical stakeholders, and STRIDE threat models with an attack surface diagram. The registry says output is Mermaid.
Others update existing diagrams after a sprint or pull request, build a day-one onboarding package, and produce legacy structure and modern architecture diagrams plus a six-phase migration roadmap from languages such as COBOL, Fortran, ABAP and RPG. umlforge_suggest recommends the right tool from a plain-English goal, and a report_mode switch adds a written analysis.
A UMLFORGE_API_KEY is required, with a free tier. Generations that take more than 45 seconds return a job ID that umlforge_get_result retrieves for an hour.
Install
Run in a terminal
claude mcp add umlforge --env UMLFORGE_API_KEY='<UMLFORGE_API_KEY>' -- uvx umlforgeAdd to claude_desktop_config.json
{
"mcpServers": {
"umlforge": {
"command": "uvx",
"args": [
"umlforge"
],
"env": {
"UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"umlforge": {
"command": "uvx",
"args": [
"umlforge"
],
"env": {
"UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"umlforge": {
"type": "stdio",
"command": "uvx",
"args": [
"umlforge"
],
"env": {
"UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"umlforge": {
"command": "uvx",
"args": [
"umlforge"
],
"env": {
"UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"umlforge": {
"command": "uvx",
"args": [
"umlforge"
],
"env": {
"UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
UMLFORGE_API_KEYYour UML Forge API key — get one free at https://umlforge.devRequired
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- umlforge_suggest
- Suggests the right tool for a goal.
- umlforge_reverse_engineer
- Creates class, sequence and state diagrams from code.
- umlforge_api_sequence
- Creates request-flow sequence diagrams.
- umlforge_erd_schema
- Creates entity-relationship diagrams.
- umlforge_state_machine
- Creates state diagrams.
- umlforge_frontend_components
- Creates component diagrams.
- umlforge_deployment
- Creates infrastructure and CI/CD diagrams.
- umlforge_threat_model
- Creates a STRIDE threat model.
- umlforge_event_driven
- Creates event flow diagrams.
- umlforge_ai_agent
- Creates agent topology diagrams.
- umlforge_stakeholder_arch
- Creates C4 context diagrams.
- umlforge_living_docs
- Updates existing diagrams.
- umlforge_onboarding
- Builds an onboarding package.
- umlforge_legacy_migration
- Creates migration diagrams and a roadmap.
- umlforge_get_result
- Retrieves a still-running generation.
What it does
- 15 diagram tools
- Class, sequence, ERD, state, deployment and more.
- Threat modelling
- STRIDE model with an attack surface diagram.
- Living docs
- Update diagrams to match sprint or PR changes.
- Legacy migration
- Roadmap and diagrams from COBOL, ABAP and similar.
- Tool suggestion
- umlforge_suggest picks the right tool for a goal.
- Long-job handling
- Retrieve slow generations with a job ID.
Good for
- Diagram an unfamiliar repository
- Generate a threat model for a feature
- Create an onboarding package for a new engineer
- Plan a legacy system migration
- Refresh architecture docs after a PR
Pricing
Freemium
Free tier available; paid pricing not described
UML Forge FAQ
Do I need an API key?
Yes, UMLFORGE_API_KEY, with a free tier available at umlforge.dev.
What if generation takes too long?
The tool waits up to 45 seconds and then returns a job ID for umlforge_get_result, kept for an hour.
What does it require locally?
Python 3.11 or newer; the registry lists a PyPI package run with uvx.
What licence is the connector?
MIT.
Is UML Forge free?
UML Forge has a free plan, with paid plans for more usage or features.
How do I add UML Forge to Claude Code?
Run this command in your terminal: claude mcp add umlforge --env UMLFORGE_API_KEY='<UMLFORGE_API_KEY>' -- uvx umlforge
What are the best alternatives to UML Forge?
The closest alternatives to UML Forge are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


