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 CodeCursor (/.cursor/mcp.json)Codex CLI (/.codex/config.toml)
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 CodeCursor (/.cursor/mcp.json)Codex CLI (/.codex/config.toml)
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 |
deploy_prompt_version |
Deploy a committed (readonly) version as live |
Try: “Show me all my prompts” or “Deploy version 3 of my customer-support prompt”
Experiments
| Tool | Description |
|---|---|
list_experiments |
List all experiments |
get_experiment |
Get experiment details |
create_experiment |
Create and run an experiment (prompt, completion, duplicate, or condition workflow) |
delete_experiment |
Delete an experiment and its spans |
list_experiment_spans |
List spans for an experiment |
get_experiment_span |
Get a single experiment span |
get_experiment_score_averages |
Compute avg/min/max score per evaluator across an experiment’s spans |
Try: “List my recent experiments” or “Compare prompt v3 vs v4 on the customer-support dataset”
Evaluators
| Tool | Description |
|---|---|
list_evaluators |
List all evaluators (graders) |
get_evaluator |
Get evaluator details |
create_evaluator |
Create a new LLM or code evaluator |
update_evaluator |
Update an evaluator |
delete_evaluator |
Delete an evaluator |
test_evaluator |
Run an evaluator against sample inputs (dry-run) |
commit_evaluator |
Lock an evaluator version as readonly |
list_evaluator_versions |
List version history for an evaluator |
run_evaluator |
Score a single log with an evaluator |
Try: “Create an LLM grader that rates response quality 1-10” or “Run qa-score on log abc123”
Evaluation pipelines
Pipelines wrap one or more evaluators into a Blockly task graph (single grader, average, weighted average, or conditional gates). Pipelines are what create_experiment references via evaluator_workflow_ids.
| Tool | Description |
|---|---|
list_evaluation_pipelines |
List all evaluator pipelines |
get_evaluation_pipeline |
Get a pipeline’s task graph |
create_evaluation_pipeline |
Build a pipeline (single / average / weighted / condition patterns) |
update_evaluation_pipeline |
Rebuild a pipeline’s task graph |
Try: “Create a pipeline that runs my quality grader, then routes scores >7 to a deeper LLM judge”
Workflows
| Tool | Description |
|---|---|
list_workflows / filter_workflows |
List or filter workflows |
get_workflow / get_workflow_version |
Get workflow or specific version |
list_workflow_versions |
List version history |
create_workflow / update_workflow |
Create / update a workflow |
commit_workflow |
Commit the current draft as a readonly version |
deploy_workflow / undeploy_workflow |
Deploy / undeploy a committed version |
validate_workflow |
Validate workflow structure |
Datasets
| Tool | Description |
|---|---|
list_datasets |
List all datasets |
get_dataset |
Get dataset details |
create_dataset |
Create a new dataset (empty, sampling, or copy from existing) |
update_dataset |
Update dataset metadata |
delete_dataset |
Delete a dataset |
list_dataset_logs |
List rows in a dataset |
retrieve_dataset_log |
Get a single dataset row |
replace_dataset_log |
Replace a row’s input / output / expected_output |
bulk_create_dataset_logs |
Insert one or more rows (use this for inserts) |
remove_dataset_logs |
Remove rows by filter |
summarize_dataset_logs |
Aggregate metrics (cost, latency, scores) across rows |
list_dataset_eval_runs |
List eval runs against a dataset |
import_dataset_logs |
Import logs from production into a dataset |
Try: “Show me my datasets” or “Insert 5 test rows into 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 CodeCursor (/.cursor/mcp.json)Codex CLI (/.codex/config.toml)
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”