# AlfaNest Relay

Remote MCP server that connects coding agents to a shared event and locking bus. Useful for orchestrating multiple agents while local code files stay on disk.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: alfanestlabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alfanestlabs/alfanest-relay
- Updated: 2026-08-30
- HTML: https://affpapa.org/en/nevibecode/mcp/alfanest-relay

## What it does

The service runs as a remote Streamable HTTP server via `https://relay.alfanestlabs.com/mcp`. When connected, your IDE handles OAuth verification in the browser, keeping tokens entirely outside the repository tree.

It supplies six tools for managing agent state: `get_state`, `acquire_lock`, `release_lock`, `heartbeat`, `pull_events`, and `reject_patch`. These endpoints handle agent coordination and patch rejection. Code publishing and file patching are left to the local sidecar rather than this package.

Access requires an active Hosted tier subscription on an AlfaNest Relay workspace, priced at €19 per month. One subscription covers the whole team. Without this paid plan, the endpoint will not authenticate.

## Requirements
- Remote server: `https://relay.alfanestlabs.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http relay https://relay.alfanestlabs.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add alfanest-relay --url https://relay.alfanestlabs.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alfanest-relay": {
            "url": "https://relay.alfanestlabs.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alfanest-relay": {
            "type": "http",
            "url": "https://relay.alfanestlabs.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http alfanest-relay https://relay.alfanestlabs.com/mcp
```

## When to use it
- synchronize multiple agents using shared locks
- fetch workspace updates with `pull_events` and `get_state`
- turn down unwanted code modifications via `reject_patch`
- authenticate agent tooling securely without storing tokens in git

## Example prompts
- Check the current workspace state using `get_state`.
- Acquire a lock with `acquire_lock` before starting the task.
- Poll incoming messages via `pull_events` and reject invalid diffs with `reject_patch`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md