Grok MCP
by jzubielik
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PGPASSWORD | No | Password for the PostgreSQL database. The password travels apart from the URL, so it may contain any characters. | |
| XAI_API_KEY | Yes | Your xAI API key from console.x.ai. | |
| DATABASE_URL | Yes | PostgreSQL connection URL, e.g. postgresql://grok@127.0.0.1:5432/context_cache. Required. | |
| MCP_AUTH_TOKEN | No | Bearer token for HTTP transport authentication. Must be at least 32 characters with no whitespace. Required for non-loopback binds. | |
| GROK_MODELS_TTL | No | Seconds to cache the live xAI model catalog. | 86400 |
| GROK_LOG_CONTENT | No | Log content policy: "metadata" (default) or "full". | metadata |
| GROK_MAX_COST_USD | No | Run cost budget in USD for agent calls. Ceiling; a call may lower it with max_cost_usd. | 2.5 |
| GROK_SHELL_TIMEOUT | No | Seconds per shell command (agent tool and shell()). | 240 |
| GROK_MAX_ITERATIONS | No | Maximum model rounds in the agent tool loop. Ceiling; a call may lower it with max_iterations. | 100 |
| GROK_MAX_READ_BYTES | No | Maximum size in bytes for files loaded by the server. | 20971520 |
| GROK_CHARS_PER_TOKEN | No | Estimate for text the API has not counted yet. | 3 |
| GROK_INPUT_MAX_RATIO | No | prompt + file_paths + images above this share of the model's window are rejected up front. | 0.6 |
| GROK_JOB_MAX_SECONDS | No | Run time budget in seconds for agent calls. Ceiling; a call may lower it with max_seconds. | 1800 |
| GROK_CONTEXT_MAX_RATIO | No | Conversation ceiling: old results trimmed once, then new ones refused, then stopped: "context". | 0.8 |
| GROK_FOREGROUND_TIMEOUT | No | A foreground agent call still running after this many seconds is moved to a background job and returns {job_id}. | 60 |
| GROK_READ_ALLOWED_PATHS | No | Paths where read, file_paths, image and audio inputs are allowed. When unset, no read restrictions apply. | |
| GROK_RETENTION_CHAT_DAYS | No | Days to keep chat history messages. 0 keeps forever. | 30 |
| GROK_RETENTION_JOBS_DAYS | No | Days to keep job metadata (status, model, token usage, timing). 0 keeps forever. | 365 |
| GROK_WRITE_ALLOWED_PATHS | No | Paths where write, generate_image and text_to_speech outputs are allowed. Empty means write is denied everywhere. | |
| GROK_TOOL_RESULT_MAX_RATIO | No | A single tool result above this share is replaced by "read a range / grep" instructions. | 0.15 |
| GROK_RETENTION_PROJECTS_DAYS | No | Days to keep project discovery data since last refresh. 0 keeps forever. | 90 |
| GROK_RETENTION_JOB_CONTENT_DAYS | No | Days to keep background job result and error text after the job ends. 0 keeps forever. | 7 |
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
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues