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:

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:

{
  "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:

{
  "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:

{
  "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.