Redirecting to documentation...
If you are not redirected automatically, click here.
Model Context Protocol server for accessing Respan data from your AI assistant
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" } } } }
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):
~/.cursor/mcp.json
{ "mcpServers": { "respan": { "command": "node", "args": ["/path/to/respan-mcp/dist/lib/index.js"], "env": { "RESPAN_API_KEY": "your_api_key" } } } }
Deploy to Vercel with API key stored as environment variable. No client-side key needed:
git clone https://github.com/respanai/respan-mcp
vercel deploy --prod
RESPAN_API_KEY
Configure your MCP client:
{ "mcpServers": { "respan": { "url": "https://your-project.vercel.app/mcp" } } }
log_list
log_get
trace_list
trace_get
thread_list
thread_get
dashboard_llm_metrics_summary
dashboard_top_models
end_user_rank_by_usage
pulse_behaviors_summary
behavior_list
behavior_timeseries
behavior_grouped
behavior_spans_list
custom_behavior_*
pulse_error_groups_list
pulse_error_group_get
pulse_incidents_list
prompt_list
prompt_get
prompt_create
prompt_update
prompt_versions_list
prompt_version_get
prompt_draft_init
prompt_version_update
prompt_commit
prompt_deploy
workflow_list
workflow_filter
workflow_get
automation_create
monitor_create
export_workflow_create
workflow_create
workflow_update
workflow_delete
workflow_commit
workflow_deploy
All 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
""
not
lt
lte
gt
gte
contains
icontains
startswith
endswith
in
isnull