merterbak/Grok-MCP

MCP server for xAI’s Grok API with Web/X search, vision, image/video generation and file support.
Features
- **Agentic Tool Calling**: Web search, X search, code execution, and image generation with multi-step reasoning
- **Multiple Grok Models**: Access to latest models such as grok-4.6, grok-4.5, grok-build-0.1 and more
- **Image and Video Generation**: Create images and videos using Grok Imagine
- **Vision Capabilities**: Analyze images with Grok's vision models
- **Files API**: Upload, manage, and chat with documents
- **Stateful Conversations**: Maintain conversation context as id across multiple requests
- **Local Chat History**: Option to save persistent client side chat history as JSON files in chats/
Prerequisites
- Python 3.11 or higher
- xAI API key (Get one here)
- Astral UV
Installation
1. Clone the repository:
2. Create a venv environment:
3. Install dependencies:
Configuration
Claude Desktop Integration
Add this to your Claude Desktop configuration file:
Claude Code Integration
Run this command from inside the project directory:
Or if you have a .env file with your key:
Verify it's registered:
Filesystem MCP (Optional)
Claude Desktop can't send uploaded images in the chat to an MCP tool.
The easiest way to give access to files directly from your computer is official Filesystem MCP server.
After setting it up you’ll be able to just write the image’s file path (such as /Users/mert/Desktop/image.png) in chat and Claude can use it with any vision chat tool.
---
For stdio:
Docker:
Mcp Inspector:
Available Tools
Each tool has a full docstring in src/server.py with its arguments and return format. MCP client surfaces those directly, so this list is just a quick map of what's available.
Note: For using images and files, you must provide paths to chat. See Filesystem MCP (Optional) for setup.
Chat and reasoning
- chat — standard chat completion with optional persistent history, multi-agent support,
and a per request service_tier.
- chat_with_vision — analyze local or remote images with a Grok vision model.
- chat_with_files — chat grounded on previously uploaded documents.
- stateful_chat — continue a server-side stored conversation via response_id.
- retrieve_stateful_response — fetch a stored response by ID.
- delete_stateful_response — delete a stored response by ID.
Agentic tools
- web_search — autonomous web research with domain filters and citations.
- x_search — autonomous search over X (Twitter) posts, with handle and date filters.
- code_executor — solve tasks by running Python in a sandbox.
- grok_agent — unified agent that mixes files, images, web search, X search, code execution,
and server-side image generation. Generated images are written to images/.