How do I use mcp-server-grok-image?

1. Click on "Install 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., "@mcp-server-grok-image Generate an image of a peaceful mountain landscape at sunrise." 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.

mcp-server-grok-image

by codeChap

Overview Schema Related Servers Score Discussions

Rust

Local

mcp-server-grok-image

An MCP (Model Context Protocol) server for xAI's Grok image generation API. Built in Rust, exposes image generation and editing as MCP tools.

Communicates via stdio using JSON-RPC 2.0, like all MCP servers.

Tools

Tool	Description
`generate_image`	Generate an image from a text prompt
`edit_image`	Edit an existing image using natural language instructions
`headshot`	Corporate headshot from a source portrait (pad to 3:2 + fixed edit prompt)
`list_styles`	List available image styles for use with `generate_image`

generate_image

Generate an image from a text description.

Parameters:

Name	Type	Required	Description
`prompt`	string	yes	Text description of the desired image
`model`	string	no	Model to use (default: `grok-imagine-image-2.0`)
`n`	integer	no	Number of images to generate (1-10, default 1)
`aspect_ratio`	string	no	Aspect ratio: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, `19.5:9`, `9:19.5`, `20:9`, `9:20`, `21:9`, `5:2`, `auto`
`resolution`	string	no	Output resolution: `1k` (~1024px, default) or `2k` (~2048px)
`quality`	string	no	`low`, `medium`, or `auto` (2.0 only; omitted = `auto`. Auto currently serves `low` for generation)
`response_format`	string	no	Output format: `url` (default, temporary) or `b64_json`
`style`	string	no	Style name to apply (use `list_styles` to see options)

When a style is set, the prompt is wrapped in the style's template. For example, with style: "watercolor" and prompt: "a cat on a roof", the API receives "a cat on a roof, as a watercolor painting". Avoid including style language in the prompt itself when using this parameter.

The response includes the resolved prompt so you can see exactly what was sent to the API.

edit_image

Edit an existing image using natural language instructions.

Parameters:

Name	Type	Required	Description
`image_url`	string	no*	URL, base64 data URI, or local file path of the source image. Mutually exclusive with `images`.
`images`	string[]	no*	Up to 5 source images for multi-image editing. Reference them in the prompt as `<IMAGE_0>`, `<IMAGE_1>`, …
`prompt`	string	yes	Natural language edit instructions
`model`	string	no	Model to use (default: `grok-imagine-image-2.0`)
`n`	integer	no	Number of variations to generate (1-10, default 1)
`aspect_ratio`	string	no	Same set as `generate_image`, including `21:9` and `5:2`
`resolution`	string	no	Output resolution: `1k` (~1024px, default) or `2k` (~2048px)
`quality`	string	no	`low`, `medium`, or `auto` (2.0 only; omitted = `auto`. Auto currently serves `medium` for editing)
`response_format`	string	no	Output format: `url` (default, temporary) or `b64_json`

* Provide either image_url or images.

Note: The style parameter is intentionally not available on edit_image -- edit prompts are instructions (e.g. "remove the background"), not descriptions, so wrapping them in style templates would produce nonsense.

headshot

Expand-only portrait fix (Gemini pipeline equivalent on Imagine). Does not reframe pose, cut out hair, or redesign the person.

Resize full source (default 550px wide) — never crop
Letterbox with white gutters to canvas width (default 780)
Call grok-imagine-image-2.0 at quality medium: complete cut-off shoulders if needed; clean solid white background; keep face/hair/pose/clothing/logos

No cutout / no rembg / no transparent alpha — same job as the original Gemini headshot skill.

Parameters:

Name	Type	Required	Description
`image`	string	yes	Local path, http(s) URL, or `data:` URI
`clothing`	string	no	For missing-shoulder fill only
`notes`	string	no	Must-preserve details (glasses, exact logo text, …)
`pronoun`	string	no	`his` / `her` / `their` (default `their`)
`gravity`	string	no	Letterbox gravity (`North` default)
`content_width`	integer	no	Resize width before pad (default `550`)
`canvas_width`	integer	no	Padded width (default `780`)
`resolution`	string	no	`1k` or `2k` (default `2k`)
`output_path`	string	no	Optional final path (also under `save_dir`)
`n`	integer	no	Variations (1–10, default 1)
`quality`	string	no	`low` / `medium` / `auto` (default `medium`)
`model`	string	no	Default `grok-imagine-image-2.0`

Padded intermediate: save_dir/headshot-padded_*.jpg.

list_styles

Returns all available image styles with their name, description, and prompt template. No parameters.

Built-in Styles

Style	Description
`watercolor`	Watercolor painting style
`oil-painting`	Oil painting with visible brushstrokes
`pencil-sketch`	Detailed pencil sketch
`pixel-art`	Retro pixel art
`anime`	Anime style illustration
`pop-art`	Bold pop art style
`art-nouveau`	Art nouveau with flowing organic lines
`cinematic`	Cinematic photography with dramatic lighting
`portrait`	Professional portrait photography
`macro`	Extreme macro photography
`aerial`	Aerial drone photography
`studio`	Studio photography on clean background
`noir`	Dark film noir style
`vintage`	Faded vintage photograph

Available Models

Model	Notes
`grok-imagine-image-2.0` (default)	Optional `quality` (`low` / `medium` / `auto`), up to 5 edit references, `21:9` and `5:2`. Auto currently serves `low` for generation and `medium` for editing.
`grok-imagine-image`	1.0. Still available; no `quality` param.
`grok-imagine-image-quality`	Retires 2026-11-02. After that the slug is served by `grok-imagine-image-2.0` at `quality: low` ($0.01 less per image than the quality model).

Related MCP server: image-forge-mcp

Prerequisites

Rust (edition 2024)
An xAI API key from console.x.ai

Setup

Create the config file:

mkdir -p ~/.config/mcp-server-grok-image

Create ~/.config/mcp-server-grok-image/config.toml:

api_key = "xai-..."

Custom Styles

Add custom styles to your config file. Custom styles with the same name as a built-in will override it.

api_key = "xai-..."

[[styles]]
name = "my-style"
description = "My custom look"
template = "{prompt}, in my custom style"

[[styles]]
name = "watercolor"
description = "My watercolor variant"
template = "{prompt}, as a loose expressive watercolor with ink outlines"

Templates must contain the {prompt} placeholder. Any custom style missing it will be skipped with a warning at startup.

Build

cargo build --release

This produces target/release/mcp-server-grok-image.

For development:

cargo build              # debug build
cargo run                # run in dev mode
RUST_LOG=debug cargo run # run with debug logging

MCP Configuration

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

{
  "mcpServers": {
    "grok-image": {
      "command": "/path/to/mcp-server-grok-image"
    }
  }
}

Project Structure

src/
  main.rs      process entry (stdio MCP)
  config.rs    TOML / env config
  styles.rs    built-in + custom styles
  grok.rs      xAI request/response types
  params.rs    MCP tool params + validation
  image_io.rs  data URIs, local files, mime, fetch
  headshot.rs  letterbox pad + expand prompt
  server.rs    MCP tools and Grok HTTP

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

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

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

mcp-grokOAuth
io.github.AceDataCloud
MCP server for Grok Imagine AI video generation
AI & Machine Learning Image & Video Processing
21
mcp-qwen-imageOAuth
io.github.AceDataCloud
MCP server for Qwen Image 3 AI image generation
AI & Machine Learning Image & Video Processing
1
mcp-flux-proOAuth
io.github.AceDataCloud
MCP server for Flux AI image generation
Image & Video Processing Multimedia Processing
23
mcp A
com.budgetpixel
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
AI & Machine Learning Image & Video Processing Audio Processing
1212

Related MCP Servers

Grok Image MCP
Image & Video Processing AI & Machine Learning
fl0w1nd
A
license
A
quality
C
maintenance
MCP server for generating and editing images using xAI's Grok image model, supporting text prompts, batch generation, local files, and optional proxy configurations.
Updated 6 months ago (2026-03-03 11:11 UTC)
2
32
29
MIT
image-forge-mcp
Image & Video Processing AI & Machine Learning
Cheng77c
F
license
Not graded
quality
C
maintenance
An MCP server for AI-powered image processing (generate, edit, vary, analyze) supporting OpenAI, Gemini, Ideogram, and custom relay endpoints.
Updated 6 months ago (2026-03-03 09:42 UTC)
-
Grok Imagine Video MCP Server
Multimedia Processing AI & Machine Learning
ex-takashima
A
license
A
quality
B
maintenance
MCP server for generating, editing, and batch processing videos using xAI's Grok Imagine Video API, with support for text-to-video, image-to-video, and video editing via natural language prompts.
Updated 7 days ago (2026-08-30 04:04 UTC)
4
83
1
MIT
nanobanana-mcp
AI & Machine Learning Image & Video Processing
superboolgithub
F
license
A
quality
D
maintenance
MCP server for AI image generation supporting text-to-image and image-to-image editing via any OpenAI-compatible service, with configurable models, aspect ratios, and sizes.
Updated 7 months ago (2026-02-01 14:44 UTC)
2
-

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/codeChap/mcp-server-grok-image'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-server-grok-image

Tools

generate_image

edit_image

headshot

list_styles

Built-in Styles

Available Models

Prerequisites

Setup

Custom Styles

Build

MCP Configuration

Project Structure

License

Tool Schema Changelog

Maintenance

Resources

Looking for Admin?

Related MCP Connectors

Related MCP Servers

Grok Image MCP

image-forge-mcp

Grok Imagine Video MCP Server

nanobanana-mcp

Latest Blog Posts

MCP directory API