# Ambit

> Ambit is an open-source MCP server for developer tools. Local map of the MCP servers your coding agents have, what works and what to add next. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, Web
- **Website:** https://zz-plant.github.io/ambit/
- **Repository:** https://github.com/zz-plant/ambit
- **MCP Registry name:** io.github.zz-plant/ambit
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

Instead of exposing an external service, this server reads the MCP configuration files of agents such as Claude Code, Cursor and Codex CLI (16 agents in total, per the README) and builds one picture of what they can do together. It separates three facts that are easy to blur: a server is configured, it passes its check, and it is permitted to run without asking.

From that graph it ranks capabilities that are one setup step away, points out combinations of tools that unlock something neither does alone, and shows what would stop if a model, server or credential disappeared. A weigh command starts each local tool server declared in your user-level configs and measures how much context its tool list uses every session.

You can use it from the terminal with npx ambit-cli (Node 22.18 or newer) or a Homebrew tap, open a local web map, or let an agent query it over MCP. Agents may propose a configuration change, but applying one needs an approval made outside MCP. The graph lives in a local SQLite file and the README states there is no telemetry. A browser demo accepts a pasted config without uploading it.

## Features

- **Config discovery:** Reads the MCP configs of 16 agents into one local map.
- **Next-step ranking:** Lists capabilities whose prerequisites you already meet, ranked by what each would open.
- **Verify checks:** A failing capability check removes it from plans and permissions until it passes.
- **Context weigh-in:** Measures how much context each local tool server's tool list takes.
- **Dependency view:** Shows shared credentials as a single point of failure.
- **Approval-gated changes:** Agents can draft a config change; applying it needs approval outside MCP.

## Good for

- Audit which MCP servers each agent on a machine actually has and which fail
- Find out what stops working when a credential expires
- Decide which MCP server to set up next
- Trim tool lists that eat context in every session

## Install

### Claude Code (Terminal)

```sh
claude mcp add ambit -- npx -y ambit-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ambit": {
      "command": "npx",
      "args": [
        "-y",
        "ambit-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ambit": {
      "command": "npx",
      "args": [
        "-y",
        "ambit-cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "ambit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ambit-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ambit": {
      "command": "npx",
      "args": [
        "-y",
        "ambit-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ambit": {
      "command": "npx",
      "args": [
        "-y",
        "ambit-cli"
      ]
    }
  }
}
```

## FAQ

### What do I need to run it?

Node 22.18 or newer, then npx ambit-cli, or the Homebrew tap named in the README.

### Does it send my configs anywhere?

The README says the graph is a local SQLite file with no telemetry, and the browser demo places a pasted config on the map without uploading it.

### Can an agent change my setup through it?

An agent can propose a change, but applying it requires an approval made outside MCP.

### What licence is it under?

MIT.

### Is Ambit free?

Yes. Ambit is open source, so you can use and self-host it for free.

### How do I add Ambit to Claude Code?

Run this command in your terminal: claude mcp add ambit -- npx -y ambit-cli

### What are the best alternatives to Ambit?

The closest alternatives to Ambit are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ambit
