AI Media Studio/ Docs
GitHubGet API key
API ReferenceCLIMCPSkills
MCP Server

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/mcp

In 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/mcp

Instructions for every client: ai-media-studio.com/agent. The local server below works with an API key instead.

1

Get your API key

Create a key in AI Media Studio under Workspace Settings → API. It starts with aims_.

2

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/mcp
3

Or 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_..." }
    }
  }
}
4

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

ToolWhat it does
upload_imageUpload supplied base64 raster-image contents, up to 20 MiB, using media:write; returns its workspace URL
generate_imageText-to-image (and image-to-image via image_urls)
edit_imageImage-to-image editing from source URL(s)
generate_videoText-to-video and image-to-video
list_modelsDiscover available models and credit costs (read-only, returns JSON)
get_accountWorkspace id, credit balance, and scopes (read-only, returns JSON)
Generate images and videos with AI agents. liebhardt-io/aims-agent