grok-mcp

MCP server that wraps the xAI Grok API. Lets Claude and other AI agents delegate thinking, planning, and real-time search to Grok.

Setup

npm install -g grok-mcp

Or use directly with npx:

npx grok-mcp

You need an xAI API key from console.x.ai.

Configure in Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "grok": {
      "type": "stdio",
      "command": "npx",
      "args": ["grok-mcp"],
      "env": {
        "XAI_API_KEY": "your-xai-api-key"
      }
    }
  }
}

Tool: ask_grok

Single tool with options for different use cases.

Parameters

Available Models

• grok-4.20-reasoning — flagship reasoning (default)

• grok-4.20-non-reasoning — fast, no reasoning

• grok-4.20-multi-agent — multi-agent mode, great for architecture and planning

• grok-4.1-fast-reasoning — cheaper reasoning

• grok-4.1-fast-non-reasoning — cheapest, fast

Examples

Ask a question:

prompt: "What are the trade-offs between microservices and monoliths?"

Deep architecture planning (multi-agent):

prompt: "Design a system architecture for a real-time collaborative editor"
model: "grok-4.20-multi-agent"

Search the web:

prompt: "What happened in tech news today?"
web_search: true

Search X/Twitter:

prompt: "What are people saying about the new React release?"
x_search: true

License

MIT