Setup

Get xBridge MCP running in 2 minutes. Three options: pip, Docker, or source.

Prerequisites

• xAI API Key — Get one free at x.ai/api (xAI gives you free credits to start)
• xBridge Key (optional) — Get a free key at xbridgemcp.com/#pricing for rate-limited access, or go Pro for unlimited
• Python 3.10+ (for pip install) or Docker (for container)

Option 1: pip install

pip install xbridge-mcp

Run it:

export XAI_API_KEY=your_xai_key
export XBRIDGE_KEY=your_xbridge_key  # optional
xbridge-mcp

Option 2: Docker

docker pull hrco/xbridge-mcp:latest
docker run -e XAI_API_KEY=your_xai_key -e XBRIDGE_KEY=your_xbridge_key hrco/xbridge-mcp:latest

Or with docker-compose, create a .env file:

XAI_API_KEY=your_xai_key
XBRIDGE_KEY=your_xbridge_key

Then:

docker compose up -d

Option 3: From Source

git clone git@github.com:hrco/xbridge-mcp.git
cd xbridge-mcp
pip install -e ".[dev]"
XAI_API_KEY=your_key xbridge-mcp

Connect to Claude Code

Add this to your Claude Code MCP config (~/.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "xbridge": {
      "command": "xbridge-mcp",
      "env": {
        "XAI_API_KEY": "your_xai_key",
        "XBRIDGE_KEY": "your_xbridge_key"
      }
    }
  }
}

Restart Claude Code. All 19 tools are now available.

Pro tip: Claude can do this for you. Just paste the JSON above into your chat and say "add this MCP server" — Claude will find the right config
file and set it up.

Environment Variables

┌─────────────┬──────────┬───────────────────────────────────────┐
│  Variable   │ Required │              Description              │
├─────────────┼──────────┼───────────────────────────────────────┤
│ XAI_API_KEY │ Yes      │ Your xAI API key from x.ai/api        │
├─────────────┼──────────┼───────────────────────────────────────┤
│ XBRIDGE_KEY │ No       │ Your xBridge access key (free or Pro) │
└─────────────┴──────────┴───────────────────────────────────────┘

Verify It Works

Once connected to Claude Code, try:

- "Ask Grok what's trending on X right now" — tests grok-x-search
- "Use Grok to search the web for MCP servers" — tests grok-web-search
- "Chat with Grok about Python best practices" — tests grok-chat

If you see responses, you're good.

Troubleshooting

┌─────────────────────────────┬─────────────────────────────────────────────────┐
│           Problem           │                       Fix                       │
├─────────────────────────────┼─────────────────────────────────────────────────┤
│ XAI_API_KEY not set         │ Export the variable or add it to your .env file │
├─────────────────────────────┼─────────────────────────────────────────────────┤
│ Tools not showing in Claude │ Restart Claude Code after adding MCP config     │
├─────────────────────────────┼─────────────────────────────────────────────────┤
│ Connection refused          │ Make sure xbridge-mcp process is running        │
├─────────────────────────────┼─────────────────────────────────────────────────┤
│ 401 Unauthorized            │ Check your xAI API key is valid at x.ai/api     │
└─────────────────────────────┴─────────────────────────────────────────────────┘

Next Steps

- Tools Reference — all 19 tools with parameters and examples
- $XBRDG Loyalty — hold $XBRDG for perks
- Product Site — pricing and demos