Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Certificate changed, valid to 2027-01-17
Authorization not required, issuer https://mcp.mysiren.ai
Changed the definition of "studio_export"
Render a Studio design or video toa file.files. Spends credits like any render: a video 25 (25;platinum 50), a card 10, a set 10 a slide (an App Store set of 6 is 60), charged once. A card or aplatinumsetfilmwaits50for the render (about a minute) and returns every file in `asset_urls`, slide 1 first; a video returns the run id: poll get_run until it isterminal,then show the human the file or post it with post_run.
Authorization not required, issuer https://mcp.mysiren.ai
Added "studio_edit", "studio_export", "studio_get" and 2 more (39 tools before, 44 now)
Change a Studio video by asking, as the human would in the chat. Only what the ask names changes; Siren replies with what it changed (before and after) and the new version number. Waits up to about 25 seconds for the reply. No credits are spent until studio_export. A greeting or a question gets an answer and no new version.
Render a Studio video to a file. Spends credits like any video (25; a platinum film 50) and returns the run id: poll get_run until it is terminal, then show the human the file or post it with post_run.
One Studio video: the chat so far (who said what, with diffs), every version, and which version is current.
Start a video in Siren Studio from a description. Siren composes the first take (about 10 to 20 seconds) and replies with what it made; nothing is rendered or charged until studio_export. Returns the thread and Siren's reply. The human sees the same thread in Studio and can keep editing it there, or you can with studio_edit.
Changed the definition of "create_campaign" and "list_films"
⟨23 unchanged words⟩ until it finishes. Spends credits (image 10, an ad set of 3 images 20, video 25; voice or music-only is the same ⟨164 unchanged words⟩
⟨546 unchanged words⟩ or America/New_York.","type":"string"},"variants":{"default":1,"description":"Images only. 3 makes an ad set: the same creative with three different headlines, for testing hooks on paid feeds. 20 credits for the three instead of 10 for one. get_run then returns all three in asset_urls. Default 1.","type":"integer"},"voiceover":{"anyOf":[{"type":"boolean ⟨36 unchanged words⟩
Authorization not required, issuer https://mcp.mysiren.ai
Authorization not required, issuer https://mcp.mysiren.ai
Authorization not required, issuer https://mcp.mysiren.ai
Changed the definition of "create_campaign"
⟨263 unchanged words⟩ Siren writes the caption."},"channel":{"defaultanyOf":[{"TargetOmitchanneltoforcuttheone render:twitter,
Added "edit_asset"; changed the definition of "create_campaign" (38 tools before, 39 now)
⟨377 unchanged words⟩ the film shows the brand's recent work. Images (asset_type=card):notphotosused;fromaddupload_mediapicturesaretopaintedBrandintoDNAthewithcreativeupload_product_screen
Changed the definition of "get_account"
⟨34 unchanged words⟩ , not missing — never stop on them.FilmFilmsrendersrenderneedonplaneveryproplan;orcreditsaboveare(empire/scale/pro).the only meter.
Authorization not required, issuer https://mcp.mysiren.ai
Changed the definition of "list_films"
⟨98 unchanged words⟩ films by word. Then describe_film for the body.VideoVideosrendersareneedonProeveryorplan;above.credits are the only limit. Every film here is 25 credits. Platinum films ⟨18 unchanged words⟩
Authorization not required, issuer https://mcp.mysiren.ai
Authorization not required, issuer https://mcp.mysiren.ai
Authorization not required, issuer https://mcp.mysiren.ai
Authorization not required, issuer https://mcp.mysiren.ai
Added "list_platinum_films"; changed the definition of "list_films" (37 tools before, 38 now)
⟨104 unchanged words⟩ the body. Video renders need Pro or above. Every film here is 25 credits. Platinum films (50 credits) are not in these pages: the answer's platinum section flags them, and list_platinum_films has the shelf.
The platinum shelf: studio-grade films that match a top motion studio's craft, told as the brand's own story. Each costs 50 credits, every time (a normal film is 25). Offer one only when the human is making a big launch they genuinely want to go far; everyday posts and normal budgets use list_films. Say the price before you render. Ids end in -plt. Platinum needs a paid plan or a credit top-up: a complimentary plan sees it but gets 402 platinum_needs_paid_plan. voice MM = motion and music only (no voice-over question, no narration); MVM = motion, voice and music. Then describe_film for the bo…
Changed the definition of "get_run"
⟨78 unchanged words⟩ (a missing image, a wrong name). `notices` are plain-words notes on the request (e.g. it asked for a mood the brand's look does not wear): the asset is made as asked; pass the note to the human. A finished run carries `caption`: the post caption ⟨39 unchanged words⟩
Added "list_styles" (36 tools before, 37 now)
The still style library, one ranked page at a time. Every painted still (an ad creative, poster, launch card, App Store frame, thumbnail) is one style; Siren picks one when you don't. Styles sit on section shelves; pass section and the human's goal and take one from the top. made_recently = this brand already got that look, prefer another. To paint in a style, put its id in the create_campaign brief (asset_type card). The whole library as one file: https://api.mysiren.ai/api/v1/styles.md (also .txt/.json).
Authorization not required, issuer https://mcp.mysiren.ai
Changed the definition of "list_films"
Every liveThe filmmasterlibrary,Sirenonecanrankedrender:pagename,at a time. Films sit on job shelves; pass job and the human's goal and hire from the top of the page. Each film says what it is, when tohire it,runtime,itsaspect,length
Authorization not required, issuer https://mcp.mysiren.ai
Changed the definition of "create_campaign"
⟨123 unchanged words⟩ or memory is used; only what you send.LookYOU look the brand up first: their site, their logo file (thebrand'simagerealin their site header, or their /brand or /press page, or the app icon) and their colours as hex. A missing, dead or damaged logo is refused (brand_logo_required / brand_logo_unreachable / brand_logo_unreadable) because a film with no mark is a generic video; one colour for both primary and accent is refused too. Never invent a logo URL andcoloursneverfirst.
Added "add_person", "buy_credits", "create_mascot" and 12 more; changed the definition of "create_campaign", "get_run" and "list_runs" (21 tools before, 36 now)
⟨165 unchanged words⟩ }. Nothing of this workspace's identity leaks in. The exact same request within 24 hours returns the run it already started, as it is now, with replayed=true and no new charge. Change the brief to make another.
⟨208 unchanged words⟩ , linkedin, tiktok, or youtube. Sets the default aspect (X square, Instagram 4:5, TikTok 9:16) and copy length. A shape named in the brief wins: square, vertical, portrait, story, wide, landscape, 4:5, 9:16, 16:9.","type":"string"},"direction":{ ⟨243 unchanged words⟩
Changed the definition of "create_campaign", "get_run" and "render_asset"
⟨86 unchanged words⟩ if the plan or balance can't cover it. FILM KNOBS: voiceover (true narrated / false music only), direction (mood, pace, motion, music in one line), music (a bed id), media (upload_media URLs the film shows). Images ignore the film knobs: Siren writes and paints them from the brief and Brand DNA. ANY BRAND: pass `brand` to make it for ⟨27 unchanged words⟩
⟨216 unchanged words⟩ copy length.","type":"string"},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Films: one free line on mood, pace, motion and music, e.g. \"emotional, slow, soft piano\" or \"dark, club energy, fast cuts\"."},"media":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Films: URLs from upload_media (images and videos) for the film to show. Omit and the film shows the brand's recent work. Images: not used; add pictures to Brand DNA with upload_product_screen instead."},"music":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Films: a music bed track_id. Omit and the bed follows the film and the direction."},"
Changed the definition of "get_brand_dna", "get_run", "list_films" and 1 more
Get this workspace's Brand DNA:namebrand_name,overviewbrand_kind, overview, tagline, offer,features, products, audience, palette,logos.logos,Notplus `checks`: what to fix before rendering (thin Brand DNA, a typed accent the brand's own work does not use). Call right after get_account; fix thin DNA first with update_brand_dna and upload_product_screen, or ask the human for the site. Not Brand Memory.
Changed the definition of "create_campaign" and "render_asset"
⟨86 unchanged words⟩ if the plan or balance can't cover it. ANY BRAND: pass `brand` to make it for a brand that is not this workspace's own, e.g. brand={"name": "Acme", "site": "acme.com", "logo_url": "https://acme.com/logo.png", "primary": "#FF4400"}. Nothing of this workspace's identity leaks in.
⟨13 unchanged words⟩ or video.","type":"string"},"brand":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"description":"Make it for ANOTHER brand instead of this workspace's own (a client, a brand people recognise, a side project). Object: {name (required), site, logo_url (https PNG/SVG/JPG of the brand's MARK or app icon, e.g. Duolingo's owl, not the wordmark: the film sets the name in type), accent (hex: the brand's signature colour, the one films are painted in), primary (hex: its dark or ink colour), secondary, tagline, font (the brand's typeface name, e.g. Nunito), x_handle, sells (one line: what they make)}. Clean slate: none of this workspace's logo, colours, mascot, font, handle, screenshots or memory is used; only what you send. Look up the brand's real site, logo URL and colours first. Omit to use this workspace's Brand DNA."},"
Added "describe_film", "list_films" and "upload_media"; changed the definition of "create_campaign", "get_account", "get_run" and 1 more (18 tools before, 21 now)
⟨32 unchanged words⟩ voice or music-only is the same 25). Pass output_type to pin a film (list_films has the catalog); omit it and Siren picks. Optional scheduled_at (ISO-8601) queues a sequential post ⟨31 unchanged words⟩
⟨34 unchanged words⟩ screenshot\".","type":"string"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional caption for the post this run becomes. Your words are kept; omit and Siren writes the caption."},"channel":{"default":"twitter","description": ⟨13 unchanged words⟩ aspect and copy length.","type":"string"},"output_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional film to pin, e.g. \"story\" or \"pitch\". Call list_films to browse; describe_film for the contract. Omit and Siren picks the format from the brief.
Changed the definition of "studio_automate"
⟨16 unchanged words⟩ GitHub, Uptime Kuma, Product Hunt, generic). Passing delivery.social_account_ids turns on social delivery for the profile — that publishes, so it requires Allow posting.
Certificate recorded, valid to 2026-11-18
Authorization not required
Added "studio_automate", "studio_card", "studio_schedule" and 1 more (14 tools before, 18 now)
Create a Studio profile on this API key. Returns generate curl and inbound hook URLs (Stripe, GitHub, Uptime Kuma, Product Hunt, generic).
Render a Studio data card from a type + body. Deterministic React, no paint. Optional live post after render. Returns run_id, image url, and post url when posted.
Render a Studio card then queue a ScheduledPost at scheduled_at.
List Siren Studio's 33 React data-card types with family, description, and body schema. Use this before studio_card so the body matches.
First tool surface recorded: 14 tools (server version 1.1.0)
Showing the latest 35 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
The workspace's Studio videos, newest first: title, shelf, current version, and whether a human or an agent started it.
⟨70 unchanged words⟩ per film.","type":"string"},"for_brand":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The brand name you will pass in create_campaign brand_override, when the video is for a brand other than this workspace. fits_this_brand then judges that brand (no mascot, people or screens of this workspace)."},"goal":{"anyOf":[{"type":"string ⟨200 unchanged words⟩
Edit a finished ad creative in place. Only what the instruction names changes; faces, layout, lettering and every other pixel are kept, so you can chain edits (hair pink, then tail teal, then add a sign) without the picture drifting. About 15 seconds. 3 credits; an instruction that asks for a whole new look ("make it a comic", "make it cinematic") repaints at 10. Returns the NEW run: poll get_run until it is terminal and show the human the new image. Films are not edited this way: re-render them with render_asset. Every earlier version stays, so the human can go back to any of them.
{"additionalProperties":false,"properties":{"goalall":{"default":false,"description":"true = every film that passes the filters on one page (about 10k tokens for the whole library). Prefer job + page, or the catalog.md file.","type":"boolean"},"aspect":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"OptionalOnly films that render this shape: wide-desktop, square-ig, story-reel, vertical-ig-feed."},"detail":{"default":"short","description":"\"short\" (default) or \"full\" to add the long description per film.","type":"string"},"goal":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The human's own words for the outcome, e.g. \"telllaunch video for ourstory\new AI agent\" or \"launchshowaourfeature\10k users\".ReordersRanks thecatalogfilms by fit."},"job":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The shelf: launch, feature (one feature or update), explain (what the product does), brand (story, manifesto, mood), ai (AI or agent product), proof (a number, testimonials), app (mobile app), shop (products, food, property), people (team or mascot). Omit to rank the whole library."},"max_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Only films this long or shorter, e.g. 15 for a short feed post."},"narrated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true = only films with a voice-over part; false = only music-and-motion films."},"page":{"default":1,"description":"Page number, from 1. Each page is page_size films; next_page in the answer says what to call next.","type":"integer"},"page_size":{"default":8,"description":"Films per page, 1 to 25.","type":"integer"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Find films by word across ids, names and descriptions, e.g. \"phone\", \"chat\", \"mascot\", \"halftone\". Every word must match."}},"type":"object"}
⟨5 unchanged words⟩ — full status, output text, asset URLs,impactand audience scorescaption, and any error. Poll this after create_campaign ⟨16 unchanged words⟩ along it is. A finished film carries `film_check`, advice only: when `ok` isfalse,fixshowwhatthe human the video and the findings and let them decide.`findings`Re-rendernamesat most once, andrenderonlyagainforbeforeashowingdefecttheyouhuman.can name in what you sent (a missing image, a wrong name). A finished run carries `caption`: the post ⟨40 unchanged words⟩
List the workspace'srecentgeneration runs (newest first):status, brief,channel, asset URLs, andaudiencecaption.scores.Page with offset to see them all.
⟨14 unchanged words⟩ 50. Newest first.","type":"integer"},"offset":{"default":0,"description":"Skip this many runs, to page back through every video and image the workspace has made.","type":"integer"}},"type":"object"}
Add a face to the people library. Siren crops it round in a few seconds (status cropping, then ready). Only upload people who agreed.
Get a Stripe checkout link for more credits. Give the link to the human; they pay on Stripe and the credits land in about a minute. Nothing is charged by this call. Read the balance on get_account.
Start the brand mascot: from a description (note, kind) or from a reference picture. Paid plans; 100 credits. Siren paints a hero in about a minute; poll get_mascot, show the human, then mascot_step keep (build the pose sheet) or retry (paint again, 3 tries). One mascot per workspace.
Remove a clip from Brand DNA, file and poster included.
Delete one photo or video uploaded with upload_media. Only this workspace's uploads; a film that already rendered keeps its copy.
Remove a face from the people library.
The workspace mascot: status (hero, keeping, frames, ready), the hero picture, tries left, and every pose frame with its URL. Null mascot = none yet.
How the posts did: totals (impressions, engagement, replies, engagement rate) and the top posts with views, likes and replies.
The brand's own clips in Brand DNA: name, what each shows, when to use it, tags, best moments with timestamps, poster and scan_status.
Photos and videos uploaded with upload_media, newest first, with their URLs. Reuse a URL in create_campaign media or a film body.
The people library: team faces Siren can put in stills (name, role, team, status cropping or ready, round crop URL).
Every post Siren sent or queued: platform, status, live URL, time, and counts by status (posted, queued, failed).
Move the mascot on: keep the hero, paint it again, or add a pose. Ask the human before keep, since it builds the whole sheet.
Add a product demo, walkthrough or footage to Brand DNA. With only the file, Gemini reads frames across the clip and writes what it shows, when to use it, tags and the best moments (scan_status scanning, then ready in about 15 seconds; poll list_brand_videos). Films play it when a brief names it ("launch film with our checkout demo"). Videos are for films; stills are painted from pictures.
Set the workspace logo in Brand DNA. Every render uses it.
⟨54 unchanged words⟩ names and render again before showing the human. A finished run carries `caption`: the post caption Siren wrote in the run's brand (or yours, if you passed one); show it with the asset. After post_run, `posts[]` carries each platform's ⟨14 unchanged words⟩
Render films from pre-formed SirenSeed bodiesdirectly(advanced):.deterministicFILMS ONLY:templateimagesrenderare painted from a brief,nosoplanner.for any image, ad or creative call create_campaign with asset_type=card (a still here returns 422 stills_use_a_brief). Each item: {output_type, channel, seed_body, ⟨158 unchanged words⟩
⟨3 unchanged words⟩ :{"items":{"description":"Pre-formed SirenSeed film bodies torender.render (films only; images go through create_campaign). Each item: {output_type, channel, seed_body, ⟨83 unchanged words⟩
⟨21 unchanged words⟩ after create_campaign or render_asset until status is terminal.AfterWait `poll_after_seconds` between polls; `progress` and `eta_seconds` say how far along it is. A finished film carries `film_check`: when `ok` is false, fix what `findings` names and render again before showing the human. After post_run, `posts[]`carries each platform's status and, once itfires, the live URL andthe caption that went out.
⟨11 unchanged words⟩ when to hire it, runtime, aspect,andwhether this plan can renderit.it,Filmsand `fits_this_brand` with what is `missing` for this workspace (films that fit come first). Films are deterministic MP4s; video rendersneed Pro or above. Read thisbefore promising a specific film, thendescribe_film for its body.
⟨16 unchanged words⟩ archetype?, family?, surface?, caption?, voice_id?, music?, direction?, brand_override?}. Prefer create_campaign unlessthe user has concreteseed JSON. Returns run ids,—`estimated_seconds` andpoll`poll_after_seconds`;get_runwaitforthatstatus.long, then get_run. THE DIRECTOR: every film body is edited against Brand DNA before it renders. It keeps the film and your brand-specific lines, rewrites empty, generic or reference-body copy, and never touches media. `director` in the response says what changed. `direction` is a free line ("dark, club energy, fast") that steers words, pace and music. A film that cannot use what you sent returns 422 film_does_not_fit with a `fix` and `films_that_fit`. ANY BRAND: put brand_override={"name": " ⟨55 unchanged words⟩
⟨15 unchanged words⟩ archetype?, family?, surface?, caption?, voice_id?, music?, direction?, brand_override?}. music = a bed track_id (omit and the bed follows the film and brand). direction = one free line that steers words, pace and music. brand_override with a name = render for ANOTHER ⟨40 unchanged words⟩
⟨15 unchanged words⟩ seed_body, archetype?, family?, surface?, caption?, voice_id?, brand_override?}.Prefer create_campaign unless the user has concreteseed JSON.Returns run ids — poll get_run for status. ANY BRAND: put brand_override={"name": "Acme", "site": "acme.com", "logo_url": "https://acme.com/logo.png", "primary": "#FF4400", "accent": "#111111"} on an item to render it for a brand that is not this workspace's own. With a name it is a clean slate: none of this workspace's logo, mascot, font, handle, screenshots or stills are used. Media slots take only URLs you uploaded with upload_media.
⟨14 unchanged words⟩ seed_body, archetype?, family?, surface?, caption?, voice_id?, brand_override?}. brand_override with a name = render for ANOTHER brand, clean slate: {name, site, logo_url, primary, accent, secondary, tagline, font, x_handle}.","items":{"additionalProperties":true," ⟨24 unchanged words⟩
⟨17 unchanged words⟩ learn what the account can do before generating. Empty asset_types / channels / connected_accounts lists mean UNRESTRICTED, not missing — never stop on them. Film renders need plan pro or above (empire/scale/pro).
⟨21 unchanged words⟩ after create_campaign or render_asset until status is terminal. After post_run, `posts[]` carries each platform's status and, once it fires, the live URL and the caption that went out.
⟨30 unchanged words⟩ if the grant was authorised with posting allowed. Pass `caption` to own the words; it goes out verbatim. The call queues the post behind a short publish window (about two minutes, cancellable) rather than firing inline: poll get_run after that and read `posts[].url` for the live permalink and the caption that went out.
{"additionalProperties":false,"properties":{"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional caption for this publish; goes out verbatim. Omit and Siren writes it."},"platform":{"default":"x","description": ⟨30 unchanged words⟩
The full contract for one film: what it is and when to hire it, its body JSON Schema, a reference body, the seed envelope, media slots (which fields take image/video URLs), the brand prefills (colours, logo, screens) and the override rules. Call it before writing a render_asset body.
Every live film master Siren can render: name, what it is, when to hire it, runtime, aspect, and whether this plan can render it. Films are deterministic MP4s; video renders need Pro or above. Read this before promising a specific film, then describe_film for its body.
Store a photo or video the human wants in a post, from an https URL or base64. Returns a workspace-owned URL to put in any media slot of a film body (describe_film lists the slots) — the renderer reads it directly. Images: PNG/JPG/WebP up to 15 MB. Videos: MP4/MOV/WebM up to 200 MB. The same bytes are stored once (content-hashed).