What environment variables are required?

`XAIAPI_KEY` is required. Optional variables include `XAIAPI_BASE_URL`, `IMAGE_PROXY_DOMAIN`, and `HTTP_PROXY`.

Can I use local image files for editing?

Yes, the `edit_image` tool accepts local file paths in the `image_urls` parameter; the server reads and encodes them automatically.

What credentials does it need?

It reads `XAIAPI_KEY`, `XAIAPI_BASE_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Grok2 Image MCP Server

grok image mcp server

Local serverstdio

What is the Grok2 Image MCP Server?

grok image mcp server

What you get

An MCP (Model Context Protocol) server for image generation and editing using the Grok image model from xAI.

Image Generation — — Generate images from text prompts with configurable aspect ratio, resolution, and batch count
Image Editing — — Edit existing images with natural language instructions, supporting 1–3 source images
Local File Support — — Provide local image paths for editing; the server reads and encodes them automatically
Image Proxy — — Optional proxy domain for imgen.x.ai to handle network restrictions
HTTP Proxy — — Optional network proxy for API requests

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
generate_image
edit_image

How to install the Grok2 Image MCP Server

{
  "mcpServers": {
    "grok_image": {
      "command": "npx",
      "args": ["grok-image-mcp"],
      "env": {
        "XAIAPI_KEY": "your-xai-api-key"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
XAIAPI_KEY	Credential the server authenticates with.	Yes
XAIAPI_BASE_URL	Endpoint or connection string the server talks to.	Yes

Example prompts to try

“Use Grok2 Image to generate image.”
“Use Grok2 Image to edit image.”

Frequently asked questions

Two tools: `generate_image` for creating images from text, and `edit_image` for modifying existing images using natural language.

Alternatives to the Grok2 Image MCP Server

Puppeteer

Official

The original Chromium automation reference server — simple, screenshot-driven browser control.

Browser AutomationTypeScript★ 63.0k

Fonoster

Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.

AI & ML ServicesTypeScript★ 8.1k

Kokoro Text To Speech

Generates MP3 files from text using the Kokoro-TTS model and optionally uploads them to S3.

AI & ML ServicesPython★ 78

Chroma

Embeddings, vector search, document storage, and full-text search with the open-source AI application database

AI & ML ServicesRemotePython

Audacity MCP

<strong>AI-powered audio editing in Audacity through the Model Context Protocol</strong>

Developer ToolsPython

Node Boilerplate

Demonstrates building an MCP server in Node.js with custom tools for seamless integration with AI-assisted environments.

AI & ML ServicesPython★ 75