Skip to main content

Installation

Foxhound provides SDKs for Python and TypeScript, plus an MCP server for IDE integration.

Python SDK​

pip install foxhound-ai                   # core only
pip install foxhound-ai[langgraph]        # + LangGraph / LangChain support
pip install foxhound-ai[crewai]           # + CrewAI support
pip install foxhound-ai[opentelemetry]    # + OTel bridge (Pydantic AI, Bedrock, Google ADK)

TypeScript / Node.js SDK​

npm install @foxhound-ai/sdk
# or
pnpm add @foxhound-ai/sdk

For the OpenTelemetry bridge you also need the OTel packages:

npm install @foxhound-ai/sdk @opentelemetry/api @opentelemetry/sdk-node

MCP Server (IDE integration)​

The Foxhound MCP server lets Claude Code, Cursor, Windsurf, and any other MCP-connected IDE query your traces directly from your AI assistant.

Claude Code​

# Install directly from npm
claude mcp add foxhound -e FOXHOUND_API_KEY=fox_your_key -e FOXHOUND_ENDPOINT=https://api.foxhound.dev -- npx @foxhound-ai/mcp-server

Cursor / Windsurf​

Add to your MCP config (.cursor/mcp.json or equivalent):

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

Environment Variables​

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

Next Steps​