Skip to content
MCP server

Nexus MCP

Delegate tasks to Claude Code, Codex or Antigravity coding agents from any MCP client

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
2.1.3
Listing updated
today

Similar MCP servers

About Nexus MCP

Nexus MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Nexus lets one MCP client hand work to another coding agent. A single prompt tool runs one agent turn with a chosen backend, a project directory and a permission profile, and returns the final answer. Backends are optional extras: Claude Code through the Agent SDK, Codex through its App Server and Antigravity through its SDK.

The default profile is read-only, with workspace-write and full-access profiles available. Sessions can be continued or forked, a model can be chosen and a timeout defaults to 600 seconds. Longer jobs use agent tools to start, check, continue, fork, review, cancel and respond, and there is a batch prompt mode.

Authentication is each agent's own login or key. Installation is through uvx or pip with Python.

Install

Run in a terminal

claude mcp add nexus-mcp -- uvx nexus-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "nexus-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nexus-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "uvx",
      "args": [
        "nexus-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

prompt
Run one agent turn on a chosen backend
batch_prompt
Run several prompts
agent_start
Start a background agent
agent_status
Check agent status
agent_result
Get an agent's result
agent_continue
Continue an agent
agent_fork
Fork an agent session
agent_review
Review agent work
agent_cancel
Cancel an agent
agent_respond
Respond to an agent

What it does

Three backends
Claude Code, Codex and Antigravity.
Permission profiles
Read-only by default, with write and full access.
Session control
Continue, fork or cancel sessions.
Background agents
Start and monitor longer jobs.
Batch prompts
Send several prompts together.
Own credentials
Uses each agent's own login.

Good for

  • Ask Codex to review Claude's change
  • Fan out a task to several agents
  • Run a long agent job in the background

Pricing

Open source

Free; each backend needs its own account or key.

Nexus MCP FAQ

Which agents work?

Claude Code, Codex and Antigravity.

Is it read-only by default?

Yes, the default profile is read_only.

How long can a turn run?

600 seconds by default.

Is Nexus MCP free?

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

How do I add Nexus MCP to Claude Code?

Run this command in your terminal: claude mcp add nexus-mcp -- uvx nexus-mcp

What are the best alternatives to Nexus MCP?

The closest alternatives to Nexus MCP 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