<p align="center">
  <a href="https://anycast.com"><img src="https://img.shields.io/badge/anycast.com-platform-6366f1" alt="Anycast Platform"></a>
  <a href="https://www.npmjs.com/package/@anycast/mcp"><img src="https://img.shields.io/npm/v/@anycast/mcp" alt="npm version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
</p>

# @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](https://agents.anycast.com) · [Documentation](https://docs.anycast.com) · [npm](https://www.npmjs.com/package/@anycast/mcp)**

MCP (Model Context Protocol) server for the [Anycast Platform](https://anycast.net). Enables AI assistants like Claude, Cursor, and Copilot to manage agents, webhooks, and P2P connectivity.

## Installation

```bash
npm install -g @anycast/mcp
```

## Configuration

Set your Anycast API key:

```bash
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`:

```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`:

```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:

```json
{
  "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