Generate media right from your chat
Add the AI Media Studio MCP server to Claude, ChatGPT, Claude Code, Cursor, Codex, or VS Code and create images and videos without leaving your agent.
Fastest: hosted server, no API key
Add this URL to any client that supports remote MCP servers, then sign in and pick a workspace. The connection appears under Workspace Settings → API, where you can revoke it.
https://app.ai-media-studio.com/mcpIn Claude Code, add it and then run /mcp to sign in:
claude mcp add --transport http --scope user aims https://app.ai-media-studio.com/mcpInstructions for every client: ai-media-studio.com/agent. The local server below works with an API key instead.
Get your API key
Create a key in AI Media Studio under Workspace Settings → API. It starts with aims_.
Register the server (Claude Code)
One command registers the stdio MCP server for every project; start a new Claude Code session afterwards.
claude mcp add aims --scope user \
-e AIMS_API_KEY=aims_... \
-- npx -y @ai-media-studio/mcpOr configure manually
For Claude Desktop, Cursor, Codex, or a project .mcp.json:
{
"mcpServers": {
"aims": {
"command": "npx",
"args": ["-y", "@ai-media-studio/mcp"],
"env": { "AIMS_API_KEY": "aims_..." }
}
}
}Generate
Just ask in natural language:
Use aims to generate a 16:9 image of a red panda
astronaut, then make a 6-second video panning across it.For supplied image contents, call upload_image with raw image_base64 and an optional filename. For local files, run aims upload and use its returned URL in edit_image or generate_video. MCP uploads read no local files and require the media:write scope. Raster signatures are checked before upload. Failed or partial image batches return isError with all image results and completed URLs preserved.
Available tools
| Tool | What it does |
|---|---|
upload_image | Upload supplied base64 raster-image contents, up to 20 MiB, using media:write; returns its workspace URL |
generate_image | Text-to-image (and image-to-image via image_urls) |
edit_image | Image-to-image editing from source URL(s) |
generate_video | Text-to-video and image-to-video |
list_models | Discover available models and credit costs (read-only, returns JSON) |
get_account | Workspace id, credit balance, and scopes (read-only, returns JSON) |