grok-oauth-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| XAI_BASE_URL | No | xAI API base URL. Defaults to https://api.x.ai/v1. | |
| GROK_OAUTH_MCP_CONFIG_DIR | No | Configurable token directory. Defaults to ~/.config/grok-oauth-mcp. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| auth_loginA | Start xAI web OAuth PKCE login using the Hermes Agent client. Use wait=true to capture the localhost callback and store tokens. |
| auth_statusA | Show local xAI OAuth token status without revealing token values. |
| auth_logoutB | Delete the local OAuth token store. |
| grok_chatC | Send a Grok chat or responses request to /responses with store=false. Defaults to model grok-build-0.1. |
| x_searchD | Ask Grok with the x_search tool enabled through /responses and optional x_search filters. |
| grok_ttsD | Generate speech through /tts. |
| grok_imageC | Generate or edit images through /images/generations or /images/edits. Defaults to grok-imagine-image and grok-imagine-image-quality. |
| grok_videoB | Generate text-to-video or image-to-video through /videos/generations, optionally polling /videos/{request_id}. |
| grok_transcribeC | Transcribe a local audio file through /audio/transcriptions using multipart form upload. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool targets a distinct operation: authentication (login/logout/status), Grok modalities (chat, image, transcribe, TTS, video), and search. No overlap in functionality.
Tools use consistent verb_noun naming with subdomain prefixes (auth_, grok_), but 'x_search' breaks the pattern by not using a prefix consistent with others. Still predictable overall.
With 9 tools, the server covers authentication and main Grok API capabilities without being bloated or sparse. Each tool serves a clear purpose.
Covers core auth lifecycle and major Grok features (chat, image, audio, video, search). Missing potential management tools (e.g., model listing) but not necessary for primary use cases.