Grok MCP Server

Give Claude Code the power of Grok 4.20

An MCP server that connects Claude Code to xAI's Grok, unlocking real-time web search and X (Twitter) search capabilities.

Why Grok + Claude?

Philosophy: Claude is the commander, Grok is the specialist for real-time search and social media intelligence.

Quick Start

1. Get API Key

Visit xAI Console and create an API key.

2. Configure Claude Code

Add to your MCP config file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "grok-mcp": {
      "command": "npx",
      "args": ["-y", "@lkbaba/grok-mcp@latest"],
      "env": {
        "XAI_API_KEY": "your_xai_api_key_here"
      }
    }
  }
}

@latest ensures you always get the newest version when Claude Code restarts.

3. Restart Claude Code

Tools (2)

grok_agent_search - Smart Search

Real-time web and X (Twitter) search powered by Grok. Grok automatically analyzes queries, executes searches (potentially multiple rounds), synthesizes information, and provides cited answers.

Output includes: Search results with inline citations, search queries Grok used, titled source links, and usage statistics.

Example:

"Search for the latest Claude Code updates on X and the web"

grok_brainstorm - Creative Brainstorming

Multi-perspective idea generation with project context support.

Style temperature mapping: practical=0.5, balanced=0.7, innovative=0.95, radical=1.0

Example:

"Brainstorm 3 practical ideas for improving user onboarding, read ./README.md for context"

Model Selection

Performance

Tested on 2026-03-12:

Proxy Configuration

Add proxy environment variable to your config:

{
  "mcpServers": {
    "grok-mcp": {
      "command": "npx",
      "args": ["-y", "@lkbaba/grok-mcp@latest"],
      "env": {
        "XAI_API_KEY": "your_xai_api_key_here",
        "HTTPS_PROXY": "http://127.0.0.1:7897"
      }
    }
  }
}

Native fetch (undici) automatically reads proxy environment variables.

Local Development

git clone https://github.com/LKbaba/Grok-mcp.git
cd Grok-mcp
npm install
npm run build
export XAI_API_KEY="your_xai_api_key_here"
npm start

Project Structure

src/
├── config/
│   └── index.ts          # Configuration (zod validation)
├── types/
│   └── index.ts          # TypeScript type definitions
├── tools/
│   ├── definitions.ts    # MCP tool JSON Schema definitions
│   ├── agent-search.ts   # grok_agent_search implementation
│   └── brainstorm.ts     # grok_brainstorm implementation
├── utils/
│   ├── grok-client.ts    # xAI API client (native fetch)
│   ├── tool-builder.ts   # Search tool parameter builder
│   └── logger.ts         # Logging and performance monitoring
└── index.ts              # MCP server entry point

Comparison with Gemini MCP

Best strategy: Use both! Gemini for speed and code analysis, Grok for deep search and X/Twitter intelligence.

Security

• Path traversal protection: context_files are sandboxed to the working directory — paths like ../../etc/passwd are blocked
• Sensitive file blocking: .env, .pem, .key, credentials, and database files are automatically excluded
• Input validation: Domain filters, date ranges, handle filters, and file counts are validated with strict schemas
• Mutual exclusivity: allowed_domains/excluded_domains and allowed_x_handles/excluded_x_handles cannot be set simultaneously
• No hardcoded secrets: API keys are loaded from environment variables only

License

MIT