FOR AI AGENTS AND DEVELOPERS

Product videos, on demand, from any AI assistant.

Imaginou exposes its whole studio through a public Model Context Protocol (MCP) server and a REST API. An agent can turn a product link or a few photos into a reviewed storyboard and a finished vertical product video, then share it — all inside the seller's own account.

https://app.imaginou.com/mcp

Streamable HTTP · OAuth 2.1 with PKCE · dynamic client registration · per-account scopes

WHAT AN AGENT CAN MAKE

Product showroom showroom
Three distinct silent showroom clips: silhouette and fit, an evidenced interaction, and hero material close-ups. Best for marketplaces, product pages and ads that need clean footage without speech.
Influencer introduction influencer
One three-scene presenter campaign: a consistent AI presenter shows the product, speaks real dialogue grounded in the imported facts, with captions and two instrumental music options.
Unexpected campaign viral
One three-scene comedic campaign: an impossible opening, a verified benefit, and a happy surprise. Designed to stop the scroll while keeping product claims honest.

CONNECT IN ONE MINUTE

Add Imaginou to your AI client.

Claude (web, desktop, mobile)

Settings → Connectors → Add custom connector → paste the URL. Sign in with your Imaginou email code and allow access.

https://app.imaginou.com/mcp

Claude Code

One command, then /mcp to authenticate.

claude mcp add --transport http imaginou https://app.imaginou.com/mcp

ChatGPT

Settings → Connectors → Create (developer mode). Authentication: OAuth. ChatGPT registers itself and opens the Imaginou sign-in.

https://app.imaginou.com/mcp

Cursor · VS Code · Windsurf · Gemini CLI · Codex

Add to mcp.json (or the client's MCP settings). The client discovers OAuth from the 401 challenge.

{
  "mcpServers": {
    "imaginou": {
      "type": "http",
      "url": "https://app.imaginou.com/mcp"
    }
  }
}

Stdio-only hosts

Bridge with mcp-remote; it handles the OAuth round-trip locally.

npx -y mcp-remote https://app.imaginou.com/mcp

Scripts and automations

Create an API key under Connect AI and send it as a bearer token to MCP or REST.

curl -H "Authorization: Bearer imk_…" \
  https://app.imaginou.com/api/v1/me

MCP TOOLS

Every step of a production, as a tool.

The server also publishes resources (imaginou://capabilities, imaginou://playbook, imaginou://productions/{id}) and prompts (make_product_video, review_storyboard, plan_launch_content). Tool annotations mark which calls spend credits.

Tool	What it does
`get_capabilities`	Workflows, languages, lifecycle, prices and limits.
`get_account`	Signed-in seller, credits, storage, productions needing a decision.
`get_credits`	Remaining order credits and packs.
`create_checkout_link`	Stripe Checkout link for a credit pack (no charge until the person pays).
`list_productions`	All productions with state and next step.
`get_production`	Verified product facts, storyboard, dialogue, findings, video QA, music options.
`wait_for_production`	Long-poll until a decision is needed.
`create_production`	Start a showroom, influencer or unexpected-campaign film from a link or photos.
`view_storyboard_images`	See the six storyboard frames as images to judge fidelity.
`approve_storyboard`	Approve frames and dialogue; queue the three videos.
`request_storyboard_changes`	Regenerate chosen scenes with precise corrections.
`review_video`	Approve or reject the generated video.
`choose_music`	Pick instrumental option A, B or none.
`edit_video`	Re-edit pacing, sound accents and polished on-screen text.
`complete_production`	Mark complete after the final playback review.
`retry_production`	Authorize resuming a failed step.
`run_quality_check`	Re-run the continuity check on saved footage.
`cancel_production`	Cancel a waiting production.
`remove_production`	Archive a finished or failed production.
`restore_production`	Bring a removed production back.
`list_media`	Images, videos and soundtracks with signed links.
`view_media`	Inspect a library image.
`organize_media`	Move, rename, trash, restore or delete media.
`manage_folders`	Create, rename or remove library folders.
`create_share_link`	Public, revocable page for a finished video.
`list_share_links`	Active public links.
`revoke_share_link`	Turn a public link off.

HOW AN AGENT SHOULD WORK

Review first, then generate.

Create

create_production with a public product URL or manual details + photos, a workflow and a brief. One order credit per production.

Review the storyboard

wait_for_production until awaiting_approval; view_storyboard_images to inspect fidelity; approve, or send precise scene corrections.

Finish and share

Watch the video (review_video), choose music, complete_production, then create_share_link or download from list_media.

Imaginou never publishes campaigns, edits listings or promises sales, virality or flawless generative fidelity. Humans approve every storyboard and every final video.

REST API v1 (2026-10-25)

Same capabilities over HTTPS.

Base URL https://app.imaginou.com/api/v1. Machine-readable description: OpenAPI 3.1 · public capabilities · MCP manifest.

GET  /api/v1/me                              account, credits, storage, items needing attention
GET  /api/v1/productions?state=action        list (filter by state/phase)
POST /api/v1/productions                     {productUrl|manual, workflow, language, brief, photos[]}
GET  /api/v1/productions/{id}                storyboard, findings, media links
GET  /api/v1/productions/{id}/wait           long-poll until a decision is needed
POST /api/v1/productions/{id}/approve        {acceptFindings}
POST /api/v1/productions/{id}/changes        {scenes, notes, consumeCredit}
POST /api/v1/productions/{id}/review         {decision: approve|reject}
POST /api/v1/productions/{id}/music          {choice: A|B|none}
POST /api/v1/productions/{id}/edit           {trimSilence, soundEffects, polishedOverlays, notes}
POST /api/v1/productions/{id}/complete       {acceptFindings}
POST /api/v1/productions/{id}/shares         {mediaId?}
GET  /api/v1/media?type=video                library with signed links (1 h)
GET  /api/v1/media/{id}/file                 stream or download (Range supported)
GET  /api/v1/billing · POST /api/v1/billing/checkout {plan}

AUTHENTICATION AND SCOPES

Scoped to one account. Always.

MCP clients use OAuth 2.1: discovery at /.well-known/oauth-authorization-server, dynamic registration at /oauth/register, authorization code with PKCE (S256), 30-day access tokens and rotating refresh tokens. People can also create personal access tokens (imk_…) in the studio and revoke any connection at any time.

Scope	Allows
`productions:read`	See your productions, storyboards, review findings and queue position.
`productions:write`	Create productions, approve storyboards, request changes, choose music, edit and finish videos.
`media:read`	View and download your saved images and videos.
`media:write`	Organize your media library: folders, names, Trash.
`billing:read`	See remaining order credits.
`billing:checkout`	Create Stripe checkout links to buy order credits (never charges a card by itself).
`sharing:write`	Create and revoke public share links for finished videos.
`account:read`	See your account name, email and language.

Tokens are stored hashed. A token never reveals another account's productions or media. Payments happen only in Stripe Checkout, in a browser.

Ready to let your assistant produce?

Open Connect AI in the studio ↗ What Imaginou makes

Three free productions for new accounts. Questions: contact@imaginou.com