> ## Documentation Index
> Fetch the complete documentation index at: https://zepeed.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect AI tools like Claude, Cursor, and GitHub Copilot to your Zepeed instance.

Zepeed exposes an **MCP (Model Context Protocol)** server that allows AI agents to query your monitoring data programmatically. This enables scenarios like asking your AI assistant to "check the latest speedtest results" or "find any failing ping targets."

### Server URL

The MCP server is available at:

```bash theme={null}
https://your-zepeed-instance.com/mcp/zepeed
```

### Authentication

The MCP server requires authentication using a **Sanctum API Token**.

1. Log in to the Zepeed web UI.
2. Navigate to **Settings > API Tokens**.
3. Create a new token (e.g., named "AI-Assistant").
4. Copy the generated token — you will need it for your AI client configuration.

### Client Configuration

#### Claude Desktop

Add the following to your `claude_desktop_config.json`:

```json theme={null}
{
  "mcpServers": {
    "zepeed": {
      "type": "url",
      "url": "https://your-zepeed-instance.com/mcp/zepeed",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
```

#### Cursor

Create or edit `.cursor/mcp.json` in your project root:

```json theme={null}
{
  "mcpServers": {
    "zepeed": {
      "type": "url",
      "url": "https://your-zepeed-instance.com/mcp/zepeed",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
```

#### VS Code / GitHub Copilot

Create `.vscode/mcp.json` in your workspace:

```json theme={null}
{
  "mcpServers": {
    "zepeed": {
      "type": "url",
      "url": "https://your-zepeed-instance.com/mcp/zepeed",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
```

### Available Tools

Once connected, your AI assistant will have access to several tools, including:

* `list_speedtest_results`: Query recent speedtest data.
* `list_ping_results`: Query recent ping latency data.
* `list_providers`: List configured speedtest providers.
* `list_maintenance_windows`: Check for active or upcoming maintenance.
* `get_app_version`: Check the current Zepeed version.