
Official MCP server for imageat — AI image and video generation for AI assistants. Generate images
Official MCP server for imageat — AI image and video generation for AI assistants. Generate images and videos, and use 20+ editing tools (background remove/replace, inpainting, object eraser, relight, virtual try-on) directly from Claude, ChatGPT, Cursor, or any MCP-compatible client.
·
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.
| Tool | What it does |
|---|---|
imageat_generate_image | Text-to-image / image-to-image. Returns CDN image URL(s). |
imageat_generate_video | Text-to-video / image-to-video. Returns a CDN mp4 URL. |
imageat_generate_video_task | Experimental MCP Tasks version with tasks/get and tasks/result. |
imageat_check_video_status | Checks an asynchronous video generation until it completes. |
imageat_ask_gemini_argon | Ask Google's Gemini 4 Argon (optional image URLs, Google Search / Maps grounding). Returns the text answer. |
imageat_check_credits | Current prepaid API balance (USD). |
ai_visibility_check | 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. |
imageat_game_guide | Start here for a playable browser game: workflow, runtime rules and the kit API (Phaser 2D / three.js 3D). Free. |
imageat_search_game_models | Search 2,700+ game-ready 3D library models; returns library_keys with animations. Free. |
imageat_generate_game_asset | One game asset: sprite, background, texture, logo, or an AI-made 3D hero_model. Returns an asset_id. |
imageat_publish_game | Checks your game code, bundles it with the engine and assets, and returns a shareable play link. |
imageat_update_game | Publishes new code for one of your games as a new version (same link). Free. |
imageat_social_list_accounts | Social accounts connected in imageat Social Hub (Instagram, Facebook Pages, LinkedIn, X…), whether each can post now, and autopilot schedules. Free. |
imageat_social_create_post | Post an image or video (a generation_id or media_url) to connected accounts: draft (default), schedule, or publish now; per-account captions. No credits; needs an imageat plan. |
imageat_social_list_posts | Recent Social Hub posts with each account's status and published link. Free. |
imageat_social_cancel_post | Cancel a draft or scheduled post before it goes out. Free. |
imageat_social_queue_autopilot | Queue up to 30 images/videos on an autopilot; each lands in its next free weekly slot. Free. |
imageat_edit_<feature> | One tool per edit feature, fetched live at startup — e.g. imageat_edit_remove-background, imageat_edit_object-eraser, imageat_edit_relight, imageat_edit_virtual-try-on, imageat_edit_city-teleport, imageat_edit_ai-edit-pro. New features appear automatically. |
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.
imageat://account/credits — live prepaid API balance (USD).imageat://edit/features — live edit-feature catalog.imageat://models/images and imageat://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.iat_live_).{
"mcpServers": {
"imageat": {
"command": "npx",
"args": ["-y", "@imageat/mcp"],
"env": {
"IMAGEAT_API_KEY": "iat_live_xxxxxxxxxxxx"
}
}
}
}imageat_* tools will be available.| Var | Required | Default | Notes |
|---|---|---|---|
IMAGEAT_API_KEY | yes | — | Your iat_live_ key. |
IMAGEAT_BASE_URL | no | https://imageat.com | The web app that serves the /api/v1/* generation endpoints. Point at http://localhost:3000 for local dev. |
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:
https://mcp.imageat.com/mcp.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 |
|---|---|---|---|
PORT | remote only | 8787 | HTTP listen port. |
IMAGEAT_BASE_URL | both | https://imageat.com | Upstream web app serving /api/v1/*. |
MCP_OAUTH_SECRET | remote only | (random per boot) | Long random string that encrypts issued OAuth tokens. Set this in production or tokens are invalidated on every restart. |
MCP_PUBLIC_URL | remote only | derived from request | Public origin, e.g. https://mcp.imageat.com. Only needed if proxy headers are wrong. |
MCP_ALLOWED_ORIGINS | 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. |
MCP_SESSION_IDLE_MS | remote only | 7200000 | Reclaim MCP sessions idle for this many milliseconds. |
MCP_MAX_SESSIONS | remote only | 500 | Reject new sessions with 503/Retry-After after this process reaches capacity. |
INTERNAL_SERVICE_KEY | remote only | — | Shared with the web app. Completes "Sign in with imageat" and signs the ChatGPT profile's calls so they bill website credits. |
OPENAI_APPS_CHALLENGE | remote only | — | Domain verification token from the OpenAI plugin submission, served raw at /.well-known/openai-apps-challenge. |
/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:
X-Imageat-Surface: chatgpt, and the web app
applies the restricted-account filter to every request (lib/content-restriction.ts).X-Imageat-Surface-Auth (HMAC of INTERNAL_SERVICE_KEY) spend website credits
(lib/api-credit-mode.ts).openai/fileParams as { download_url, file_id }.src/widget.ts, MCP Apps ui://imageat/media-v1.html). The widget
also polls imageat_check_video_status itself 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.
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.jsSet 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.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add imageat -- npx -y @imageat/mcp{
"mcpServers": {
"imageat": {
"env": {
"IMAGEAT_API_KEY": ""
},
"args": [
"-y",
"@imageat/mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"imageat","env":{"IMAGEAT_API_KEY":""},"args":["-y","@imageat/mcp"],"command":"npx"}'[mcp_servers.imageat]
command = "npx"
args = ["-y", "@imageat/mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/imageat-mcp to learn what the "@imageat/mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx @modelcontextprotocol/inspector node dist/index.jsThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/imageat-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "imageat-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.