Skip to main content

MCP Server Setup

The Foxhound MCP server exposes your traces and observability data to Claude Code, Cursor, Windsurf, and any other MCP-connected IDE, letting your AI assistant query traces, surface anomalies, explain failures, and score runs — all without leaving your editor.

Claude Code​

claude mcp add foxhound \
  -e FOXHOUND_API_KEY=fox_your_key \
  -e FOXHOUND_ENDPOINT=https://api.foxhound.dev \
  -- npx @foxhound-ai/mcp-server

Once added, the server starts automatically when Claude Code launches. Verify it's running:

claude mcp list

Cursor / Windsurf​

Add to your MCP config (.cursor/mcp.json for Cursor, or the equivalent for Windsurf):

{
  "mcpServers": {
    "foxhound": {
      "command": "npx",
      "args": ["@foxhound-ai/mcp-server"],
      "env": {
        "FOXHOUND_API_KEY": "fox_your_key",
        "FOXHOUND_ENDPOINT": "https://api.foxhound.dev"
      }
    }
  }
}

Restart your IDE after saving the config.

Other MCP clients​

Run the server directly via npx — any MCP client that supports the stdio transport can connect:

FOXHOUND_API_KEY=fox_... FOXHOUND_ENDPOINT=https://api.foxhound.dev npx @foxhound-ai/mcp-server

Environment Variables​

VariableRequiredDefaultDescription
FOXHOUND_API_KEYYes—Your Foxhound API key
FOXHOUND_ENDPOINTNohttp://localhost:3001Foxhound API base URL

Example prompts​

Once connected, try these prompts in your AI assistant:

Show me all error traces from billing-bot in the last hour
Compare runs abc-123 and def-456 — why did the second one fail?
Any anomalies for the onboarding agent in the last 24 hours?
Explain the failure in trace xyz-789

Next Steps​