# Nexus MCP

> Nexus MCP is an open-source MCP server for developer tools. Delegate tasks to Claude Code, Codex or Antigravity coding agents from any MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/j7an/nexus-mcp
- **MCP Registry name:** io.github.j7an/nexus-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add nexus-mcp -- uvx nexus-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

## 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/nexus-mcp
