Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

84 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

xBridge MCP

Python 3.10+ Docker License: MIT MCP Registry

Grok inside Claude Code. Free. Open source. BYOK.

xBridge MCP is a lightweight, self-hosted MCP server that exposes the full power of xAI Grok (including grok-4.20 models) directly inside Claude Code and other MCP clients.

Why xBridge?

  • Full access to Grok-4.20 family (1M context, reasoning, multi-agent); default model grok-4.3
  • 19 tools: chat, web/X search, sessions, chains, image gen/edit, video gen, docs, model listing
  • Free and open source — self-host with your xAI API key (BYOK), no xBridge call limits
  • You control your own API key (BYOK)
  • No telemetry, no middleman

Self-host is free forever. A managed Pro tier (prebuilt Docker image + support) is also available — see xbridgemcp.com for pricing.

Installation

Docker (Recommended)

docker pull nexuswedge/xbridge-mcp:latest
docker run -e XAI_API_KEY=your_key nexuswedge/xbridge-mcp:latest

pip

pip install xbridge-mcp
XAI_API_KEY=your_key xbridge-mcp

Configuration (Claude Code)

Add to your Claude Code config:

{
  "mcpServers": {
    "xbridge": {
      "command": "xbridge-mcp",
      "env": {
        "XAI_API_KEY": "your_xai_key_here"
      }
    }
  }
}

Available Tools (19)

Group Tools
Chat grok-chat
Search grok-web-search, grok-x-search
Sessions grok-session-create, grok-session-chat, grok-session-get, grok-session-list, grok-session-delete
Chains grok-chain-search-summarize, grok-chain-research, grok-chain-debug
Images grok-image-generate, grok-image-edit, grok-image-models
Video grok-video-generate
Docs grok-docs-list, grok-docs-get, grok-docs-search
Models grok-models

Links


Not affiliated with or endorsed by xAI.

About

MCP server bridging Claude Code to xAI Grok API. 19 tools: chat, web/X search, sessions, chains, image/video gen, docs. BYOK. Free tier (50 calls/day) or Pro (€9/mo). Python 3.10+, Docker.

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages