xai-grok - SKILL.md Agent Skill

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: mcpxaigenerate_image, mcpxaichat, mcpxaianalyze_image, mcpxailive_search, mcpxaigenerate_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

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:

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

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