Setup

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