Gpt Image Mcp

io.github.youbotapiPublished by GitHub account youbotapiv0.2.2Updated Oct 24, 2026

Generate and edit images with GPT Image 2.5 for $0.029 — free key, 50 credits, no card.

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

A local MCP server that lets an assistant generate new images from text prompts and edit existing images through the you.bot gateway, at a flat per-image cost.

What you can do
Generate an image from a text prompt at a chosen aspect ratio, returned inline in the chat after a 30–60 second wait and billed per image. Edit an existing image from a public URL, such as swapping a background, adding or removing objects, or restyling. Check the remaining credit balance and how many images it buys, at no cost. Optionally save every generated image as a PNG to a configured folder.
When to use it
Useful when you want image creation or editing inside an MCP client without an OpenAI account, and are comfortable paying a small per-image fee through a reseller gateway. Good for quick illustrations, posters or signs with rendered text, and simple edits to images already reachable by public URL.
Requirements
Runs locally over stdio via npx, so Node.js 18 or newer is needed. Requires a you.bot API key in the YOUBOT_API_KEY environment variable; an OpenAI key will not work. A you.bot account with credits is needed, and network access to the you.bot gateway. Optionally set YOUBOT_IMAGE_DIR to also save images to a folder.
Before you install
Every generation or edit spends credits (about $0.029 per image), so usage costs real money once the free signup credits run out. The key in YOUBOT_API_KEY is a paid credential and should be kept out of shared configs. Prompts and image URLs are sent to the you.bot third-party gateway, not to OpenAI directly. Setting YOUBOT_IMAGE_DIR writes generated files to your local disk.

Installation

In SourceWeft

  1. Open Gpt Image Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

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

Claude Desktop

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

json
{  "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 Code
bash
claude mcp add gpt-image -e YOUBOT_API_KEY=sk-live-your-key -- npx -y gpt-image-2-5-mcp
Cursor

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

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

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

ToolWhat it doesCost
generate_imageMake an image from a text prompt2.9 credits ($0.029)
edit_imageChange an existing image from a public URL — swap a background, add or remove objects, restyle2.9 credits ($0.029)
check_creditsShow remaining balance and images leftfree

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 signup50 credits ≈ 17 images, no card
Credit value1 credit = $0.01
ExpiryCredits never expire
Failed generationsRefunded automatically

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

Optional settings

Environment variableEffect
YOUBOT_API_KEYRequired. Your you.bot key (sk-live-…)
YOUBOT_IMAGE_DIRIf 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

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

Source: README.md at commit f60654c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 17, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts