open for agents

the interface and the api
are the same declaration

Every control on this site carries the name of the tool it calls. The list below is the one the product reads to build its own menus — so what you automate is exactly what a person clicks, and neither can quietly fall behind the other.

connect

endpoint
https://imaginefilmsai.com/mcp
transport
streamable-http
version
1.0.0
{
  "mcpServers": {
    "imagine-films": {
      "type": "http",
      "url": "https://imaginefilmsai.com/mcp"
    }
  }
}

In Claude chat: Settings → Connectors → Add custom connector, and paste https://imaginefilmsai.com/mcp. There is no plugin to install.

Plain text for anything without a browser: /llms.txt

over mcp

publicanswers without an account

  • search_trending_videos

    Search the insights database for high-performing short-form video.

  • get_trending_snapshot

    The current curated trending snapshot, ranked by reach past a creator’s own audience.

  • get_video_insight

    Metrics, reach and hook for one video already in the database.

  • get_creator_profile

    A creator’s baseline, and their strongest recent videos against it.

  • list_insight_coverage

    What the database covers, and how fresh the newest capture is.

accountneeds an oauth connection, spends credits

  • research_video

    Pull a video that is not yet in the database, with its full transcript.

  • research_creator

    Pull a creator’s recent post history and add it to the database.

  • compose_film

    Generate a film from a written description.

  • get_generation

    Status and output URLs for one generation.

  • list_films

    Recent generations for your organisation.

on this page

A different list: the controls a person clicks, named so you can see what each one calls. These are not served over MCP — setting an aspect ratio on a page nobody is looking at does nothing.

composedescribe the film and steer what it shows

  • compose⌘↵

    Generate a film from a written description.

    • promptstring · requiredWhat the film should show.
    • referencesnumberCount of attached reference stills or clips. Up to 50.

  • attach_reference@

    Attach a still or clip to steer subject, product or location identity.

    • kindstill | clip | product | floorplanReference type.

  • set_model

    Choose the generation model.

    • modelaperture-2 | aperture-2-turbo | longform-30s · requiredModel identifier.

lookthe lighting setup, not a filter

  • set_look←→

    Apply a colour science. Changes lighting and stock response, not the subject.

    • lookcommerce | training | property · requiredNamed grade.

outputaspect, duration, model, delivery

  • set_aspect_ratio

    Set the output frame shape.

    • aspect16:9 | 9:16 | 1:1 | 2.39:1 · requiredWidth-to-height ratio.

  • set_duration

    Set the output length.

    • duration4s | 8s | 15s | 30s · requiredClip length.

  • toggle_audio

    Hear one example film. Only one plays sound at a time.

navigatemove around the surface itself

  • browse_examples

    List example films for a given look.

    • lookcommerce | training | propertyFilter by grade.
    • limitnumberMaximum results.

  • open_command_palette⌘K

    Open the command surface. Identical schema to this manifest.