Skip to main content
The Traversal MCP server lets any compatible AI client run investigations, ask follow-ups, and retrieve results using the Model Context Protocol. It uses the streamable-http transport with API key authentication. Endpoint: https://api.traversal.com/mcp/ For BYOC deployments, use your organization’s API URL + /mcp/.

​
Authentication

Generate an API key in the Traversal web app under Settings > Personalization. The key is shown once — copy it immediately. Pass it in the Authorization header: 
Authorization: Bearer trv_ak_...

​
Setup

The config is the same across clients — an endpoint URL and an Authorization header. Find your client below.
Open Settings > Developer > Edit Config and add:
{
  "mcpServers": {
    "Traversal": {
      "type": "http",
      "url": "https://api.traversal.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Restart Claude Desktop after saving.
claude mcp add traversal \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -- https://api.traversal.com/mcp/
Add to .cursor/mcp.json in your project root or global settings:
{
  "mcpServers": {
    "Traversal": {
      "url": "https://api.traversal.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Add to your opencode.json config:
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "traversal": {
      "type": "remote",
      "url": "https://api.traversal.com/mcp/",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:TRAVERSAL_API_KEY}"
      }
    }
  }
}
Set the TRAVERSAL_API_KEY environment variable with your API key before launching OpenCode.
Any client supporting the streamable-http transport can connect (ChatGPT, Windsurf, VS Code, etc.). Configure it with the endpoint URL and an Authorization: Bearer header containing your API key.

​
Available tools

ToolDescription
investigateRun a first-pass investigation (typically 30s–2min).
follow_upContinue an investigation — drill into findings or check additional data sources.
get_investigationGet the status and report for an investigation, with a link to the web app.
list_investigationsList recent investigations for your organization.
product_feedbackSend feedback about the MCP experience.
A single investigate call is a fast first pass. Follow up at least once to drill into findings and verify hypotheses.

​
FAQ

Verify your API key is correct and hasn’t been revoked. If you recently regenerated it, update your client configuration.
Broad investigations can take up to 2 minutes. Try a surgical investigation first and use follow_up to expand scope.
Call get_investigation — the response includes a ui_url link to the full investigation in the Traversal web app.