Mage MCP · Your imagination, connected
Generate images, video, and audio from any AI assistant
The Mage MCP server connects Claude, ChatGPT, Claude Code, Grok, and Cursor to every Mage model. Ask in plain words; your assistant picks the model, quotes the price, and brings back the result.
https://mcp.mage.space/mcpAt 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 4, video with Cherry 2 Pro, and audio with Seed Audio, plus 32 more models, paid per generation in Gems.
- 16MCP tools
- 35Image, video & audio models
- 5Supported assistants
- $0To 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 4, 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 3 Turbo and Cherry Mini for cheaper drafts, Lemon for first and last frames, Guava for photoreal portraits, and GPT Image 2.6 Flare for text in images and animated GIFs. Every other model in the 35-model catalog runs when you ask for it by name.
Built in
More than a generate button
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.
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?
Do I need an API key to use the MCP server?
How much does it cost?
Which models does my assistant use?
Is it safe to connect my Mage account?
Which AI assistants work with the Mage MCP server?
What is the difference between the MCP server and the API?
Start building with Mage
One account, one Gems balance, every model. Pay only for what you generate.