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 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