@anycast/mcp

Connect AI assistants to the Anycast network. Manage agents, P2P connections, and webhook delivery directly from Claude, Cursor, or any MCP-compatible client.

Sign up free · Documentation · npm

MCP (Model Context Protocol) server for the Anycast Platform. Enables AI assistants like Claude, Cursor, and Copilot to manage agents, webhooks, and P2P connectivity.

Installation

npm install -g @anycast/mcp

Configuration

Set your Anycast API key:

export ANYCAST_API_KEY=your-api-key-here
export ANYCAST_API_URL=https://agents.anycast.com  # optional

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "anycast": {
      "command": "anycast-mcp",
      "env": {
        "ANYCAST_API_KEY": "your-api-key-here",
        "ANYCAST_API_URL": "https://agents.anycast.com"
      }
    }
  }
}

Usage with Claude Code

Add to your project's .claude/settings.json:

{
  "mcpServers": {
    "anycast": {
      "command": "npx",
      "args": ["@anycast/mcp"],
      "env": {
        "ANYCAST_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage with Cursor

Add to Cursor settings > MCP Servers:

{
  "anycast": {
    "command": "anycast-mcp",
    "env": {
      "ANYCAST_API_KEY": "your-api-key-here"
    }
  }
}

Available Tools

Agents

Tool	Description
list_agents	List all agents with status, IP, version
get_agent	Get agent details by ID
update_agent	Update agent name or labels
delete_agent	Delete agent (disconnects connections)
get_agent_connections	Get connection history for an agent

Tokens

Tool	Description
list_tokens	List registration tokens (prefixes only)
create_token	Create new registration token
revoke_token	Revoke a token

Groups

Tool	Description
list_groups	List agent groups
create_group	Create a new group
add_agent_to_group	Add agent to group
remove_agent_from_group	Remove agent from group

Connectivity

Tool	Description
get_discovery	Get rendezvous server URL
list_connections	List P2P connections
get_connection_stats	Bandwidth and connection counts

Webhooks (Ramps)

Tool	Description
list_destinations	List webhook destinations
create_destination	Create webhook destination
list_events	List webhook events

Resources

URI	Description
anycast://agents	All registered agents
anycast://connections	Recent connections (24h)
anycast://stats	Platform statistics

Examples

Ask Claude:

"List all my online agents"

"Create a registration token called 'production' with a limit of 50 uses"

"Show me the connection stats for the last week"

"Create a webhook destination at https://api.example.com/webhooks"

"Which agents are in the 'production' group?"

License

MIT