Skip to main content
Glama

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.

Related MCP server: grok-mcp

Installation

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

pip

The package is not published on PyPI. Install from the git tag:

pip install "git+https://github.com/hrco/xbridge-mcp.git@v3.0.0"
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


Not affiliated with or endorsed by xAI.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server that wraps the xAI Grok API, allowing Claude and other AI agents to delegate thinking, planning, and real-time search tasks to Grok. It provides a single tool with options for different use cases including web search, Twitter/X search, and multi-agent reasoning.
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for live X/Twitter and web search, driven by your locally logged-in Grok CLI and leveraging your X Premium or SuperGrok subscription quota.
      3
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for integrating xAI's Grok model into OpenAI Codex Desktop/GUI, enabling direct Grok calls via chat completions or responses with OAuth or API key authentication.
      9
      MIT