@anycast/mcp

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://api.anycast.net  # optional, defaults to localhost:3002

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://api.anycast.net"
      }
    }
  }
}

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