# NexusRelay

> NexusRelay is an open-source MCP server for developer tools. Lets Claude, Codex and Antigravity message each other on one Windows PC. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, CLI
- **Repository:** https://github.com/pironjulien/nexusrelay
- **MCP Registry name:** io.github.pironjulien/nexus-relay
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Each agent keeps working in its own desktop app. A send call writes a message as a JSON file in a local room under `~/.nexus/relay`, and a background daemon on 127.0.0.1 nudges the recipient with a short note that cites only the message id. The recipient reads the message, replies, and the sender picks up the answer with a wait call.

The README is explicit about the limits. It is Windows only, and waking Codex and Antigravity relies on a local debugging port and a sidecar API, so an app update can break a wake until the relay's interface maps are refreshed. A peer's message is framed as an opinion to examine rather than an instruction from you, and the relay says it never takes your mouse, keyboard or clipboard.

The MCP bundle in the registry runs the same engine over stdio for a single agent; the installer remains the full setup with daemon, plugin, token and updates.

## Features

- **Cross-agent messaging:** Send a request to another agent, wait for its reply and read it, without copy-pasting between apps.
- **Twenty shared MCP tools:** The README lists one tool set covering send, wait, read, reply, track, search and file reservation.
- **Local-only transport:** The daemon listens on 127.0.0.1 behind a bearer token and messages are plain JSON files on your PC.
- **Self-test commands:** selftest checks the path to Codex and Antigravity in both directions.
- **Verified installer:** Releases ship SHA256 sums and Sigstore build provenance so the installer can be checked.
- **Self-contained build:** A single .NET 10 program for x64 or ARM64 that needs no administrator rights.

## Good for

- Ask Codex for a second opinion on a file while working in Claude Code
- Hand a review task to another agent and collect the answer in the same thread
- Track several agent exchanges by topic on one machine
- Reserve files so two agents do not edit the same thing

## Install

### Claude Code (Terminal)

```sh
claude mcp add nexus-relay -- npx -y https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "nexus-relay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nexus-relay": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb"
      ]
    }
  }
}
```

## Tools

- `send`: Send a message to another agent
- `wait_reply`: Wait for the reply to a sent message
- `read`: Read a message by id
- `reply`: Reply to a message by id
- `selftest`: Check the path to Codex or Antigravity
- `status`: Report the effective relay settings

## FAQ

### Which operating systems does it support?

Windows 10 and 11 only, on x64 or ARM64.

### Which agents can take part?

Claude Code, the Codex desktop app and Antigravity; the quick start asks for at least two of them.

### Does it send messages over the internet?

The README says everything listens on 127.0.0.1 behind a bearer token and messages are stored as local JSON files.

### Can an app update break it?

Yes. The README warns that waking Codex and Antigravity depends on how those apps behave today and may need the interface maps refreshed.

### Is NexusRelay free?

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

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

Run this command in your terminal: claude mcp add nexus-relay -- npx -y https://github.com/pironjulien/NexusRelay/releases/download/v1.15.2/nexus-relay-win-x64.mcpb

### What are the best alternatives to NexusRelay?

The closest alternatives to NexusRelay 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/nexusrelay
