Grok2 Image MCP Server

@fl0w1nd

About Grok2 Image MCP Server

grok image mcp server

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Grok2 Image MCP Server?

An MCP (Model Context Protocol) server for generating and editing images using the Grok image model from xAI. It serves developers integrating image capabilities into AI workflows via MCP-compatible clients.

How to use Grok2 Image MCP Server?

Install via npx in your MCP client configuration, setting the required environment variable XAIAPI_KEY. The server exposes two tools: generate_image and edit_image, invoked by the client with parameters such as prompt, image URLs, aspect ratio, resolution, and batch count.

Key features of Grok2 Image MCP Server

Image generation from text prompts with configurable aspect ratio and resolution
Image editing using natural language instructions with 1–3 source images
Local file path support for editing; server auto-reads and encodes them
Optional image proxy domain to replace imgen.x.ai in returned URLs
Optional HTTP/HTTPS network proxy for API requests

Use cases of Grok2 Image MCP Server

Generate images from descriptive prompts with custom dimensions and batch count
Edit existing images by providing URLs, base64 data, or local file paths
Overcome network restrictions on imgen.x.ai using an image proxy domain
Configure network proxying for API calls through corporate or regional gateways

FAQ from Grok2 Image MCP Server

What tools does Grok2 Image MCP Server provide?

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

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.

How do I handle network or image URL restrictions?

Set XAIAPI_BASE_URL to an API proxy, IMAGE_PROXY_DOMAIN to a custom proxy for image URLs, or HTTP_PROXY for a general network proxy.

What are the parameter limits for image generation?

n (number of images) supports 1–10 (default 1). Aspect ratio options include 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, and auto. Resolution can be 1k or 2k (default 1k).

Frequently asked questions

What tools does Grok2 Image MCP Server provide?

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

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.

How do I handle network or image URL restrictions?

Set `XAIAPI_BASE_URL` to an API proxy, `IMAGE_PROXY_DOMAIN` to a custom proxy for image URLs, or `HTTP_PROXY` for a general network proxy.

What are the parameter limits for image generation?

`n` (number of images) supports 1–10 (default 1). Aspect ratio options include `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, and `auto`. Resolution can be `1k` or `2k` (default 1k).

Comments

Basic information

More Media & Design MCP servers

Figma MCP Server

JayArrowz

Figma MCP Server with full API functionality

SVGator

Drive your SVGator account from any AI assistant. Prompt an animation, get an editable project back, and export it as SVG, Lottie, GIF, MP4, and more, then open it in the editor to finish by hand.

Figma MCP Server

thirdstrandstudio

Figma MCP Server with full API functionality

Lamina — On-brand product photos, video & try-ons

Lamina

Generate on brand product videos from Claude Code (or any assistant) in one line. Lamina turns a brief + your brand kit into finished product photos, video reels, and campaign banners - no prompt engineering; brand guard

MiniMax MCP JS

MiniMax-AI

Official MiniMax Model Context Protocol (MCP) JavaScript implementation that provides seamless integration with MiniMax's powerful AI capabilities including image generation, video generation, text-to-speech, and voice cloning APIs.

123