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://hermeasinc.com/mcp
transport
streamable-http
version
1.0.0
{
  "mcpServers": {
    "imagine-films": {
      "type": "http",
      "url": "https://hermeasinc.com/mcp"
    }
  }
}

In Claude chat: Settings → Connectors → Add custom connector, and paste https://hermeasinc.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

  • render_video_composition

    Render a composition to an mp4. Returns a render_id to poll; the finished film becomes an asset.

  • get_render

    Where a render has got to, and a signed link to the film when it is done.

  • list_video_compositions

    List the video compositions on this account, most recently edited first.

  • read_video_composition

    One composition: its shape, and every element on its timeline with the times it occupies.

  • list_video_composition_versions

    The history of a composition — every change, who made it, and how much it changed.

  • edit_video_composition

    Change a composition. Edits apply together or not at all, and land as one revertible version.

  • restore_video_composition_version

    Bring an earlier version back — written as a new version, so the restore is itself revertible.

  • 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.

  • check_element_approval_status

    Which of a film’s elements a person has approved — and, where some are not, the two options to put to them. Remembered per film.

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.