How do I use Grok-MCP-Claude?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Grok-MCP-Claude Generate an image of a sunset over mountains" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Grok-MCP-Claude

by yukincom

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Grok-MCP-Claude

Grok MCP server optimized for Claude Desktop — clean, single-file implementation using xAI's Grok for real-time web/X search and image generation.

Concept

Claude thinks, Grok searches.

Claude Desktop handles conversation, memory, and reasoning. Grok provides what Claude can't — real-time web search, X (Twitter) search, and image/video generation.

sucsess

Related MCP server: openai-agents-mcp

Features

Tool	Description
`grok_search`	Real-time web and X (Twitter) search
`grok_chat`	Chat with vision, file, and code execution support
`grok_agent`	Multi-tool agent combining search, code execution, files, and images
`generate_image`	Image generation with img2img support
`generate_video`	Video generation with img2video and video2video support
`manage_files`	Upload, list, retrieve, and delete files on xAI

Requirements

Python 3.10+
xAI API key
Claude Desktop

Installation

git clone https://github.com/yourname/grok-mcp-claude.git
cd grok-mcp-claude
pip install -r requirements.txt

Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "grok": {
      "command": "python",
      "args": ["/path/to/grok-mcp-claude/grok.py"],
      "env": {
        "XAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tool Reference

`grok_search`

Real-time search via web or X (Twitter).

Parameter	Default	Description
`prompt`	required	Search query
`platform`	`"web"`	`"web"` or `"x"`
`model`	`DEFAULT_SEARCH_MODEL`	Model to use
`allowed_targets`	`None`	Whitelist of domains (web) or handles (X)
`excluded_targets`	`None`	Blacklist of domains (web) or handles (X)
`from_date`	`None`	Start date `DD-MM-YYYY` (X only)
`to_date`	`None`	End date `DD-MM-YYYY` (X only)
`include_inline_citations`	`False`	Return inline citations

`grok_chat`

General-purpose chat with optional vision, file, and code execution.

Parameter	Default	Description
`prompt`	required	User message
`model`	`DEFAULT_CHAT_MODEL`	Model to use
`system_prompt`	`None`	System prompt
`file_ids`	`None`	xAI file IDs to attach
`image_paths`	`None`	Local image paths
`image_urls`	`None`	Image URLs
`response_id`	`None`	Previous response ID for stateful chat
`use_code_execution`	`False`	Enable code execution

`grok_agent`

Multi-tool agent. Combine web search, X search, code execution, files, and images freely.

Parameter	Default	Description
`prompt`	required	User message
`model`	`DEFAULT_SEARCH_MODEL`	Model to use
`use_web_search`	`False`	Enable web search
`use_x_search`	`False`	Enable X search
`use_code_execution`	`False`	Enable code execution
`allowed_targets`	`None`	Whitelist of domains or handles
`excluded_targets`	`None`	Blacklist of domains or handles
`file_ids`	`None`	xAI file IDs to attach
`image_paths`	`None`	Local image paths
`image_urls`	`None`	Image URLs
`system_prompt`	`None`	System prompt
`include_inline_citations`	`False`	Return inline citations
`max_turns`	`None`	Max search iterations

`generate_image`

Generate images. Pass image_path or image_url for img2img.

Parameter	Default	Description
`prompt`	required	Generation prompt
`model`	`DEFAULT_IMAGE_MODEL`	Model to use
`n`	`1`	Number of images
`image_path`	`None`	Local image for img2img
`image_url`	`None`	Image URL for img2img
`aspect_ratio`	`None`	e.g. `"16:9"`, `"1:1"`, `"9:16"`

`generate_video`

Generate videos from text, image, or video.

Parameter	Default	Description
`prompt`	required	Generation prompt
`model`	`DEFAULT_VIDEO_MODEL`	Model to use
`image_path` / `image_url`	`None`	Source image for img2video
`video_path` / `video_url`	`None`	Source video for video2video
`duration`	`None`	Duration in seconds
`aspect_ratio`	`None`	Aspect ratio
`resolution`	`None`	Resolution

`manage_files`

Manage files on xAI.

Action	Required params	Description
`upload`	`file_path`	Upload a file
`list`	—	List uploaded files
`get_info`	`file_id`	Get file metadata
`get_content`	`file_id`	Get file content
`delete`	`file_id`	Delete a file

Models

DEFAULT_CHAT_MODEL   = "grok-4-1-fast-non-reasoning"
DEFAULT_SEARCH_MODEL = "grok-4-1-fast-reasoning"
DEFAULT_IMAGE_MODEL  = "grok-imagine-image"
DEFAULT_VIDEO_MODEL  = "grok-imagine-video"

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Remote Desktop CommanderOAuth
app.desktopcommander
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Shell Access OS Automation
219
mcp-grokOAuth
io.github.AceDataCloud
MCP server for Grok Imagine AI video generation
AI & Machine Learning Image & Video Processing
31
mcp
dev.augments
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Developer Tools Documentation Access
2128
Writingmate MCPOAuth
ai.writingmate
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
AI & Machine Learning Image & Video Processing
1

Related MCP Servers

computer-use-mcp
OS Automation Shell Access
domdomegg
A
license
Not graded
quality
A
maintenance
MCP server that enables Claude to control your computer, similar to Anthropic's computer use but easy to set up locally.
Updated 10 days ago (2026-09-03 01:17 UTC)
236
362
MIT
openai-agents-mcp
AI & Machine Learning Agent Orchestration
merlinrabens
A
license
A
quality
D
maintenance
MCP server that bridges OpenAI's Agents SDK with Claude Code, enabling web search, file search, and computer use capabilities directly in your development environment.
Updated a year ago (2025-08-22 11:32 UTC)
2
9
1
MIT
MCP Web Server
Web Scraping Browser Automation Search
zhaiy
F
license
D
quality
D
maintenance
A local MCP server providing free network access capabilities including HTTP requests, web search, webpage content extraction, and optional screenshots, designed for integration with Claude Desktop or Claude Code.
Updated 6 months ago (2026-03-13 03:45 UTC)
6
-
gemini-research-mcp
Search Text Summarization
Esanii
F
license
Not graded
quality
C
maintenance
An MCP server that adds real-time web research to Claude Desktop using Gemini 2.5 Flash with native Google Search grounding.
Updated 2 months ago (2026-07-14 01:46 UTC)
-

Grok-MCP-Claude

Concept

Features

Requirements

Installation

Configuration

Tool Reference

grok_search

grok_chat

grok_agent

generate_image

generate_video

manage_files

Models

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

computer-use-mcp

openai-agents-mcp

MCP Web Server

gemini-research-mcp

`grok_search`

`grok_chat`

`grok_agent`

`generate_image`

`generate_video`

`manage_files`