Respan MCP Server

Redirecting to documentation...

If you are not redirected automatically, click here.

Model Context Protocol server for accessing Respan data from your AI assistantFeatures

Logs - Query and filter LLM request logs with powerful filtering

Traces - View complete execution traces with span trees

Customers - Access customer data and budget information

Prompts - Manage prompt templates and versions

Quick Start

Mode 1: HTTP Streaming - Public Service

Use the hosted endpoint where each user provides their own API key:

{
  "mcpServers": {
    "respan": {
      "url": "https://mcp.respan.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_RESPAN_API_KEY"
      }
    }
  }
}

Mode 2: Local Stdio (Personal Use)

Run locally for development - simplest setup:

git clone https://github.com/respanai/respan-mcp.git
cd respan-mcp
npm install && npm run build

Configure your MCP client (~/.cursor/mcp.json):

{
  "mcpServers": {
    "respan": {
      "command": "node",
      "args": ["/path/to/respan-mcp/dist/lib/index.js"],
      "env": {
        "RESPAN_API_KEY": "your_api_key"
      }
    }
  }
}

Mode 3: HTTP Streaming - Private Deployment

Deploy to Vercel with API key stored as environment variable. No client-side key needed:

Clone: git clone https://github.com/respanai/respan-mcp
Deploy: vercel deploy --prod
Set RESPAN_API_KEY in Vercel Dashboard → Environment Variables

Configure your MCP client:

{
  "mcpServers": {
    "respan": {
      "url": "https://your-project.vercel.app/mcp"
    }
  }
}

Available ToolsEveryday tools are listed at connect; tool_search finds the rest by resource and action words and tool_run runs them.

Area

Tools

Listed at connect

log_list, log_get, log_summary, trace_list, trace_get, metric_summary, metric_timeseries, error_group_list, behavior_summary, prompt_list, tool_search, tool_run

Found with tool_search

traces, threads and usage rankings; behaviors and guardrails; errors and incidents; prompts and schemas; monitors and notification methods; datasets, experiments, graders and evaluators; automations and reports; caches, exports, webhooks, tags, saved views and dashboards; API keys, limits, credits, members and projects; provider keys (BYOK) and custom models; workspaces, billing and join requests

Filter ExamplesAll list tools support powerful filtering:{ "cost": {"operator": "gt", "value": [0.01]}, "model": {"operator": "", "value": ["gpt-4"]}, "customer_identifier": {"operator": "contains", "value": ["user"]}, "metadata__session_id": {"operator": "", "value": ["abc123"]} }Operators: "" (equal), not, lt, lte, gt, gte, contains, icontains, startswith, endswith, in, isnull GitHub Repository Documentation Get API Key