grok-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_TOKEN | Yes | The bearer token for authenticating MCP requests. | |
| ADMIN_PASSWORD | Yes | The password for the admin user. | |
| ADMIN_USERNAME | No | The username for the admin user (used in Docker). | |
| SESSION_SECRET | Yes | The secret used for session management. | |
| PUBLIC_BASE_URL | Yes | The public base URL of this server. | |
| GROK2API_API_KEY | Yes | The API key for Grok2API. | |
| GROK2API_BASE_URL | Yes | The base URL of the Grok2API server. | |
| GROK_MCP_MEDIA_DIR | No | The directory where media files are stored. |
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 | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_modelsA | List Grok Console models targeted by this MCP, plus whatever the connected Grok2API gateway currently exposes via GET /v1/models. |
| list_console_catalogA | Return the static Grok Console model catalog used by this MCP (chat / image / video), without calling the gateway. |
| generate_imageA | Generate images via Grok2API Console models, download them to the grok-mcp host, and return MCP Image content for inline display. Default model: grok-imagine-image; quality=true uses grok-imagine-image-quality. After a successful local download, remote gallery assets are deleted when GROK2API_ADMIN_* credentials are set. aspect_ratio examples: 1:1, 16:9, 9:16. |
| edit_imageA | Edit existing image(s) via Grok2API Console models, download results locally, return MCP Image content, and optionally delete remote gallery assets after success. Provide 1-8 publicly reachable image URLs. |
| generate_videoA | Create an asynchronous Console video job via Grok2API (model grok-imagine-video). Returns request_id immediately. Then call wait_video to download the finished file to grok-mcp, get a public /media URL, and optionally delete the remote gallery job. duration 1-15s (default 8). aspect_ratio: 1:1|16:9|9:16|... resolution: 480p|720p|1080p. |
| get_video_statusA | Poll a video job once. status is pending|done|failed. If done and materialize=true, download to local storage and return public_url. |
| wait_videoA | Block until a video job finishes, then download the mp4 to the grok-mcp host and return public_url (http://host/media/...). After successful download, deletes the remote Grok2API video job when admin credentials are configured. timeout defaults to GROK2API_VIDEO_POLL_TIMEOUT (600s). |
| web_searchA | Search / research through Grok2API chat completions with hosted web_search enabled. Default Console model: grok-4.3. Other Console chat models also work: grok-4.5, grok-4.20-0309-*, grok-4.20-multi-agent-0309, grok-build-0.1. |
| chatB | Console chat completion via Grok2API POST /v1/chat/completions. Default model: grok-4.20-0309-non-reasoning. Optional enable_web_search. Also supports grok-4.3 / grok-4.5 / grok-4.20-0309-reasoning / grok-4.20-multi-agent-0309 / grok-build-0.1. |
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
Most tools target distinct actions (generate, edit, chat, search, video lifecycle). list_models and list_console_catalog overlap slightly but are differentiated by static vs dynamic sources, and get_video_status vs wait_video serve separate polling vs blocking needs.
The majority follow a consistent snake_case verb_noun pattern (list_models, generate_image, wait_video). 'chat' and 'web_search' are minor deviations but remain clear and predictable.
9 tools are well-scoped for the server's purpose of exposing Grok chat, web search, image, and video capabilities. Each tool contributes a distinct function without unnecessary bloat.
The tool surface covers the full lifecycle for its domain: chat, web search, image generation/editing, and video creation (submit, poll, wait/download). No obvious missing operations are evident.