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
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt |
string | yes | The question or task for Grok |
system_prompt |
string | no | Custom system prompt |
model |
string | no | Model to use (default: grok-4.20-reasoning) |
web_search |
boolean | no | Enable real-time web search |
x_search |
boolean | no | Enable X/Twitter search |
Available Models
grok-4.20-reasoning— flagship reasoning (default)grok-4.20-non-reasoning— fast, no reasoninggrok-4.20-multi-agent— multi-agent mode, great for architecture and planninggrok-4.1-fast-reasoning— cheaper reasoninggrok-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
