# AlfaNest Relay — MCP plugin

Hosted bus for AI agents: lock, events, reject. The working tree stays on disk.

- MCP: `https://relay.alfanestlabs.com/mcp`
- Site: `https://relay.alfanestlabs.com`
- Official registry: `com.alfanestlabs/relay`

[Install in VS Code](https://vscode.dev/redirect/mcp/install?name=alfanest-relay&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Frelay.alfanestlabs.com%2Fmcp%22%7D)

## What this plugin does

Installs a **remote** Streamable HTTP MCP server. Cursor (and other clients that load this package) connect to the hosted bus and run OAuth. No token in the repo.

## Requirements

- An AlfaNest Relay account
- An **active Hosted** subscription on that workspace (€19/month). One subscription covers the team.

## After install

1. Connect / Allow when the editor opens Relay sign-in.
2. Tools: `get_state`, `acquire_lock`, `release_lock`, `heartbeat`, `pull_events`, `reject_patch`.
3. Publish and apply stay on the local sidecar — not this plugin.

## Manual add (without marketplace)

```json
{
  "mcpServers": {
    "alfanest-relay": {
      "url": "https://relay.alfanestlabs.com/mcp"
    }
  }
}
```

## License

MIT