xai-grok

name	xai-grok
description	xAI Grok APIs for image generation, chat, vision, live search, and video. Use when the user asks to use Grok, xAI, or Grok Imagine for generating images, chatting with Grok, analyzing images with Grok Vision, searching the web/news/X with Grok, or generating videos. Triggers on "grok", "xai", "grok imagine", "ask grok", "grok vision", "grok search".
allowed-tools	mcp__xai__generate_image, mcp__xai__chat, mcp__xai__analyze_image, mcp__xai__live_search, mcp__xai__generate_video

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

1. Check /mcp in Claude Code
2. Verify ~/.claude/mcp.json has the xai entry
3. 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