home / mcp / 4o-image mcp server

4o-image MCP Server

An MCP server implementation that integrates with 4o-image API, enabling LLMs and other AI systems to generate and edit images through a standardized protocol. Create high-quality art, 3D characters, and custom images using simple text prompts.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "antipas-4oimage-mcp": {
      "url": "https://example.invalid",
      "headers": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can run a dedicated MCP server that talks to the 4o-image API to generate and edit images using simple text prompts. This server exposes a consistent protocol so your AI systems or LLMs can request image creation, edits, and progress updates with minimal setup.

How to use

You will connect to the 4o-image MCP server from your MCP client (or workflow) and send image generation requests using a prompt and, optionally, a base image for editing. The server returns status updates as the image is produced and, once ready, opens the result in your default browser. To edit an existing image, supply the base64-encoded image data along with a prompt describing the desired changes.

How to install

# prerequisites
node -v
npm -v

# install the MCP server package globally (or install in your project)
npm install -g 4oimage-mcp

# run the MCP server (this uses the standard runtime via npx in the config example)
npx -y 4oimage-mcp

Additional content

Configuration is centered around providing your API key to the server so it can access the 4o-image service. You will set the API key in the environment when starting the server.

Available tools

generateImage

Generate images from text prompts with optional imageBase64 for editing or style transfer