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:

code

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:

code

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:

code

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:

code

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:

code

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 /mcp in Claude Code
•Verify ~/.claude/mcp.json has the xai entry
•Restart Claude Code

API Key Issues

Ensure XAI_API_KEY is set in ~/.claude/mcp.json:

json

"env": {
  "XAI_API_KEY": "xai-your-key-here"
}

Get your API key from: https://x.ai/api