MCP | Respan Docs

Platform MCP

The Platform MCP server gives your AI tools direct access to your Respan observability data — logs, traces, prompts, customers, and more.

Setup

API Key (Recommended)

OAuth

Use your Respan API key. Works with any MCP client.

Get your API key from platform.respan.ai, then add the config to your tool:

$ claude mcp add \
>   --transport http \
>   --header "Authorization: Bearer YOUR_RESPAN_API_KEY" \
>   respan \
>   https://mcp.respan.ai/mcp

Restart your tool to load the MCP server.

Optional: whitelist specific tools

If you only want your MCP client to see a subset of tools, add the Respan-Enabled-Tools header with a comma-separated list of exact tool names.

If you omit this header, all Platform MCP tools are available.

$ claude mcp add \
>   --transport http \
>   --header "Authorization: Bearer YOUR_RESPAN_API_KEY" \
>   --header "Respan-Enabled-Tools: list_logs,get_log_detail,list_traces,get_trace_tree" \
>   respan \
>   https://mcp.respan.ai/mcp

Use exact MCP tool names. For example, setting Respan-Enabled-Tools: list_logs,list_traces exposes only those two tools to the client.

Enterprise

Enterprise users have a dedicated endpoint. Replace https://mcp.respan.ai/mcp with https://mcp.respan.ai/mcp/enterprise in any config above.

Endpoint	MCP URL	API URL
Cloud	`https://mcp.respan.ai/mcp`	`https://api.respan.ai/api`
Enterprise	`https://mcp.respan.ai/mcp/enterprise`	Your enterprise base URL

Available tools

Once connected, your AI tools can access these Platform MCP tools:

Logs

Tool	Description
`list_logs`	List and filter LLM request logs
`get_log_detail`	Get complete details of a single log
`create_log`	Create a new log entry
`get_spans_summary`	Get aggregated metrics for log spans

Try: “Show me the most expensive requests from the last hour” or “Find all failed requests for customer user_123”

Traces

Tool	Description
`list_traces`	List and filter traces
`get_trace_tree`	Get the full span tree of a trace
`get_traces_summary`	Get aggregated metrics for traces

Try: “Show me traces with errors in production” or “Get the span tree for trace xyz123”

Customers

Tool	Description
`list_customers`	List customers with sorting and pagination
`get_customer_detail`	Get customer details including budget usage

Try: “Who are my top 10 customers by cost?” or “Show budget usage for user_abc”

Prompts

Tool	Description
`list_prompts`	List all prompts
`get_prompt_detail`	Get prompt details
`list_prompt_versions`	List all versions of a prompt
`get_prompt_version_detail`	Get a specific version
`create_prompt`	Create a prompt shell
`update_prompt`	Update prompt metadata
`create_prompt_version`	Create a new prompt version
`update_prompt_version`	Update an existing prompt version

Try: “Show me all my prompts” or “Get the latest version of my customer-support prompt”

Experiments

Tool	Description
`list_experiments`	List all experiments
`get_experiment`	Get experiment details
`create_experiment`	Create a new experiment
`list_experiment_spans`	List spans for an experiment
`get_experiment_span`	Get a single experiment span
`update_experiment_span`	Update an experiment span
`get_experiment_spans_summary`	Get aggregated experiment span metrics

Try: “List my recent experiments” or “Show me the spans for experiment exp_123”

Evaluators

Tool	Description
`list_evaluators`	List all evaluators
`get_evaluator`	Get evaluator details
`create_evaluator`	Create a new evaluator
`update_evaluator`	Update an evaluator
`run_evaluator`	Run an evaluator on a dataset or logs

Try: “Show me all evaluators” or “Run evaluator qa-score on dataset ds_123”

Datasets

Tool	Description
`list_datasets`	List all datasets
`get_dataset`	Get dataset details
`create_dataset`	Create a new dataset
`update_dataset`	Update a dataset
`list_dataset_spans`	List spans in a dataset
`create_dataset_span`	Create a dataset span
`retrieve_dataset_span`	Retrieve a dataset span
`update_dataset_span`	Update a dataset span
`add_spans_to_dataset`	Add existing spans to a dataset

Try: “Show me my datasets” or “Add these log IDs to dataset ds_123”

Troubleshooting

Issue	Fix
MCP server not showing	Check config file path, validate JSON, restart tool completely
OAuth fails	Try API Key method instead. For Cursor, always use API Key.
JWT token expired	Sign in again at mcp.respan.ai/login
Connection timeout	Check internet. For enterprise, verify `RESPAN_API_BASE_URL`.

Source code

The Respan MCP server is open source: github.com/respanai/respan-mcp

Docs MCP

Give your AI coding tools access to Respan documentation. No API key needed.

$ claude mcp add --transport http respan-docs https://mcp.respan.ai/mcp/docs

Restart your tool to load the server.

Tool	Description
`search_docs`	Search across all Respan documentation

Try: “How do I set up Respan tracing with LangGraph?” or “Show me the OpenAI SDK integration docs”