Mage for Cursor

Generate images, video, and audio in Cursor

Connect Mage to Cursor Agent mode, then ask for images, video, and audio in plain words. Cursor picks the model, quotes the price, and brings back the result.

Add Mage to Cursor Open MCP setup on Mage

https://mcp.mage.space/mcp

At a glance

To use Mage in Cursor, add the Mage MCP server (https://mcp.mage.space/mcp) and sign in with your Mage account. Cursor can then generate images with Mango 3, video with Cherry 2 Pro, audio with Seed Audio, or any of 28 Mage models you name, paid per generation in Gems.

16
MCP tools
28
Image, video & audio models
5
Supported assistants
$0
To connect

Setup

How to connect Mage to Cursor

A Mage account is required; a guest session cannot connect an app.

Install with one click
Select "Add Mage to Cursor" to install the server with its public OAuth client ID. If Mage is already installed, replace its configuration.

Or add it to mcp.json

For manual setup, add this entry to ~/.cursor/mcp.json. The client ID is public and needs no secret.

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/mcp",
        "scopes": [
          "mage",
          "offline_access"
        ]
      }
    }
  }
}

Sign in and ask
Authenticate with your Mage account when prompted, then ask Cursor in Agent mode to generate media for your project.

Try it

Example prompts for Mage in Cursor

Generate placeholder product photos for the seed data and save them to /public/products.
Make an app icon in three styles and add them to the design folder.
Create a short onboarding video for the empty state.

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.

More assistants

Mage works in every major AI assistant

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.

FAQ

Frequently asked questions

Can I use an API key with Cursor instead of OAuth?

Yes. Set the server entry to the URL with headers: { "Authorization": "Bearer ${env:MAGE_API_KEY}" } and keep the key in your environment.

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.

Start building with Mage

One account, one Gems balance, every model. Pay only for what you generate.