Imaginum Studio · AI agents

Build media into your project with MCP.

Imaginum Studio gives an AI coding agent access to image, video and audio generation through the Model Context Protocol. Create a token in your profile, connect the MCP server, and let the agent create and download media into the project.

Never hotlink studio media. Generated media is private and retained for 30 days. Always download finished files into the project with the download URL returned by the MCP tools.

1. Create a token

Open your Imaginum Studio profile and choose AI access. Create a token with a name, an optional monthly credit budget and an expiry date. If MFA is enabled, verify it first.

The token is shown once. Copy it immediately. The profile only keeps its prefix.

A monthly budget limits how many credits this token can use in a calendar month (Europe/Helsinki). If you leave the budget empty, the token can use available account credits. We recommend setting a budget.

2. Connect the MCP server

Endpoint:

https://mcp.imaginum.studio

Use the token as a bearer token:

{
  "mcpServers": {
    "imaginum": {
      "type": "http",
      "url": "https://mcp.imaginum.studio",
      "headers": {
        "Authorization": "Bearer imgn_..."
      }
    }
  }
}

3. Tools

ToolWhat it does
list_modelsList public image, video and audio models and voices.
get_creditsRead the available credit balance.
generate_imageCreate images from a prompt. Returns saved asset IDs.
edit_imageEdit one or more owned image assets.
generate_videoStart a video generation job and return a job ID.
generate_speechCreate a spoken audio version from a script.
generate_musicCreate music from sections.
generate_sfxCreate a sound effect.
get_jobRead an image, video or audio job result.
list_assetsList owned media from the last 30 days.
get_download_urlCreate a short-lived download URL for an owned asset.
upload_media_from_urlSave an image URL as a private upload for references.

4. Image example

Ask the agent to generate a wide image and save it into the project:

Generate a 16:9 image for the website hero with a calm Nordic
coastal landscape. Save the result in public/images/hero.webp.

The agent should call generate_image, then get_download_url with the returned asset ID, download the file and place it in the project.

5. Video and audio

Video and audio generation is asynchronous. The generation tool returns a job ID. Call get_job with the same kind (image, video or audio) until the job is finished. Then download the asset into the project.

6. Retention and downloads

All created media follows the same 30-day retention as the rest of the studio. Download URLs expire after 15 minutes. If a file is still needed after a month, it must already be stored in the project.

Do not embed, hotlink or proxy an Imaginum media URL in a website. Only local project files should be referenced by the final site.

7. Limits

Open your profile · Imaginum Studio