ai.mysiren/siren · v1.1.0 · marketing-and-seo
Siren is healthy: it completed an MCP handshake in 2300 ms and exposes 39 tools. It scores 60/100.
Deterministic visual marketing engine. Your agent plans, renders, and posts on-brand campaigns.
Add to my toolfindr inventory →
Healthy · last checked 2026-10-14T09:01:01.337Z UTC
| Checked (UTC) | Status | Latency |
|---|---|---|
| 2026-10-14T09:01:01.337Z | ok | 2300 ms |
| health | 17 / 25 |
| authEase | 15 / 15 |
| toolQuality | 15 / 15 |
| maintenance | 5 / 15 |
| adoption | 0 / 10 |
| usage | 0 / 10 |
| security | 8 / 10 |
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. Empty asset_types / channels /
connected_accounts lists mean UNRESTRICTED, not missing — never stop
on them. Films render on every plan; creditlist_runs List the workspace's generation runs (newest first): status, brief,
channel, asset URLs, and caption. Page with offset to see them all.get_run Get one run by id — full status, output text, asset URLs,
caption, and any error. Poll this after create_campaign
or render_asset until status is terminal. Wait `poll_after_seconds`
between polls; `progress` and `eta_seconds` say how far along it is.
A finished film carries `film_check`, advice onlycreate_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, an ad set of 3 images 20,
video 25; voice or music-only is the same 25). Pass output_type to
pin a filist_films The film library, one ranked page 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 to hire it, its length and
shapes, fits_this_brand (with what is missing) and made_recently
(this brand already got it: prefer anothlist_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.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 bradescribe_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.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.render_asset Render films from pre-formed SirenSeed bodies (advanced). FILMS ONLY:
images are painted from a brief, so 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, archetype?, family?, surface?,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 aedit_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 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. Pass `caption` to own the
words; it goes out verbatim. Theschedule_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 pasget_brand_dna Get this workspace's Brand DNA: brand_name, brand_kind, overview,
tagline, offer, features, products, audience, palette, logos, plus
`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 updateupdate_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.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.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 readupdate_product_screen Edit an existing brand asset: name, description, kind, use_when,
and the screenshot tags (screen_type, device, theme).delete_product_screen Remove a product screenshot from Brand DNA. Does not delete Brand Memory.upload_logo Set the workspace logo in Brand DNA. Every render uses it.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.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.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.list_people The people library: team faces Siren can put in stills (name,
role, team, status cropping or ready, round crop URL).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.delete_person Remove a face from the people library.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.get_performance How the posts did: totals (impressions, engagement, replies,
engagement rate) and the top posts with views, likes and replies.list_posts Every post Siren sent or queued: platform, status, live URL, time,
and counts by status (posted, queued, failed).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.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.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 ("ldelete_brand_video Remove a clip from Brand DNA, file and poster included.delete_media Delete one photo or video uploaded with upload_media. Only this
workspace's uploads; a film that already rendered keeps its copy.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.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.studio_automate Create a Studio profile on this API key. Returns generate curl and
inbound hook URLs (Stripe, 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.studio_schedule Render a Studio card then queue a ScheduledPost at scheduled_at.