Skip to main content
Glama
GPT Image 2.5 MCP

GPT Image 2.5 MCP

Official

GPT Image 2.5 MCP Server

Generate and edit images with GPT Image 2.5 — OpenAI's most capable image model — directly inside Claude, Cursor, or any MCP client. $0.029 per image.

npm license

Ask Claude for a picture and get one back in the chat:

"A friendly robot painting a picture at an easel in a sunlit studio, warm morning light through a tall window, soft shadows, detailed illustration style, a small wooden sign on the easel reading 'GPT IMAGE 2.5'"

Example output from GPT Image 2.5

Generated with this server in 45 seconds for $0.029. Note that the text on the sign came out exactly as asked — GPT Image 2.5 is unusually good at rendering words inside an image.


⚠️ Read this first: the API key comes from you.bot, not OpenAI

This server reaches GPT Image 2.5 through you.bot, an API gateway that resells the model below OpenAI's own rate.

  • You need a you.bot API key. It starts with sk-live-.

  • An OpenAI key will not work, and you do not need an OpenAI account at all.

  • If you paste an OpenAI key by mistake, the server will tell you so by name rather than failing with a confusing 401.

Why people use it: signup gives you 50 free credits — about 17 images — with no credit card, so the server works the moment you paste the key in.


Related MCP server: Codex ImageGen MCP

Setup

1. Get a free key (2 minutes)

  1. Sign up at https://you.bot — no credit card.

  2. You start with 50 credits ≈ 17 images.

  3. Create a key at https://you.bot/dashboard/api-keys and copy it (it begins with sk-live-).

2. Add the server to your client

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "gpt-image": {
      "command": "npx",
      "args": ["-y", "gpt-image-2-5-mcp"],
      "env": {
        "YOUBOT_API_KEY": "sk-live-your-key-from-you.bot"
      }
    }
  }
}

Restart Claude Desktop.

claude mcp add gpt-image -e YOUBOT_API_KEY=sk-live-your-key -- npx -y gpt-image-2-5-mcp

In ~/.cursor/mcp.json (or Settings → MCP → Add new server):

{
  "mcpServers": {
    "gpt-image": {
      "command": "npx",
      "args": ["-y", "gpt-image-2-5-mcp"],
      "env": { "YOUBOT_API_KEY": "sk-live-your-key-from-you.bot" }
    }
  }
}

Run npx -y gpt-image-2-5-mcp over stdio with YOUBOT_API_KEY in the environment.

3. Check it works

Ask your assistant: "check my image credits". You should see your balance and how many images it buys.


Tools

Tool

What it does

Cost

generate_image

Make an image from a text prompt

2.9 credits ($0.029)

edit_image

Change an existing image from a public URL — swap a background, add or remove objects, restyle

2.9 credits ($0.029)

check_credits

Show remaining balance and images left

free

There is also a setup prompt that walks you through configuration if something isn't working.

Aspect ratios: 1:1 (default), 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 2:1, 1:2, 21:9

Output is fixed at 1024px (1K), which is what keeps every call at a flat $0.029. A generation typically takes 30–60 seconds; the server polls until the image is ready and then shows it to you inline.


What it costs

Per image

$0.029

Free on signup

50 credits ≈ 17 images, no card

Credit value

1 credit = $0.01

Expiry

Credits never expire

Failed generations

Refunded automatically

The server tells you the cost after every image, and check_credits never spends anything.


Optional settings

Environment variable

Effect

YOUBOT_API_KEY

Required. Your you.bot key (sk-live-…)

YOUBOT_IMAGE_DIR

If set, every generated image is also saved to this folder as a PNG


Tips for better images

GPT Image 2.5 rewards long, specific prompts. Describe subject, setting, lighting, composition and style instead of stacking keywords.

It also renders text inside images accurately — so if you want words on a poster or a sign, quote them exactly:

"A minimalist café sign reading 'OPEN DAILY 7AM' in clean sans-serif, warm morning light, shallow depth of field"

For edit_image, say what should change and what should stay:

"Replace the background with a snowy forest. Keep the subject, pose and lighting unchanged."


Troubleshooting

"No API key found" — YOUBOT_API_KEY isn't reaching the server. Check it's inside the env block of your MCP config, then fully restart the client.

"That key looks like an OpenAI API key" — exactly what it says. Get a key from https://you.bot instead; it starts with sk-live-.

"Out of credits" — each image is 2.9 credits. Top up at https://you.bot; credits never expire.

Nothing happens / tool isn't offered — confirm your client picked the server up (Claude Desktop lists it under the tools icon), and that you have Node 18 or newer.


MIT licensed. Not affiliated with OpenAI; GPT Image 2.5 is accessed through the you.bot API.

Available Tools

3 tools
check_creditsA

Check the remaining you.bot credit balance and how many more images it buys. Free and instant — does not generate anything. Requires a you.bot API key in YOUBOT_API_KEY — NOT an OpenAI key. Free key with 50 starting credits (~17 images) at https://you.bot.

Inputs: no named parameters.

edit_imageA

Edit an existing image with GPT Image 2.5 — change, add, remove or restyle parts of it while keeping the rest. Takes a publicly reachable image URL and a description of the change. $0.029 per edit (2.9 credits), 1024px output. Requires a you.bot API key in YOUBOT_API_KEY — NOT an OpenAI key. Free key with 50 starting credits (~17 images) at https://you.bot.

Inputs: prompt (required), image_url (required), aspect_ratio.

generate_imageA

Generate an image from a text prompt using GPT Image 2.5 (OpenAI's most capable image model) at $0.029 per image, 1024px. Good at photorealism, illustration, and rendering readable text inside the image. Costs 2.9 credits per call. Requires a you.bot API key in YOUBOT_API_KEY — NOT an OpenAI key. Free key with 50 starting credits (~17 images) at https://you.bot.

Inputs: prompt (required), aspect_ratio.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: generate new images, edit existing images, or check credits. There is no functional overlap between any of the three tools.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case: generate_image, check_credits, edit_image. The naming convention is uniform and predictable.

    Tool Count5/5

    Three tools is a well-scoped count for an image generation/editing MCP server. Each tool covers a necessary operation without unnecessary bloat or redundancy.

    Completeness5/5

    The server covers the core domain completely: create an image, edit an image, and verify account credits. There are no obvious missing operations for the stated purpose of image generation and editing.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers