Make images and video in Claude with MagicShot

Add MagicShot to Claude once, then just ask. No key to paste: you sign in to MagicShot and it runs on your credits.

Paste this into Claude Code with your API key, then just ask.

terminal

claude mcp add --transport http magicshot https://mcp.magicshot.ai/mcp \
  --header "Authorization: Bearer msk_YOUR_KEY"

Run it once in your terminal. That is the whole setup.

Get your API key How to connect?

Paste this into Cursor with your API key, then just ask.

~/.cursor/mcp.json

{
  "mcpServers": {
    "magicshot": {
      "url": "https://mcp.magicshot.ai/mcp",
      "headers": { "Authorization": "Bearer msk_YOUR_KEY" }
    }
  }
}

Add to your global mcp.json, or a per-project .cursor/mcp.json.

Get your API key How to connect?

Paste this into VS Code with your API key, then just ask.

.vscode/mcp.json

{
  "servers": {
    "magicshot": {
      "type": "http",
      "url": "https://mcp.magicshot.ai/mcp",
      "headers": { "Authorization": "Bearer msk_YOUR_KEY" }
    }
  }
}

Note the servers key and "type": "http".

Get your API key How to connect?

Paste this into Codex with your API key, then just ask.

~/.codex/config.toml

[mcp_servers.magicshot]
url = "https://mcp.magicshot.ai/mcp"
http_headers = { "Authorization" = "Bearer msk_YOUR_KEY" }

Streamable HTTP. On older Codex versions, add experimental_use_rmcp_client = true at the top of the file.

Get your API key How to connect?

Paste this into Windsurf with your API key, then just ask.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "magicshot": {
      "serverUrl": "https://mcp.magicshot.ai/mcp",
      "headers": { "Authorization": "Bearer msk_YOUR_KEY" }
    }
  }
}

Same idea as Cursor, but the key is called serverUrl.

Get your API key How to connect?

Paste this into Claude Desktop with your API key, then just ask.

claude_desktop_config.json

{
  "mcpServers": {
    "magicshot": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.magicshot.ai/mcp",
               "--header", "Authorization: Bearer msk_YOUR_KEY"]
    }
  }
}

Connected MagicShot on claude.ai already? It shows up in the desktop app too, no config needed. Otherwise bridge it with mcp-remote so your key is passed through.

Get your API key How to connect?

Paste this into your MCP client with your API key, then just ask.

the essentials

# transport  Streamable HTTP (POST + SSE)
# url        https://mcp.magicshot.ai/mcp
# auth       Authorization: Bearer msk_YOUR_KEY
# tools      suggest, search_tools, list_models,
#            text_to_image, text_to_video, image_to_video,
#            run_tool, get_job_status, get_credits

Anything that speaks MCP and lets you set a URL and an Authorization header.

Get your API key How to connect?

https://mcp.magicshot.ai/mcp

How to connect

Connect MagicShot to Claude in under two minutes.

Sign in to Claude
Open claude.ai in your browser and sign in to your account.
Open claude.ai
Add MagicShot as a connector
Press Connect MagicShot, or go to Customize, Connectors, Add custom connector, name it MagicShot and paste the endpoint. Then sign in to MagicShot when Claude asks.
Add MagicShot to Claude
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

Get your API key
Sign in to MagicShot and create a key under API Keys. It looks like msk_ followed by letters and numbers.
Create a key
Paste it into Claude Code
Copy the command above, swap msk_YOUR_KEY for your key, and run it.
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

Get your API key
Sign in to MagicShot and create a key under API Keys. It looks like msk_ followed by letters and numbers.
Create a key
Paste it into Cursor
Copy the config above into ~/.cursor/mcp.json and swap msk_YOUR_KEY for your key.
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

Get your API key
Sign in to MagicShot and create a key under API Keys. It looks like msk_ followed by letters and numbers.
Create a key
Paste it into VS Code
Copy the config above into .vscode/mcp.json and swap msk_YOUR_KEY for your key.
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

Get your API key
Sign in to MagicShot and create a key under API Keys. It looks like msk_ followed by letters and numbers.
Create a key
Paste it into Codex
Copy the config above into ~/.codex/config.toml and swap msk_YOUR_KEY for your key.
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

Get your API key
Sign in to MagicShot and create a key under API Keys. It looks like msk_ followed by letters and numbers.
Create a key
Paste it into Windsurf
Copy the config above into ~/.codeium/windsurf/mcp_config.json and swap msk_YOUR_KEY for your key.
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

Get your API key
Sign in to MagicShot and create a key under API Keys. It looks like msk_ followed by letters and numbers.
Create a key
Paste it into Claude Desktop
Copy the config above into claude_desktop_config.json and swap msk_YOUR_KEY for your key.
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

Get your API key
Sign in to MagicShot and create a key under API Keys. It looks like msk_ followed by letters and numbers.
Create a key
Add the server to your client
Point it at the endpoint over Streamable HTTP and send your key as Authorization: Bearer msk_YOUR_KEY.
Ask for an image or a video
Describe what you want in plain words. Your assistant picks the tool, runs it on your credits and hands back the result.

MagicShot

What your assistant can do once connected

Nine tools, one connection. Your assistant chooses between them; you just say what you want.

Generate images
Turn a prompt into finished images.
text_to_image
Generate videos
Turn a description into a clip.
text_to_video
Animate a still
Bring a photo to life with motion.
image_to_video
Run any tool
Background removal, upscaling, headshots and the rest of the catalog.
run_tool
Find the right tool
Search every MagicShot tool by what you need.
search_tools
Get a recommendation
The best tool and model for your goal.
suggest
Browse the models
Every model, with its ratios, durations and inputs.
list_models
Track a job
Follow a generation to the finish.
get_job_status
Check your balance
See the credits you have left, anytime.
get_credits

Things you can just ask for

Pick a prompt to preview what your assistant sends back.

Your AI assistant

A cinematic sunset over a mountain lake, 16:9

Using MagicShot · text_to_image

The result comes back as a link, ready to download or drop into your project.

The latest models, all through one endpoint

Every model

GPT Image 2.5 Flare

Featured

Open AI · Image

GPT Image 2.5 Flare is OpenAI's fast image generation and editing model, available inside MagicShot on a paid plan. It turns a text prompt or a reference photo into a new image, keeping the face, product, or layout you started with intact.

GPT Image 2.5 Sunburst

Featured

Open AI · Image

GPT Image 2.5 Sunburst is OpenAI's precision image model, built to generate and edit images from text prompts and reference photos. It is the heavier of the two GPT Image 2.5 models, trading a longer generation time for sharper detail and tighter edit control.

FLUX 3 Image

Featured

Black Forest Labs · Image

FLUX 3 Image is Black Forest Labs' layout-aware image model, trained to understand where each element of a scene belongs. Inside MagicShot, it generates images from a text prompt and edits photos from up to 9 uploads, changing what you name and leaving the rest alone.

Ideogram 4.5

Featured

Ideogram · Image

Ideogram 4.5 is Ideogram's precision image editing model, built to change what you ask for while keeping shape, texture and color steady from one edit to the next. Inside MagicShot, it edits photos in Image Editing from up to 4 uploads.

Nano Banana 2.1

Featured

Google · Image

Nano Banana 2.1 is Google's image generation and editing model, built on Gemini 3.6 Flash for fast, precise edits. Inside MagicShot, it generates images from a text prompt and edits photos from up to 14 uploads, with an edit usually taking about 5 seconds.

MiniMax H3

Featured

MiniMax · Video

MiniMax H3 is an omni-modal video model built by MiniMax that reads text, images, video, and audio together and turns them into finished video clips. On MagicShot, it works as a text-to-video and image-to-video engine that renders motion, on-screen text, and native stereo sound in a single generation.

What is MCP, without the jargon

MCP is a universal adapter for AI assistants. Plug MagicShot in once and your assistant gains a new skill: making images and video, and running MagicShot tools on your pictures, right inside the chat.

No code
One click in Claude, or a one-time paste in your editor.
Same credits
Runs on the MagicShot plan you already have.
Plain words
Ask the way you would ask a person. It handles the rest.

MCP questions, answered

MCP (Model Context Protocol) is an open standard that lets an AI assistant use outside tools. Connecting MagicShot gives your assistant new abilities: making images and video, running MagicShot tools on your pictures, following a job and reading your credit balance. You keep chatting like normal; it just can do more.

Press Connect MagicShot on this page while signed in to claude.ai. Claude opens its add connector screen with MagicShot filled in; confirm it and sign in to MagicShot. You can also add it by hand under Customize, Connectors, Add custom connector, using the endpoint shown above.

Claude on the web and desktop through the connector, plus any MCP client that supports remote servers with a custom header: Claude Code, Codex, Cursor, Windsurf and VS Code among them.

For Claude, no: you sign in to MagicShot when you add the connector. For editors and command line tools, yes: create one in your MagicShot dashboard under API Keys and paste it into the config as a Bearer token. Keep it secret, since anyone holding the key can spend your credits. You can revoke and rotate keys anytime.

Generations made over MCP spend the same credit pool as the MagicShot app, on the plan you already have. There is no separate charge for using the server.

You do not have to choose. Describe your goal and your assistant calls suggest or search_tools to find the right one, then list_models for its options.

Generate without leaving your assistant

Connect MagicShot to Claude in one click, or paste one config into your editor.

Get started

Make images and video in Claude with MagicShot

How to connect

Sign in to Claude

Add MagicShot as a connector

Ask for an image or a video

Get your API key

Paste it into Claude Code

Ask for an image or a video

Get your API key

Paste it into Cursor

Ask for an image or a video

Get your API key

Paste it into VS Code

Ask for an image or a video

Get your API key

Paste it into Codex

Ask for an image or a video

Get your API key

Paste it into Windsurf

Ask for an image or a video

Get your API key

Paste it into Claude Desktop

Ask for an image or a video

Get your API key

Add the server to your client

Ask for an image or a video

What your assistant can do once connected

Generate images

Generate videos

Animate a still

Run any tool

Find the right tool

Get a recommendation

Browse the models

Track a job

Check your balance

Things you can just ask for

The latest models, all through one endpoint

GPT Image 2.5 Flare

GPT Image 2.5 Sunburst

FLUX 3 Image

Ideogram 4.5

Nano Banana 2.1

MiniMax H3

What is MCP, without the jargon

No code

Same credits

Plain words

MCP questions, answered

What is MCP, in plain terms?

How do I add MagicShot to Claude?

Which apps can I connect?

Do I need an API key?

How is this billed?

Which tool or model should I use?

Generate without leaving your assistant