Skip to main content
Glama
jun9100

grok-mcp

by jun9100
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_TOKENYesThe bearer token for authenticating MCP requests.
ADMIN_PASSWORDYesThe password for the admin user.
ADMIN_USERNAMENoThe username for the admin user (used in Docker).
SESSION_SECRETYesThe secret used for session management.
PUBLIC_BASE_URLYesThe public base URL of this server.
GROK2API_API_KEYYesThe API key for Grok2API.
GROK2API_BASE_URLYesThe base URL of the Grok2API server.
GROK_MCP_MEDIA_DIRNoThe 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jun9100/grok-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server