---
name: xai-docs
description: Query x.ai (Grok) documentation directly from any agent session. Use when working with x.ai APIs, Grok models, rate limits, function calling, or any x.ai-specific feature. Wraps the x.ai JSON-RPC docs endpoint via the xai-docs CLI tool.
---

# x.ai Docs Tool

Query x.ai documentation without leaving your session. Available as the `xai-docs` CLI tool (on PATH).

## Commands

```bash
# Search docs for a keyword or phrase
xai-docs search "rate limits"
xai-docs search "function calling" 10   # return up to 10 results (default: 5)

# Get a specific doc page by slug
xai-docs page "developers/quickstart"
xai-docs page "developers/models"
xai-docs page "developers/advanced-api-usage/batch-api"

# List all available page slugs
xai-docs list
```

## Common Slugs

| Topic | Slug |
|-------|------|
| Models + pricing | `developers/models` |
| Quickstart | `developers/quickstart` |
| Function calling | `developers/function-calling` |
| Batch API | `developers/advanced-api-usage/batch-api` |
| Async API | `developers/advanced-api-usage/async` |
| Rate limits | search for "rate limits" or check `developers/models` |
| Billing | `console/billing` |

## When to Use

- Before implementing x.ai API calls — check current model IDs, pricing, rate limits
- When hitting errors — search for the error type or feature
- When comparing Grok models — `xai-docs page "developers/models"` gives the full table
- When working on x.ai provider config — check available endpoints and auth format

## Notes

- No auth required — public endpoint
- Returns markdown content
- The `search` command returns excerpts with page slugs — use `page` to get the full content
- `list` returns all ~30+ page slugs if you want to browse
- Endpoint: `https://docs.x.ai/api/mcp` (JSON-RPC, stateless)