ai.mysiren/siren

Tools

• add_person

  Add a face to the people library. Siren crops it round in a few seconds (status cropping, then ready). Only upload people who agreed.

  shallow
• buy_credits

  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.

  shallow
• clarify_brief

  Ask Siren's clarifier whether a brief is specific enough to generate from. Returns ready=true/false plus follow-up questions. Use before create_campaign when the user's request is vague.

  shallow
• create_campaign

  Create a Siren campaign from a plain-language brief — the full pipeline: plan, on-brand copy, deterministic render, verify. Returns the run; poll get_run until it finishes. Spends credits (image 10, video 25; voice or music-only is the same 25). Optional scheduled_at (ISO-8601) queues a sequential post (X → Instagram → TikTok, or platforms you pass) when the render succeeds — requires Allow posting. Fails with a 402 upgrade message if the plan or balance can't cover it.

  shallow
• create_mascot

  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.

  shallow
• delete_brand_video

  Remove a clip from Brand DNA, file and poster included.

  shallow
• delete_media

  Delete one photo or video uploaded with upload_media. Only this workspace's uploads; a film that already rendered keeps its copy.

  shallow
• delete_person

  Remove a face from the people library.

  shallow
• delete_product_screen

  Remove a product screenshot from Brand DNA. Does not delete Brand Memory.

  shallow
• describe_film

  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.

  shallow
• edit_asset

  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.

  shallow
• get_account

  Get the connected Siren workspace: plan, key scopes, auto-post setting, and daily limit. Call this first to learn what the account can do before generating.

  shallow
• get_brand_dna

  Get this workspace's Brand DNA: name, overview, tagline, offer, features, products, audience, palette, logos. Not Brand Memory.

  shallow
• get_mascot

  The workspace mascot: status (hero, keeping, frames, ready), the hero picture, tries left, and every pose frame with its URL. Null mascot = none yet.

  shallow
• get_performance

  How the posts did: totals (impressions, engagement, replies, engagement rate) and the top posts with views, likes and replies.

  shallow
• get_run

  Get one run by id — full status, output text, asset URLs, impact and audience scores, and any error. Poll this after create_campaign or render_asset until status is terminal.

  shallow
• list_brand_videos

  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.

  shallow
• list_films

  Every live film master Siren can render: name, what it is, when to hire it, runtime, aspect, whether this plan can render it, and `fits_this_brand` with what is `missing` for this workspace (films that fit come first). Films are deterministic MP4s; video renders need Pro or above. Read this before promising a specific film, then describe_film for its body.

  shallow
• list_media

  Photos and videos uploaded with upload_media, newest first, with their URLs. Reuse a URL in create_campaign media or a film body.

  shallow
• list_people

  The people library: team faces Siren can put in stills (name, role, team, status cropping or ready, round crop URL).

  shallow
• list_platinum_films

  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 body, same as any film.

  shallow
• list_posts

  Every post Siren sent or queued: platform, status, live URL, time, and counts by status (posted, queued, failed).

  shallow
• list_product_screens

  List the brand assets in Brand DNA: product photos, app screenshots, packaging. Each row has name, kind, description, use_when, tags, scan_status (scanning / ready / failed), device, theme, url.

  shallow
• list_runs

  List the workspace's recent generation runs (newest first): status, brief, channel, asset URLs, and audience scores.

  shallow
• list_styles

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

  shallow
• mascot_step

  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.

  shallow
• post_run

  Post a finished run's assets to the workspace's CONNECTED SOCIAL ACCOUNT. This is live, public distribution on the customer's channel — always confirm with the user before calling. Only works if the grant was authorised with posting allowed.

  shallow
• render_asset

  Render pre-formed SirenSeed bodies directly (advanced): deterministic template render, no planner. Each item: {output_type, channel, seed_body, archetype?, family?, surface?, caption?, voice_id?}. Prefer create_campaign unless the user has concrete seed JSON. Returns run ids — poll get_run for status.

  shallow
• schedule_post

  Schedule a finished run to post at scheduled_at (ISO-8601). Shows in the customer's local timezone. platforms: x, instagram, tiktok, linkedin, youtube, or everything. Posts fire sequentially. Requires Allow posting. Prefer this over post_run when the user names a time. On create_campaign you can pass scheduled_at instead.

  shallow
• studio_automate

  Create a Studio profile on this API key. Returns generate curl and inbound hook URLs (Stripe, GitHub, Uptime Kuma, Product Hunt, generic).

  shallow
• studio_card

  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.

  shallow
• studio_schedule

  Render a Studio card then queue a ScheduledPost at scheduled_at.

  shallow
• studio_templates

  List Siren Studio's 33 React data-card types with family, description, and body schema. Use this before studio_card so the body matches.

  shallow
• update_brand_dna

  Patch Brand DNA. Send only keys to change. Nested bags (offer, product_map, icp) merge. Examples: {tagline, overview, offer: {product_name, one_liner, features, who_its_for, primary_cta}, product_map: {offerings, how_we_work}, icp: {who_buys, pains}}. Does not read or write Brand Memory.

  shallow
• update_product_screen

  Edit an existing brand asset: name, description, kind, use_when, and the screenshot tags (screen_type, device, theme).

  shallow
• upload_brand_video

  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.

  shallow
• upload_logo

  Set the workspace logo in Brand DNA. Every render uses it.

  shallow
• upload_media

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

  shallow
• upload_product_screen

  Upload a brand asset (product photo, app screenshot, packaging) into Brand DNA and store it on R2. Pass image_url (https PNG/JPG/WebP) or image_base64. Two ways to file it: - Send `description` (and optionally kind, use_when, tags, name): Siren trusts your words and files the asset as-is. No read. - Send only the file: Gemini reads the picture and writes name, kind, description, use_when, tags itself. scan_status goes scanning → ready in about 8 seconds; poll list_product_screens. kind is free text ("product photo", "dashboard screenshot", "packaging"), there is no fixed list. A brief that names an asset ("advertise the pink handbag") pulls that file into the still. screen_type / device / theme only matter for device-framed screenshot masters.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/e52752fe-f4ca-400c-9205-b420ff919aa6/badge.svg)](https://vouch.tools/servers/e52752fe-f4ca-400c-9205-b420ff919aa6)