Skip to main content
Glama

@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

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.

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/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.

Setup

  1. Create an API key on your ImageAT Projects page (starts with iat_live_).

  2. Add the server to your MCP client config:

{
  "mcpServers": {
    "imageat": {
      "command": "npx",
      "args": ["-y", "@imageat/mcp"],
      "env": {
        "IMAGEAT_API_KEY": "iat_live_xxxxxxxxxxxx"
      }
    }
  }
}
  1. Restart the client. The imageat_* tools will be available.

Environment variables

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.

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: /health

Deploy 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

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 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 of INTERNAL_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/fileParams as { download_url, file_id }.

  • Results render in a widget (src/widget.ts, MCP Apps ui://imageat/media-v2.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.

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.js

Security 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 tools
imageat_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

    A3.6/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers