# UML Forge

> UML Forge is a freemium MCP server for developer tools. MCP server producing UML and architecture diagrams, threat models and docs from code. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Repository:** https://github.com/dave1362/umlforge-connector
- **MCP Registry name:** io.github.dave1362/umlforge
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add umlforge --env UMLFORGE_API_KEY='<UMLFORGE_API_KEY>' -- uvx umlforge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "umlforge": {
      "command": "uvx",
      "args": [
        "umlforge"
      ],
      "env": {
        "UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "umlforge": {
      "command": "uvx",
      "args": [
        "umlforge"
      ],
      "env": {
        "UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "umlforge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "umlforge"
      ],
      "env": {
        "UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "umlforge": {
      "command": "uvx",
      "args": [
        "umlforge"
      ],
      "env": {
        "UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "umlforge": {
      "command": "uvx",
      "args": [
        "umlforge"
      ],
      "env": {
        "UMLFORGE_API_KEY": "<UMLFORGE_API_KEY>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/uml-forge
