Skip to content
MCP server

UML Forge

MCP server producing UML and architecture diagrams, threat models and docs from code

Runs locallyStatus and history
Install
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 umlforge

Add 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.

How AIPoweredBot checks servers