The Tusk Drift MCP server enables AI assistants to search, analyze, and debug API traffic data captured by Tusk Drift, including HTTP requests, database queries, and distributed traces.

Core Capabilities:

• Search and Filter API Traffic (query_spans) - Find specific API calls using flexible criteria like endpoint names, HTTP methods, status codes, duration, errors, and custom JSON path filters with pagination support

• Get Schema Information (get_schema) - Understand available fields and structure for different instrumentation types (HTTP, database, gRPC, etc.) with example payloads

• Discover Available Data (list_distinct_values) - List unique and frequently occurring values for fields like endpoints, instrumentation packages, environments, status codes, and JSONB values to assist in query building

• Calculate Aggregated Metrics (aggregate_spans) - Compute statistics including latency percentiles (p50, p95, p99), error rates, request counts, performance comparisons across endpoints or environments, and time-series trends (hourly, daily, weekly)

• View Distributed Traces (get_trace) - Retrieve complete end-to-end traces as hierarchical trees showing the full call chain, timings, and dependencies to identify bottlenecks

• Fetch Specific Spans (get_spans_by_ids) - Get detailed information and full request/response payloads for individual span recordings by ID

Common Use Cases: Debug failed or slow API requests, analyze endpoint performance patterns, track errors across distributed systems, understand API traffic and usage patterns, monitor database query performance, and investigate specific requests end-to-end.

Setup: Connect via remote server (recommended) or local installation with API key authentication. Supports multiple AI assistants including Cursor and Claude Desktop with easy configuration.

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Tusk Drift MCP show me the slowest API endpoints from the last hour"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.