# Image MCP Server

> Standardized image generation interface for AI agents via Model Context Protocol (MCP)

## Overview

Image MCP is a hosted MCP server that provides image generation capabilities to AI agents through a standardized interface. It uses the Model Context Protocol for seamless integration with LLM applications like Cursor, Claude Desktop, and other MCP-compatible clients.

## Authentication

Image MCP requires an API key for authentication. Get your API key from https://imagemcp.io/dashboard/keys

- **Header**: Authorization: Bearer YOUR_API_KEY
- **Credits**: Each image generation costs 10 credits
- **New accounts** receive free credits to get started

## Quick Start

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "image-mcp": {
      "url": "https://imagemcp.io/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

## API Endpoint

- **URL**: https://imagemcp.io/api/mcp
- **Protocol**: MCP over Streamable HTTP
- **Method**: POST
- **Authentication**: Bearer token (API key required)

## Available Tools

### generate_image

Generates an image from a text prompt.

**Parameters:**
- `prompt` (string, required): Text description of the image to generate
- `model` (string, optional): Model ID to use. Default: google/gemini-3-pro-image-preview

**Returns:**
- `url`: Public CDN URL of the generated image
- `model`: Model used for generation
- `prompt`: Original prompt
- `filename`: Generated filename

## Available Models

- google/gemini-3-pro-image-preview (default)
- openai/gpt-5-image
- black-forest-labs/flux.2-flex
- black-forest-labs/flux.2-pro
- google/gemini-2.5-flash-image

## Available Prompts

### generate-image
Basic image generation prompt template.
- `description` (string): User's description of the desired image

### generate-image-detailed
Detailed image generation with style parameters.
- `subject` (string): Main subject of the image
- `style` (string, optional): Art style (e.g., photorealistic, cartoon)
- `mood` (string, optional): Mood or atmosphere
- `lighting` (string, optional): Lighting conditions

## Resources

### mcp://image-mcp/models
Lists all available image generation models with their IDs and names.

## IDE Integration Guides

- Cursor: https://imagemcp.io/connect/cursor
- Claude Code: https://imagemcp.io/connect/claude-code
- Windsurf: https://imagemcp.io/connect/windsurf
- Cline (VS Code): https://imagemcp.io/connect/cline
- Zed: https://imagemcp.io/connect/zed
- VS Code (Continue): https://imagemcp.io/connect/vscode
- Roo Code: https://imagemcp.io/connect/roo-code

## Links

- All Integrations: https://imagemcp.io/connect
- Full Documentation: https://imagemcp.io/docs
- OpenAPI Spec: https://imagemcp.io/api/openapi
- AI Plugin Manifest: https://imagemcp.io/.well-known/ai-plugin.json