Your characters and references
Mention a saved character or reference by @handle, for example "a portrait of @ana wearing @red-coat", and your assistant passes it to the model.
At a glance
Mage runs a remote MCP server at https://mcp.mage.space/mcp. Add it to Claude, ChatGPT, Claude Code, Grok, or Cursor, sign in with your Mage account, and your assistant can generate images with Mango 3, video with Cherry 2 Pro, and audio with Seed Audio, plus 25 more models, paid per generation in Gems.
16
MCP tools
28
Image, video & audio models
5
Supported assistants
$0
To connect
Connect
Pick your assistant
Each guide walks through setup in that app, with example prompts.
Mage in Claude
Generate images, video, and audio in Claude on the web, the desktop app, the mobile apps, and Cowork.
Mage in ChatGPT
Generate images, video, and audio in ChatGPT as a personal MCP app.
Mage in Claude Code
Generate images, video, and audio in Claude Code in your terminal and editor.
Mage in Grok
Generate images, video, and audio in Grok as a custom connector.
Mage in Cursor
Generate images, video, and audio in Cursor Agent mode.
How it works
From a sentence to a finished file
You ask
Describe what you want: "a 5-second clip of this product spinning on a marble table".
Your assistant plans
It reads the model guide with list_models and get_model, then quotes the price with estimate_cost.
Mage generates
generate starts the job on your account and get_request waits for it, then returns a link to the image, video, or audio.
Tools
16 tools your assistant can call
| Tool | What it does |
|---|---|
| list_models | Lists the recommended models with prices, what each is best for, and its trade-offs. |
| get_model | Describes one model's fields, allowed values, defaults, rules, and price. |
| estimate_cost | Prices a generation before it starts. Nothing is charged. |
| create_upload | Gets a signed link to upload a local file, for assistants that can run commands. |
| generate | Starts an image, video, or audio generation. |
| get_request | Waits for a generation to finish and returns the result link. |
| cancel_request | Stops a running generation. |
| get_account | Shows the connected account and its Gems balance. |
| list_characters | Lists your saved characters and their @handles. |
| create_character | Saves a private character from an image, optionally with a voice. |
| delete_character | Deletes one of your characters. |
| list_references | Lists your saved outfits, poses, locations, objects, and voice clips. |
| create_reference | Saves a private reference from an image or audio link. |
| delete_reference | Deletes one of your references. |
| list_history | Lists your generations from the last 30 days, including ones made in the app. |
| search_creations | Searches your saved creations by what they show, collection, or date. |
Models
Smart defaults, every model on request
Unless you name a model, your assistant makes images with Mango 3, video with Cherry 2 Pro, and audio with Seed Audio, and tells you the model and price before it starts.
The model guide also recommends Mango 3S and Cherry Mini for cheaper drafts, Lemon for first and last frames, Guava for photoreal portraits, and GPT Image 2.5 Flare for text in images. Every other model in the 28-model catalog runs when you ask for it by name.
Built in
More than a generate button
Your history
list_history and search_creations reach everything you made in the last 30 days and everything you saved, including work from the Mage app.
Prices before spending
estimate_cost prices any generation for free, so your assistant can confirm before it spends Gems.
Local files
Assistants that run commands, like Claude Code and Cursor, can upload files from your machine with create_upload.
OAuth, no secrets
Sign in with Mage and approve the app. No key to paste, and you can disconnect at any time.
Same account, same balance
Everything runs on your Mage account and Gems balance, alongside the app and the REST API.
FAQ
Frequently asked questions
What is the Mage MCP server?
A remote Model Context Protocol server at https://mcp.mage.space/mcp that lets AI assistants generate images, video, and audio on your Mage account. It gives the assistant 16 tools to pick a model, quote the price, generate, wait for the result, and use your saved characters, references, and history.
Do I need an API key to use the MCP server?
No. Claude, ChatGPT, Grok, Cursor, and Claude Code connect by signing in to Mage through OAuth. An API key is optional, for headless setups such as CI.
How much does it cost?
Connecting is free. Each generation your assistant starts is paid in Gems from your Mage account at the model’s listed price, and your assistant can quote the price with estimate_cost before it starts.
Which models does my assistant use?
Unless you name a model, your assistant makes images with Mango 3, video with Cherry 2 Pro, and audio with Seed Audio. You can ask for any other Mage model by name.
Is it safe to connect my Mage account?
Mage shows the app’s name, its site, and where you return before anything is shared, and you approve each connection. Disconnect any app at any time from MCP → Connected apps.
Which AI assistants work with the Mage MCP server?
Claude (web, desktop, mobile, and Cowork), ChatGPT, Claude Code, Grok, and Cursor have step-by-step guides. Other clients can connect if they support remote Streamable HTTP servers and either OAuth with client ID metadata documents or a Bearer API key header.
What is the difference between the MCP server and the API?
The MCP server is for AI assistants: they call tools in conversation. The REST API is for your own code: you send HTTP requests. Both run the same models on the same account and Gems balance.
Start building with Mage
One account, one Gems balance, every model. Pay only for what you generate.