npm package: @iflow-mcp/tetsuo-ai-grok-api-mcp
Description: MCP server for xAI/Grok API documentation
Latest version: 1.0.0

# 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

```bash
npm install
npm run build
```

## Usage

### With Claude Desktop

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

```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:

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

### Standalone

```bash
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

```bash
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