Overture

v1.0.0Coding Agentsstable

Overture is an open-source, locally running web interface delivered as an MCP (Model Context Protocol) server that visually maps out the execution plan of any AI coding agent as an interactive flowchart/graph before the agent begins writing code.

ai-agentai-codingautomationclaudeclaude-code
Share:
619
Stars
0
Downloads
0
Weekly
0/5

What is Overture?

Overture is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to overture is an open-source, locally running web interface delivered as an mcp (model context protocol) server that visually maps out the execution plan of any ai coding agent as an interactive flowcha...

Overture is an open-source, locally running web interface delivered as an MCP (Model Context Protocol) server that visually maps out the execution plan of any AI coding agent as an interactive flowchart/graph before the agent begins writing code.

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Overture is an open-source, locally running web interface de

Use Cases

Visual AI agent execution planning
Interactive flowchart visualization
Code generation preview before execution
SixHq

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx overture

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Overture

Overture is an open-source MCP server that renders an AI coding agent's execution plan as an interactive visual flowchart in a local web UI before any code is written or commands are run. When an agent calls the submit_plan tool, Overture displays the proposed steps as a graph, waits for the user to approve, and then signals the agent to proceed — adding a human-in-the-loop gate that prevents expensive or irreversible actions. Teams use Overture with Claude Code, Cursor, Cline, Copilot, and other coding agents to gain visibility and control over multi-step agentic tasks.

Prerequisites

  • Node.js 18+ and npx available on your system PATH
  • An MCP client: Claude Code, Cursor, Cline (VS Code), GitHub Copilot (VS Code 1.99+), or compatible agent
  • A modern web browser (Overture opens a local UI at http://localhost:3031 by default)
  • No API keys required — Overture is a local-only visualization layer
1

Add Overture to Claude Code

The quickest way to install Overture is via the Claude Code CLI. This registers it as an MCP server that Claude Code will launch automatically.

claude mcp add overture-mcp -- npx overture-mcp
2

Configure Overture in Cursor

Add the Overture MCP server to Cursor's global MCP configuration file at ~/.cursor/mcp.json.

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}
3

Configure environment variables (optional)

Customize the web UI port, WebSocket port, and auto-open behavior using environment variables. OVERTURE_HTTP_PORT defaults to 3031, OVERTURE_WS_PORT to 3030, and OVERTURE_AUTO_OPEN to true.

claude mcp add overture-mcp -e OVERTURE_HTTP_PORT=4000 -e OVERTURE_AUTO_OPEN=false -- npx overture-mcp
4

Install globally for all clients

Optionally install the overture-mcp package globally so you can reference it by name without npx in any MCP client configuration.

npm install -g overture-mcp
5

Start your MCP client and give the agent a task

Launch your configured MCP client (e.g., Claude Code) and ask it to implement a feature. Overture will intercept the agent's plan submission, render it as a flowchart in your browser, and wait for your approval before execution continues.

Overture Examples

Client configuration

Claude Desktop or Cursor configuration for Overture with custom ports and auto-open disabled.

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "3031",
        "OVERTURE_WS_PORT": "3030",
        "OVERTURE_AUTO_OPEN": "true"
      }
    }
  }
}

Prompts to try

Example prompts that trigger Overture's plan visualization workflow when used with a supported coding agent.

- "Implement a user authentication flow with JWT tokens — show me the plan before writing any code"
- "Refactor the database layer to use a repository pattern — plan it out first"
- "Add end-to-end tests for the checkout flow and show each step in the flowchart"
- "Migrate this Express app to Fastify — I want to review the plan and approve each phase"
- "Set up CI/CD with GitHub Actions for this project, but pause before making any file changes"

Troubleshooting Overture

The Overture web UI does not open automatically

Check that OVERTURE_AUTO_OPEN is not set to false in your config. If it was accidentally disabled, navigate manually to http://localhost:3031 in your browser. Also verify that port 3031 is not blocked by a firewall or in use by another process.

Agent proceeds without showing a plan in Overture

Overture only intercepts plans submitted via the submit_plan MCP tool. The agent must be explicitly instructed to plan before acting (e.g., by adding 'show me the plan first' to your prompt, or by using a system prompt that requires plan submission). Not all agents call submit_plan by default.

npx overture-mcp fails with a package not found error

Run npx overture-mcp --yes to force npx to download the package. If the issue persists, install globally with npm install -g overture-mcp and use the global binary path in your MCP config instead of npx.

Frequently Asked Questions about Overture

What is Overture?

Overture is a Model Context Protocol (MCP) server that overture is an open-source, locally running web interface delivered as an mcp (model context protocol) server that visually maps out the execution plan of any ai coding agent as an interactive flowchart/graph before the agent begins writing code. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Overture?

Follow the installation instructions on the Overture GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Overture?

Overture works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Overture free to use?

Yes, Overture is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "overture": { "command": "npx", "args": ["-y", "overture"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Overture?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides