GPT Image 2.5 MCP
OfficialGenerate and edit images with OpenAI's GPT Image 2.5 via the you.bot API, and check your credit balance.
generate_image: Create a 1024px image from a text prompt (costs 2.9 credits / $0.029). Supports aspect ratios from 1:1 to 21:9.
edit_image: Modify an existing image from a public URL — change, add, remove, or restyle elements while keeping the rest (costs 2.9 credits / $0.029).
check_credits: View your remaining you.bot credit balance and how many images it buys (free).
Requires a you.bot API key (
YOUBOT_API_KEY), not an OpenAI key; free signup gives 50 credits (~17 images).
Generates and edits images using OpenAI's GPT Image 2.5 model, supporting text-to-image prompts, editing existing images from URLs, multiple aspect ratios, and credit balance checking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GPT Image 2.5 MCP create a photo of a golden retriever wearing sunglasses on a beach"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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'"

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)
Sign up at https://you.bot — no credit card.
You start with 50 credits ≈ 17 images.
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-mcpIn ~/.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 |
| Make an image from a text prompt | 2.9 credits ($0.029) |
| Change an existing image from a public URL — swap a background, add or remove objects, restyle | 2.9 credits ($0.029) |
| 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 |
| Required. Your you.bot key ( |
| 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.
Links
Model and live pricing — https://you.bot/models/gpt-image-2-5-sunburst-text-to-image
API docs — https://you.bot/docs
Get a key — https://you.bot
MIT licensed. Not affiliated with OpenAI; GPT Image 2.5 is accessed through the you.bot API.
Available Tools
3 toolscheck_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
Scored across 3 tools
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.
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.
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.
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
Related MCP Connectors
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
Generate AI images and videos from any compatible MCP client.
Generate AI video, images and audio, and browse your history, from any MCP client.
Generate and edit images, create videos, quote credit costs, and retrieve private results.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI image generation, editing, upload, and local download through CloseAI's gpt-image-2 service, allowing MCP-compatible clients like Codex to manage images with configurable models, sizes, and quality.-
- AlicenseAqualityBmaintenanceEnables any MCP client to generate and edit images through ChatGPT's Codex backend, saving them locally with no API key or per-image billing.5125 npm10Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables users to generate and edit images from MCP-compatible clients, with automatic prompt optimization and quality presets, and supports Gemini, OpenAI GPT Image, and BytePlus Seedream.1,781 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables generating and editing images from MCP clients with automatic prompt optimization and quality presets, using Gemini, OpenAI, or BytePlus Seedream and saving results to disk.1,781 npmMIT