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.
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
| Tool | What it does |
|---|---|
list_models | List public image, video and audio models and voices. |
get_credits | Read the available credit balance. |
generate_image | Create images from a prompt. Returns saved asset IDs. |
edit_image | Edit one or more owned image assets. |
generate_video | Start a video generation job and return a job ID. |
generate_speech | Create a spoken audio version from a script. |
generate_music | Create music from sections. |
generate_sfx | Create a sound effect. |
get_job | Read an image, video or audio job result. |
list_assets | List owned media from the last 30 days. |
get_download_url | Create a short-lived download URL for an owned asset. |
upload_media_from_url | Save 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
- Tokens are user-facing only. They cannot access admin or developer features.
- Tokens cannot see non-public models.
- Requests consume the same credits as the studio.
- The monthly budget is a token limit, not a separate credit balance.
- Revoke a token immediately if it leaks.