joemccann xAI Grok MCP Server
Access xAI's Grok APIs through the MCP server.
When to Use This Skill
Use this skill when the user:
- Asks to generate images with Grok or Grok Imagine
- Wants to chat with Grok models
- Asks Grok to analyze or describe an image
- Wants to search the web, news, or X/Twitter with Grok
- Asks to generate videos with Grok
Trigger phrases: "grok", "xai", "grok imagine", "ask grok", "grok vision", "use grok"
Available Tools
| Tool | Description |
|---|---|
generate_image |
Generate images using Grok Imagine |
chat |
Chat with Grok models (grok-3, grok-4, grok-3-mini) |
analyze_image |
Analyze images with Grok Vision |
live_search |
Real-time web, news, and X/Twitter search |
generate_video |
Generate videos from text prompts |
Image Generation
Generate images with Grok Imagine:
User: "Using grok imagine, create a cyberpunk cityscape"
Tool: generate_image
Parameters:
prompt: "cyberpunk cityscape at night with neon lights"
n: 1 (optional, 1-10)
aspect_ratio: "16:9" (optional)
Supported Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
prompt |
string | required | Image description |
n |
number | 1 | Number of images (1-10) |
model |
string | grok-2-image | Image model |
aspect_ratio |
string | - | "16:9", "1:1", "4:3", etc. |
response_format |
string | url | "url" or "b64_json" |
Chat with Grok
Chat with Grok language models:
User: "Ask Grok to explain quantum computing"
Tool: chat
Parameters:
message: "Explain quantum computing in simple terms"
model: "grok-3" (optional)
Supported Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
message |
string | required | Message to send |
model |
string | grok-3 | grok-3, grok-4, grok-3-mini |
system_prompt |
string | - | System context |
temperature |
number | 0.7 | Sampling temperature (0-2) |
max_tokens |
number | - | Max response tokens |
Image Analysis (Vision)
Analyze images with Grok Vision:
User: "Use Grok to analyze this image: https://example.com/photo.jpg"
Tool: analyze_image
Parameters:
image_url: "https://example.com/photo.jpg"
prompt: "What do you see in this image?"
Supported Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
image_url |
string | required | Image URL or base64 |
prompt |
string | "Describe this image" | Question/instruction |
detail |
string | auto | "low", "high", "auto" |
model |
string | grok-2-vision-1212 | Vision model |
Live Search
Search web, news, or X/Twitter:
User: "Search for the latest SpaceX news using Grok"
Tool: live_search
Parameters:
query: "SpaceX launches"
sources: ["news"]
Supported Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
query |
string | required | Search query |
sources |
array | ["web"] | "web", "news", "x" |
date_range |
object | - | {start, end} YYYY-MM-DD |
max_results |
number | 10 | Max results (1-20) |
Video Generation
Generate videos from text:
User: "Generate a video of clouds moving across a blue sky"
Tool: generate_video
Parameters:
prompt: "clouds moving across a blue sky, timelapse"
duration: 5
Supported Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
prompt |
string | required | Video description |
model |
string | grok-2-video | Video model |
duration |
number | 5 | Duration (1-15 seconds) |
image |
string | - | Input image to animate |
video |
string | - | Input video to edit |
aspect_ratio |
string | - | "16:9", "9:16", etc. |
wait_for_completion |
boolean | true | Wait for video |
Troubleshooting
MCP Server Not Connected
- Check
/mcpin Claude Code - Verify
~/.claude/mcp.jsonhas the xai entry - Restart Claude Code
API Key Issues
Ensure XAI_API_KEY is set in ~/.claude/mcp.json:
"env": {
"XAI_API_KEY": "xai-your-key-here"
}
Get your API key from: https://x.ai/api