Get startedMCP

Platform MCP

Access your Respan logs, traces, prompts, and customer data from your AI coding tools.

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

Setup

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 respan \
>  --transport http \
>  --header "Authorization: Bearer YOUR_RESPAN_API_KEY" \
>  https://mcp.respan.ai/mcp

Restart your tool to load the MCP server.

Enterprise

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

EndpointMCP URLAPI URL
Cloudhttps://mcp.respan.ai/mcphttps://api.respan.ai/api
Enterprisehttps://mcp.respan.ai/mcp/enterprisehttps://endpoint.respan.ai/api

Available tools

Once connected, your AI tools can access:

Logs

ToolDescription
list_logsList and filter LLM request logs
get_log_detailGet complete details of a single log

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

Traces

ToolDescription
list_tracesList and filter traces
get_trace_treeGet the full span tree of a trace

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

Customers

ToolDescription
list_customersList customers with sorting and pagination
get_customer_detailGet customer details including budget usage

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

Prompts

ToolDescription
list_promptsList all prompts
get_prompt_detailGet prompt details
list_prompt_versionsList all versions of a prompt
get_prompt_version_detailGet a specific version

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

Troubleshooting

IssueFix
MCP server not showingCheck config file path, validate JSON, restart tool completely
OAuth failsTry API Key method instead. For Cursor, always use API Key.
JWT token expiredSign in again at mcp.respan.ai/login
Connection timeoutCheck internet. For enterprise, verify RESPAN_API_BASE_URL.

Source code

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