grok-api-mcp

MCP server that provides xAI/Grok API documentation to AI assistants. Includes 75 bundled documentation files covering all xAI API features, models, and endpoints.

Features

• Bundled documentation - 75 markdown files with complete xAI API coverage
• Live fetch - Pull fresh docs from docs.x.ai when needed
• Semantic search - Find relevant documentation by keyword
• API reference - 44 endpoints across 12 categories
• Model reference - 12 Grok models with specs and pricing

Installation

npm install
npm run build

Usage

With Claude Desktop

Add to your Claude Desktop configuration (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "grok-api-docs": {
      "command": "node",
      "args": ["/path/to/grok-api-mcp/dist/index.js"]
    }
  }
}

With Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "grok-api-docs": {
      "command": "node",
      "args": ["/path/to/grok-api-mcp/dist/index.js"]
    }
  }
}

Standalone

npm start

Available Tools

| Tool | Description | |------|-------------| | search_docs | Search bundled documentation for API features, models, and guides | | get_doc_page | Fetch fresh documentation from docs.x.ai | | list_api_endpoints | List all 44 API endpoints, optionally filtered by category | | list_models | List all 13 Grok models with context lengths and capabilities |

search_docs

Search the bundled documentation using keywords.

query: "function calling"

get_doc_page

Fetch a specific documentation page from docs.x.ai.

path: "guides/function-calling"

list_api_endpoints

List API endpoints. Filter by category: chat, images, videos, voice, models, files, batch, collections, api-keys, billing, team, audit.

category: "collections"  # optional

list_models

List all available Grok models with their specifications.

API Coverage

Endpoints (44 total)

| Category | Count | API | |----------|-------|-----| | Chat | 4 | Inference | | Images | 2 | Inference | | Videos | 2 | Inference | | Voice | 1 | Inference | | Models | 3 | Inference | | Files | 5 | Inference | | Batch | 7 | Inference | | Collections | 9 | Management | | API Keys | 4 | Management | | Billing | 3 | Management | | Team | 3 | Management | | Audit | 1 | Management |

Models (12 total)

Language models:

• grok-4-1-fast-reasoning, grok-4-1-fast-non-reasoning
• grok-4-fast-reasoning, grok-4-fast-non-reasoning
• grok-code-fast-1, grok-4-0709
• grok-3, grok-3-mini, grok-2-vision-1212

Image generation:

• grok-imagine-image, grok-2-image-1212

Video generation:

• grok-imagine-video

Documentation Topics

• Chat completions and Responses API
• Function calling and tool use
• Built-in tools (web search, X search, code execution)
• Collections (RAG/embeddings)
• Voice API (real-time WebSocket)
• Batch API
• Image and video generation
• Streaming and structured outputs
• Error handling and rate limits
• SDK guides (Python, TypeScript)

Development

npm run build    # Compile TypeScript + copy data files
npm run start    # Run the server
npm run dev      # Watch mode for development

Adding Documentation

1. Add .md file to src/data/
2. Run npm run build
3. The file is automatically discoverable by search_docs

License

MIT