Skip to content
PlaygroundDocsGet API key

Mage for Claude Code

Generate images, video, and audio in Claude Code

Connect Mage to Claude Code in your terminal and editor, then ask for images, video, and audio in plain words. Claude Code picks the model, quotes the price, and brings back the result.

Open MCP setup on Mage
https://mcp.mage.space/mcp

At a glance

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

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

Setup

How to connect Mage to Claude Code

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

  1. Add the server

    Run this command in your terminal.

    claude mcp add --transport http mage https://mcp.mage.space/mcp

  2. Authenticate

    In Claude Code, run /mcp, choose mage, and authenticate. A browser page opens for you to sign in to Mage and select Connect.

  3. Or use an API key

    To skip the browser sign-in, add the server with your key in a header instead.

    claude mcp add --transport http mage https://mcp.mage.space/mcp \
  --header "Authorization: Bearer $MAGE_API_KEY"

Try it

Example prompts for Mage in Claude Code

  • Generate a 1200×630 Open Graph image for this blog post and save it to public/og.png.
  • Make hero illustrations for the three landing page sections in our brand colors.
  • Upload assets/demo.mp4 and restyle it as a watercolor animation.
  • Create a looping 5-second background video for the homepage.

Tools

16 tools your assistant can call

ToolWhat it does
list_modelsLists the recommended models with prices, what each is best for, and its trade-offs.
get_modelDescribes one model's fields, allowed values, defaults, rules, and price.
estimate_costPrices a generation before it starts. Nothing is charged.
create_uploadGets a signed link to upload a local file, for assistants that can run commands.
generateStarts an image, video, or audio generation.
get_requestWaits for a generation to finish and returns the result link.
cancel_requestStops a running generation.
get_accountShows the connected account and its Gems balance.
list_charactersLists your saved characters and their @handles.
create_characterSaves a private character from an image, optionally with a voice.
delete_characterDeletes one of your characters.
list_referencesLists your saved outfits, poses, locations, objects, and voice clips.
create_referenceSaves a private reference from an image or audio link.
delete_referenceDeletes one of your references.
list_historyLists your generations from the last 30 days, including ones made in the app.
search_creationsSearches 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 Grok

    Generate images, video, and audio in Grok as a custom connector.

  • Mage in Cursor

    Generate images, video, and audio in Cursor Agent mode.

FAQ

Frequently asked questions

Can Claude Code generate images for my project?
Yes. With the Mage MCP server, Claude Code can generate images, video, and audio, then download results into your repository. It can also upload files from your project with create_upload, such as a clip to edit.
Should I use OAuth or an API key with Claude Code?
Either works. OAuth signs in through the browser and needs no secret in your shell. An API key suits CI and headless machines; pass it as an Authorization: Bearer header.
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, and the account needs one successful payment first, any Gem pack or plan; signup bonus Gems work in the Mage app only. 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 4, 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.

Open MCP setup on Mage