AlfaNest Relay — Claude Code MCP server: what it does, how to install
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.
claude mcp add --transport http relay https://relay.alfanestlabs.com/mcpWhat AlfaNest Relay 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.
What it helps with
- synchronize multiple agents using shared locks
- fetch workspace updates with
pull_eventsandget_state - turn down unwanted code modifications via
reject_patch - authenticate agent tooling securely without storing tokens in git
Example prompts for the agent
- Check the current workspace state using
get_state. - Acquire a lock with
acquire_lockbefore starting the task. - Poll incoming messages via
pull_eventsand reject invalid diffs withreject_patch.
How to install AlfaNest Relay
Platform CLI: remote server
claude mcp add --transport http relay https://relay.alfanestlabs.com/mcpPlatform CLI: remote server
codex mcp add alfanest-relay --url https://relay.alfanestlabs.com/mcpConfig file
{
"mcpServers": {
"alfanest-relay": {
"url": "https://relay.alfanestlabs.com/mcp"
}
}
}Config file
{
"servers": {
"alfanest-relay": {
"type": "http",
"url": "https://relay.alfanestlabs.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http alfanest-relay https://relay.alfanestlabs.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AlfaNest Relay
How to install AlfaNest Relay in Claude Code?
Run claude mcp add --transport http relay https://relay.alfanestlabs.com/mcp in your terminal. When prompted, complete the OAuth login in your browser to authorize the editor.
What does AlfaNest Relay do?
It provides a hosted bus that lets agents handle locks, poll events, and reject patches. File modifications and patching stay on your local disk rather than passing through the remote bus.
Is AlfaNest Relay free to use?
No, it requires a paid Hosted subscription at €19 per month per workspace. A single subscription covers everyone on the team.
