@imageat/mcp
This MCP server lets you generate images, generate videos, edit images, and check your ImageAT API credit balance.
Generate images from text prompts, optionally using reference images for image-to-image editing, with controls for model, number of images, resolution, aspect ratio, output format, and web search.
Generate videos from text or a starting image, with options for model, duration, resolution, aspect ratio, audio, and negative prompt.
Edit images using ImageAT edit features such as remove-background, object-eraser, relight, virtual-try-on, or city-teleport, with optional prompt, mask, and feature-specific options.
Check the current prepaid API credit balance for the account.
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., "@@imageat/mcp Generate an image of a futuristic city skyline at night"
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.
@imageat/mcp
Model Context Protocol (MCP) server for ImageAT. Gives any MCP client (Claude Desktop, Cursor, etc.) tools to generate images, generate video, and run ImageAT's image-edit features — billed against your ImageAT account.
Billing. If you have an active subscription, MCP requests spend your website credits at the same rate you'd pay on imageat.com — the same generation costs the same either way. When those credits run out (or if you have no subscription), requests bill your prepaid API balance at the API tariff. Connecting a client requires one of the two.
Tools
Tool | What it does |
| Text-to-image / image-to-image. Returns CDN image URL(s). |
| Text-to-video / image-to-video. Returns a CDN mp4 URL. |
| Experimental MCP Tasks version with |
| Checks an asynchronous video generation until it completes. |
| Ask Google's Gemini 4 Argon (optional image URLs, Google Search / Maps grounding). Returns the text answer. |
| Current prepaid API balance (USD). |
| Score how visible a website is to ChatGPT, Claude, Perplexity and AI agents (llms.txt, AI crawler rules, JSON-LD, sitemap, OpenGraph, MCP/agent files) with a fix list. Free. |
| Start here for a playable browser game: workflow, runtime rules and the kit API (Phaser 2D / three.js 3D). Free. |
| Search 2,700+ game-ready 3D library models; returns |
| One game asset: sprite, background, texture, logo, or an AI-made 3D |
| Checks your game code, bundles it with the engine and assets, and returns a shareable play link. |
| Publishes new code for one of your games as a new version (same link). Free. |
| Social accounts connected in imageat Social Hub (Instagram, Facebook Pages, LinkedIn, X…), whether each can post now, and autopilot schedules. Free. |
| Post an image or video (a |
| Recent Social Hub posts with each account's status and published link. Free. |
| Cancel a draft or scheduled post before it goes out. Free. |
| Queue up to 30 images/videos on an autopilot; each lands in its next free weekly slot. Free. |
| One tool per edit feature, fetched live at startup — e.g. |
If the feature catalog can't be reached at startup, a single generic imageat_edit_image tool
(taking a feature id parameter) is registered instead, so the server still works.
Tool results include both readable text and typed structuredContent. Tool schemas, safety
annotations, and output schemas let agent clients validate calls and distinguish read-only tools.
Related MCP server: pixapi-mcp
Resources and prompts
imageat://account/credits— live prepaid API balance (USD).imageat://edit/features— live edit-feature catalog.imageat://models/imagesandimageat://models/videos— media model catalogs.imageat://generations/recent— ten most recent account generations.create-product-visual— reusable product-image workflow prompt.animate-image— reusable image-to-video workflow prompt.create-social-campaign,generate-and-upscale,create-creative-variants— campaign workflows.
Setup
Create an API key on your ImageAT Projects page (starts with
iat_live_).Add the server to your MCP client config:
{
"mcpServers": {
"imageat": {
"command": "npx",
"args": ["-y", "@imageat/mcp"],
"env": {
"IMAGEAT_API_KEY": "iat_live_xxxxxxxxxxxx"
}
}
}
}Restart the client. The
imageat_*tools will be available.
Environment variables
Var | Required | Default | Notes |
| yes | — | Your |
| no |
| The web app that serves the |
Remote server (claude.ai, ChatGPT, other web clients)
The npx setup above is stdio — it works in desktop apps that launch a local process
(Claude Desktop, Cursor, Claude Code). Browser clients like claude.ai and chatgpt.com
instead connect to a remote MCP endpoint over Streamable HTTP.
The same tools are served over HTTP by dist/http.js. Each MCP session carries the user's
own API key via the Authorization: Bearer iat_live_... header (multi-user), so this is what
you point a hosted connector at.
# Run the remote server locally against a local ImageAT instance:
IMAGEAT_BASE_URL=http://localhost:3000 PORT=8787 npm run start:http
# MCP endpoint: http://localhost:8787/mcp · health: /healthDeploy it (e.g. on Dokploy as mcp.imageat.com) with the included Dockerfile, then add it as
a custom connector:
claude.ai — Settings → Connectors → Add custom connector → URL
https://mcp.imageat.com/mcp.ChatGPT — Connectors / Developer mode → add server URL
https://mcp.imageat.com/mcp.
Browser clients run the OAuth flow: after adding the connector they open a consent page
served by this server where you paste your iat_live_ key, and the client receives a short-lived
access token bound to it. Non-browser clients (mcp-remote, MCP Inspector, curl) can still send
a raw iat_live_ key directly as Authorization: Bearer iat_live_....
The OAuth layer (src/oauth.ts) exposes the
RFC 8414/9728 discovery docs, RFC 7591 dynamic client registration, and PKCE /authorize +
/token. Expiring access and refresh tokens are encrypted with AES-256-GCM under
MCP_OAUTH_SECRET; refresh tokens rotate after use and /revoke invalidates issued tokens. OAuth
tokens are bound to their client ID and requested scope. Idle MCP sessions are reclaimed automatically.
Var | Where | Default | Notes |
| remote only |
| HTTP listen port. |
| both |
| Upstream web app serving |
| remote only | (random per boot) | Long random string that encrypts issued OAuth tokens. Set this in production or tokens are invalidated on every restart. |
| remote only | derived from request | Public origin, e.g. |
| remote only | ChatGPT, Claude, Cursor, VS Code, GitHub, imageat | Comma-separated browser Origin allowlist. Requests without an Origin (normal server-to-server clients) are unaffected. |
| remote only |
| Reclaim MCP sessions idle for this many milliseconds. |
| remote only |
| Reject new sessions with |
| remote only | — | Shared with the web app. Completes "Sign in with imageat" and signs the ChatGPT profile's calls so they bill website credits. |
| remote only | — | Domain verification token from the OpenAI plugin submission, served raw at |
ChatGPT app profile (/chatgpt/mcp)
The published ChatGPT app connects to https://mcp.imageat.com/chatgpt/mcp, not /mcp. It is a
separate, curated profile (src/chatgpt.ts) because OpenAI's directory rules differ from other clients:
Fixed tool list. OpenAI reviews tools and holds new ones for approval, so the profile does not build tools from the live edit-feature catalog. Adding a tool here means it waits for review.
Strict content filter. Upstream calls carry
X-Imageat-Surface: chatgpt, and the web app applies the restricted-account filter to every request (lib/content-restriction.ts).Website credits for every account. ChatGPT users can't buy API balance in the app, so calls signed with
X-Imageat-Surface-Auth(HMAC ofINTERNAL_SERVICE_KEY) spend website credits (lib/api-credit-mode.ts).No purchase prompts. Error text never links to pricing or top-ups.
Attached photos arrive through
openai/fileParamsas{ download_url, file_id }.Results render in a widget (
src/widget.ts, MCP Appsui://imageat/media-v2.html). The widget also pollsimageat_check_video_statusitself while a video renders.
The URL cannot be changed after the app is published without contacting OpenAI support.
OAuth accepts ChatGPT's client ID metadata document (https://chatgpt.com/oauth/client.json),
returns iss on authorization redirects (RFC 9207), and binds tokens to the requested resource.
Local development
npm install
npm run build
# Inspect the stdio server with the official MCP Inspector against a local ImageAT instance:
IMAGEAT_API_KEY=iat_live_... IMAGEAT_BASE_URL=http://localhost:3000 \
npx @modelcontextprotocol/inspector node dist/index.jsSecurity notes
Set a stable, long random MCP_OAUTH_SECRET in production. Browser Origins are restricted by
default; add any self-hosted web client to MCP_ALLOWED_ORIGINS. Direct server-to-server clients
normally omit the Origin header and continue to work with an iat_live_ bearer key.
Available Tools
4 toolsimageat_check_creditsCheck CreditsAInspect
Return the current credit balance for the API key's account.
Inputs: no named parameters.
imageat_edit_imageEdit ImageCInspect
Edit an image using one of ImageAT's edit features. Pass the feature id (e.g. remove-background, object-eraser, relight, virtual-try-on, city-teleport, ai-edit-pro).
Inputs: feature (required), imageUrl (required), prompt, maskUrl, +1 more.
imageat_generate_imageGenerate ImageBInspect
Generate an image from a text prompt (text-to-image), optionally with reference images for image-to-image editing. Returns CDN image URL(s).
Inputs: prompt (required), model, images, numImages, +4 more.
imageat_generate_videoGenerate VideoBInspect
Generate a video from a text prompt (text-to-video) or from a starting image (image-to-video). Returns a CDN mp4 URL.
Inputs: prompt (required), model, duration, imageUrl, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
check_credits is clearly distinct. edit_image and generate_image could overlap, since generate_image supports reference images for image-to-image editing, but descriptions clarify that generate is text-prompt driven while edit uses specific feature IDs. Overall, boundaries are mostly clear.
All tools follow a consistent snake_case verb_noun pattern with the imageat_ prefix: check_credits, edit_image, generate_image, generate_video. The naming is predictable and uniform.
Four tools cover the core actions for an image/video generation and editing API: credit checking, image generation, image editing, and video generation. This is appropriately scoped with no redundancy.
The server covers the primary workflows: generating images and videos, editing images, and checking credits. A minor gap is the lack of a way to list available edit features, but agents can likely infer them from the documentation provided in the tool description.
Maintenance
Related MCP Connectors
Generate images with any major model — one API key, one prepaid balance, one MCP.
MCP server for Pixapi: check live credit pricing and balance, then generate images and video.
Image generation, image editing and text/image-to-video with credit quotes and connection budgets.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables MCP-compatible clients to generate and upscale AI images, videos, music, and sound effects, manage generation jobs, access model catalogs, and track credits.3MIT

pixapi-mcpofficial
AlicenseNot gradedqualityCmaintenanceEnables MCP clients to use Pixapi's AI image and video generation tools, including checking pricing and balance, starting asynchronous generation tasks, and retrieving results.54 npmMIT- AlicenseNot gradedqualityBmaintenanceEnables image and video generation and editing through MCP tools, including image editing, upscaling, background removal, video generation, image-to-video, and video extension. Video generation runs asynchronously with job status and result retrieval.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to generate and edit text, images, speech, music, and video, list available models, and track usage costs through a single remote MCP endpoint billed against one prepaid credit balance.MIT