Tusk Drift MCP

An MCP server for querying API traffic data captured by Tusk Drift. This enables AI assistants to search, analyze, and debug your application's API traffic, including HTTP requests, database queries, and distributed traces.

New to Tusk Drift? Check out our docs and sign up for an account.

Setup

Option 1: Remote MCP Server (Recommended)

Connect directly to the hosted Tusk Drift MCP server. This is the easiest setup and doesn't require running anything locally.

For Cursor:

Add to your Cursor MCP settings (~/.cursor/mcp.json or workspace .cursor/mcp.json):

{
  "mcpServers": {
    "tusk-drift": {
      "url": "https://api.usetusk.ai/api/drift-mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TUSK_API_KEY"
      }
    }
  }
}

For Claude Desktop:

{
  "mcpServers": {
    "tusk-drift": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.usetusk.ai/api/drift-mcp"],
      "env": {
        "MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_TUSK_API_KEY\"}"
      }
    }
  }
}

Option 2: Local Installation (via NPX)

Run the MCP server locally. This is useful if you need offline access or custom configuration.

npm install -g @use-tusk/drift-mcp

For Claude Desktop / Cursor:

Add to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "tusk-drift": {
      "command": "npx",
      "args": ["-y", "@use-tusk/drift-mcp"],
      "env": {
        "TUSK_API_KEY": "your-api-token"
      }
    }
  }
}

Configuration (env vars for local installation)

| Variable | Required | Description | |----------|----------|-------------| | TUSK_API_KEY | Yes | Your API token | | TUSK_DRIFT_API_URL | No | Tusk API URL (defaults to https://api.usetusk.ai) | | TUSK_DRIFT_SERVICE_ID | No | Service ID (auto-discovered from .tusk/config.yaml if not set) |

Available Tools

| Tool | Description | |------|-------------| | query_spans | Search API traffic with flexible filters | | get_schema | Get structure/schema of captured traffic | | list_distinct_values | Discover available endpoints and field values | | aggregate_spans | Calculate latency percentiles, error rates, counts | | get_trace | View distributed traces as hierarchical trees | | get_spans_by_ids | Fetch specific spans with full payloads |

Support

Need help? Open an issue or contact us at [email protected].

License

MIT