MCP-Server
Siren
ai.mysiren/siren
Was dieses MCP kann
Plans, renders, and posts on-brand visual marketing campaigns.
Funktionen
Tools
38
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.
Eingabeschema
{'type': 'object', 'properties': {'name': {'type': 'string', 'default': '', 'description': "The person's name."}, 'role': {'type': 'string', 'default': '', 'description': 'Their role, e.g. Founder, Head of Design.'}, 'team': {'type': 'string', 'default': '', 'description': 'Their team, if any.'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Public https URL of a portrait (PNG, JPG or WebP), one face.'}, 'image_base64': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The portrait as base64, if you have no URL.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'properties': {'credits': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Or a custom amount, 50 to 5000, at $0.20 each.'}, 'pack_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'small (50 credits, $9.99), medium (100, $20) or large (300, $50).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['brief'], 'properties': {'brief': {'type': 'string', 'description': 'Plain-language request for the post, e.g. "announce the new export feature, use the dashboard screenshot".'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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). 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 (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.
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 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.
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.
Eingabeschema
{'type': 'object', 'required': ['brief'], 'properties': {'brand': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, '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. YOU look the brand up first: their site, their logo file (the image in 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 and never pass a screenshot of their page as the logo. Omit to use this workspace's Brand DNA."}, 'brief': {'type': 'string', 'description': 'Plain-language request for the post, e.g. "announce the new export feature, use the dashboard screenshot".'}, 'media': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, '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': None, 'description': 'Films: a music bed track_id. Omit and the bed follows the film and the direction.'}, 'caption': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional caption for the post this run becomes. Your words are kept; omit and Siren writes the caption.'}, 'channel': {'type': 'string', 'default': 'twitter', 'description': 'Target channel for the render: twitter, instagram, 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.'}, 'timezone': {'type': 'string', 'default': 'UTC', 'description': 'IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York.'}, 'direction': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Films: one free line on mood, pace, motion and music, e.g. "emotional, slow, soft piano" or "dark, club energy, fast cuts".'}, 'platforms': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Where to post: any of x, instagram, tiktok, linkedin, youtube, or ["everything"] for every connected channel.'}, 'voiceover': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'Films: true = narrated in the brand voice, false = motion + music only. Omit and the brief decides; if the human never said, ask them once.'}, 'asset_type': {'type': 'string', 'default': 'card', 'description': 'What to make: card (still image) or video.'}, 'output_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, '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.'}, 'scheduled_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'properties': {'kind': {'type': 'string', 'default': 'auto', 'description': 'auto (Siren picks from the brand), animal, creature, object, robot, food, or abstract.'}, 'name': {'type': 'string', 'default': '', 'description': "The mascot's name, if the human has one."}, 'note': {'type': 'string', 'default': '', 'description': "Describe the character in the human's words: what it is, colours, personality, what to avoid. Up to 280 characters."}, 'style': {'type': 'string', 'default': 'vinyl', 'description': 'Material: vinyl (default), clay, plush, wool, or glossy.'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "A reference picture of the mascot (https PNG/JPG/WebP). Siren paints it in the brand's style, keeping the character."}, 'image_base64': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The reference picture as base64, if you have no URL.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
delete_brand_video
Remove a clip from Brand DNA, file and poster included.
Destruktiv
Eingabeschema
{'type': 'object', 'required': ['video_id'], 'properties': {'video_id': {'type': 'string', 'description': 'Id from list_brand_videos.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
delete_media
Delete one photo or video uploaded with upload_media. Only this
workspace's uploads; a film that already rendered keeps its copy.
Destruktiv
Eingabeschema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The URL upload_media returned (or one from list_media).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
delete_person
Remove a face from the people library.
Destruktiv
Eingabeschema
{'type': 'object', 'required': ['person_id'], 'properties': {'person_id': {'type': 'string', 'description': 'Id from list_people.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
delete_product_screen
Remove a product screenshot from Brand DNA. Does not delete Brand Memory.
Destruktiv
Eingabeschema
{'type': 'object', 'required': ['screen_id'], 'properties': {'screen_id': {'type': 'string', 'description': 'Id of the brand asset from list_product_screens.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['output_type'], 'properties': {'output_type': {'type': 'string', 'description': 'Film id from list_films, e.g. "story", "pitch", "gallery".'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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. Film renders need plan pro or above (empire/scale/pro).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
get_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 update_brand_dna and
upload_product_screen, or ask the human for the site. Not Brand
Memory.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
get_performance
How the posts did: totals (impressions, engagement, replies,
engagement rate) and the top posts with views, likes and replies.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'window': {'type': 'string', 'default': '30d', 'description': '7d, 30d or 90d.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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 only: when `ok` is
false, show the human the video and the findings and let them decide.
Re-render at most once, and only for a defect you can name in what you
sent (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 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 status and, once it
fires, the live URL and the caption that went out.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'The run id returned by create_campaign, render_asset, or list_runs.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
list_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 another film on the shelf unless
the human asked for that one). Page on with next_page. Want it all at
once? all=true, or fetch the catalog file (https://api.mysiren.ai/api/v1/films.md,
every film by shelf, also .txt/.json) and read it in steps. search=
finds films by word. Then describe_film for 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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'all': {'type': 'boolean', '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.'}, 'job': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, '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.'}, 'goal': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The human\'s own words for the outcome, e.g. "launch video for our new AI agent" or "show our 10k users". Ranks the films by fit.'}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page number, from 1. Each page is page_size films; next_page in the answer says what to call next.'}, 'aspect': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Only films that render this shape: wide-desktop, square-ig, story-reel, vertical-ig-feed.'}, 'detail': {'type': 'string', 'default': 'short', 'description': '"short" (default) or "full" to add the long description per film.'}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Find films by word across ids, names and descriptions, e.g. "phone", "chat", "mascot", "halftone". Every word must match.'}, 'narrated': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'true = only films with a voice-over part; false = only music-and-motion films.'}, 'page_size': {'type': 'integer', 'default': 8, 'description': 'Films per page, 1 to 25.'}, 'max_seconds': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'default': None, 'description': 'Only films this long or shorter, e.g. 15 for a short feed post.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
list_people
The people library: team faces Siren can put in stills (name,
role, team, status cropping or ready, round crop URL).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
list_posts
Every post Siren sent or queued: platform, status, live URL, time,
and counts by status (posted, queued, failed).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'description': 'How many posts, 1 to 200. Newest first.'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Skip this many, to page back.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
list_runs
List the workspace's generation runs (newest first): status, brief,
channel, asset URLs, and caption. Page with offset to see them all.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 10, 'description': 'How many runs to return, 1 to 50. Newest first.'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Skip this many runs, to page back through every video and image the workspace has made.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'all': {'type': 'boolean', 'default': False, 'description': 'true = every style that passes the filters on one page. Prefer section + page, or the styles.md file.'}, 'goal': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The human\'s own words for the still, e.g. "a hot take about launches" or "our pricing is simple". Ranks the styles by fit.'}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page number, from 1. next_page in the answer says what to call next.'}, 'aspect': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Only styles that paint on this shape: square-ig, vertical-ig-feed, story-reel, wide-desktop.'}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Find styles by word in their id or when-to-pick line, e.g. "comic", "receipt", "billboard".'}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The shelf: social-ad (feed ads), poster, launch, brand, og (link previews), youtube (thumbnails), app-store, event, wallpaper, arts-creative. Omit to rank the whole library.'}, 'page_size': {'type': 'integer', 'default': 8, 'description': 'Styles per page, 1 to 25.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'required': ['action'], 'properties': {'note': {'type': 'string', 'default': '', 'description': 'For retry: what to change this time.'}, 'label': {'type': 'string', 'default': '', 'description': 'For pose: the pose in a few words, e.g. waving, holding a phone.'}, 'action': {'type': 'string', 'description': 'keep = build the pose sheet from this hero; retry = paint the hero again; pose = add one more pose to a built mascot.'}, 'prompt': {'type': 'string', 'default': '', 'description': 'For pose: extra detail for the pose.'}, 'with_model': {'type': 'boolean', 'default': False, 'description': 'For pose: also make a 3D model of it (20 credits instead of 10).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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. 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.
Destruktiv
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'The run id returned by create_campaign, render_asset, or list_runs.'}, 'caption': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional caption for this publish; goes out verbatim. Omit and Siren writes it.'}, 'platform': {'type': 'string', 'default': 'x', 'description': 'Connected channel to post to: x, instagram, tiktok, linkedin, or youtube.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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?, caption?, voice_id?,
music?, direction?, brand_override?}. Prefer create_campaign unless
the user has concrete seed JSON. Returns run ids, `estimated_seconds`
and `poll_after_seconds`; wait that 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": "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.
Eingabeschema
{'type': 'object', 'required': ['items'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Human-readable name for the asset or run.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Pre-formed SirenSeed film bodies to render (films only; images go through create_campaign). Each item: {output_type, channel, seed_body, 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 brand, clean slate: {name, site, logo_url, primary, accent, secondary, tagline, font, x_handle}.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Destruktiv
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['run_id', 'scheduled_at'], 'properties': {'run_id': {'type': 'string', 'description': 'The run id returned by create_campaign, render_asset, or list_runs.'}, 'captions': {'anyOf': [{'type': 'object', 'additionalProperties': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional caption override per platform, e.g. {"x": "...", "linkedin": "..."}.'}, 'timezone': {'type': 'string', 'default': 'UTC', 'description': 'IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York.'}, 'platforms': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Where to post: any of x, instagram, tiktok, linkedin, youtube, or ["everything"] for every connected channel.'}, 'scheduled_at': {'type': 'string', 'description': 'ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'required': ['name', 'output_types'], 'properties': {'name': {'type': 'string', 'description': 'Name for this automation profile.'}, 'caption': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Default caption for auto-posted cards.'}, 'delivery': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional delivery: {social_account_ids?, telegram?, discord?}.'}, 'output_types': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Studio types this profile may render.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'required': ['output_type', 'body'], 'properties': {'body': {'type': 'object', 'description': 'Card fields for that type (amount, productName, â\x80¦).', 'additionalProperties': True}, 'post': {'type': 'boolean', 'default': False, 'description': 'If true, post the finished card to a connected account. Confirm with the user first.'}, 'theme': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'dark or light. Omit to use the workspace default.'}, 'accent': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Hex accent, e.g. #5B82FF.'}, 'aspect': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Canvas aspect, e.g. square-ig or wide-twitter.'}, 'caption': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Caption when posting.'}, 'platform': {'type': 'string', 'default': 'x', 'description': 'Connected channel if post is true: x, instagram, tiktok, linkedin, or youtube.'}, 'output_type': {'type': 'string', 'description': 'One of the 33 Studio types from studio_templates, e.g. sale-notification.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
studio_schedule
Render a Studio card then queue a ScheduledPost at scheduled_at.
Destruktiv
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['output_type', 'body', 'scheduled_at'], 'properties': {'body': {'type': 'object', 'description': 'Card fields for that type.', 'additionalProperties': True}, 'caption': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Caption for the scheduled post.'}, 'timezone': {'type': 'string', 'default': 'UTC', 'description': 'IANA timezone for scheduled_at.'}, 'platforms': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'x, instagram, tiktok, linkedin, youtube, or everything.'}, 'output_type': {'type': 'string', 'description': 'Studio type to render.'}, 'scheduled_at': {'type': 'string', 'description': 'ISO-8601 time to post.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'required': ['fields'], 'properties': {'fields': {'type': 'object', 'description': 'Brand DNA keys to change, e.g. {"tagline": "...", "offer": {"one_liner": "..."}}. Nested bags merge.', 'additionalProperties': True}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
update_product_screen
Edit an existing brand asset: name, description, kind, use_when,
and the screenshot tags (screen_type, device, theme).
Eingabeschema
{'type': 'object', 'required': ['screen_id'], 'properties': {'kind': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Free-text kind: product photo, dashboard screenshot, packaging, logo, team photo.'}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Human-readable name for the asset or run.'}, 'theme': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'UI theme in the screenshot: light, dark, or unknown.'}, 'device': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Device the screenshot was taken on: phone, tablet, desktop, or none.'}, 'use_when': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'When Siren should reach for this asset, e.g. "any post about the analytics page".'}, 'screen_id': {'type': 'string', 'description': 'Id of the brand asset from list_product_screens.'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'What the picture shows and what it is for, in your words. When set, Siren files the asset without reading it.'}, 'screen_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Screen role: feature, hero, onboarding, settings, or marketing.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'properties': {'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Public https URL of the clip (MP4, MOV or WebM, up to 200 MB and 5 minutes).'}, 'name': {'type': 'string', 'default': '', 'description': 'Human-readable name, e.g. "checkout demo".'}, 'tags': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Short lowercase search words.'}, 'base64': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The clip bytes as base64, if you have no URL.'}, 'use_when': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'When a film should play it, e.g. "any film about checkout".'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'What the clip shows, in your words. When set, Siren files it without reading it.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
upload_logo
Set the workspace logo in Brand DNA. Every render uses it.
Eingabeschema
{'type': 'object', 'properties': {'variant': {'type': 'string', 'default': 'light', 'description': 'light = the mark used on light backgrounds (the usual one); dark = the one for dark backgrounds.'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Public https URL of the logo (PNG, JPG or WebP).'}, 'image_base64': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The logo bytes as base64, if you have no URL.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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).
Eingabeschema
{'type': 'object', 'properties': {'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Public https URL of the photo or video to store. Pass this or base64.'}, 'kind': {'type': 'string', 'default': 'auto', 'description': 'auto (default), image, or video. Detected from the bytes when auto.'}, 'name': {'type': 'string', 'default': '', 'description': 'Human-readable name for the file.'}, 'base64': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The media bytes as base64, if you have no URL. Pass this or url.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
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.
Eingabeschema
{'type': 'object', 'properties': {'kind': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Free-text kind: product photo, dashboard screenshot, packaging, logo, team photo.'}, 'name': {'type': 'string', 'default': '', 'description': 'Human-readable name for the asset or run.'}, 'tags': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Short lowercase tags for search, e.g. ["dashboard", "dark-mode"].'}, 'theme': {'type': 'string', 'default': 'unknown', 'description': 'UI theme in the screenshot: light, dark, or unknown.'}, 'device': {'type': 'string', 'default': 'phone', 'description': 'Device the screenshot was taken on: phone, tablet, desktop, or none.'}, 'use_when': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'When Siren should reach for this asset, e.g. "any post about the analytics page".'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Public https URL of a PNG, JPG, or WebP to store as a brand asset.'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'What the picture shows and what it is for, in your words. When set, Siren files the asset without reading it.'}, 'screen_type': {'type': 'string', 'default': 'feature', 'description': 'Screen role: feature, hero, onboarding, settings, or marketing.'}, 'image_base64': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'The image bytes as base64, if you have no URL.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'additionalProperties': True}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
list_platinum_films
29. September 2026 03:00
Geändert
list_films
29. September 2026 03:00
Hinzugefügt
list_styles
27. September 2026 02:51
Geändert
list_films
27. September 2026 02:51
Geändert
get_run
27. September 2026 02:51
Hinzugefügt
delete_media
21. September 2026 02:58
Hinzugefügt
delete_brand_video
21. September 2026 02:58
Hinzugefügt
upload_brand_video
21. September 2026 02:58
Hinzugefügt
list_brand_videos
21. September 2026 02:58
Hinzugefügt
buy_credits
21. September 2026 02:58
Hinzugefügt
list_posts
21. September 2026 02:58
Hinzugefügt
get_performance
21. September 2026 02:58
Hinzugefügt
list_media
21. September 2026 02:58
Hinzugefügt
delete_person
21. September 2026 02:58
Hinzugefügt
add_person
21. September 2026 02:58
Hinzugefügt
list_people
21. September 2026 02:58
Hinzugefügt
mascot_step
21. September 2026 02:58
Hinzugefügt
create_mascot
21. September 2026 02:58
Hinzugefügt
get_mascot
21. September 2026 02:58
Hinzugefügt
upload_logo
21. September 2026 02:58
Geändert
get_brand_dna
21. September 2026 02:58
Geändert
render_asset
21. September 2026 02:58
Geändert
list_films
21. September 2026 02:58
Geändert
create_campaign
21. September 2026 02:58
Geändert
get_run
21. September 2026 02:58
Geändert
list_runs
21. September 2026 02:58
Geändert
post_run
19. September 2026 02:49
Hinzugefügt
upload_media
19. September 2026 02:49
Geändert
render_asset
19. September 2026 02:49
Hinzugefügt
describe_film
19. September 2026 02:49
Entdecken
Ähnliche MCP-Server
ai-content-drop
com.aicontentdrop/ai-content-drop
Generates AI images, videos, UGC clips, avatars, and finished ads, while organizing creative assets and campaign boards.
Picorn
io.github.cueqzapper/picorn
Creates and edits layered social images, videos, slideshows, vector assets, and marketing projects with persistent editable canva…
Create Web Page
com.create-web-page/create-web-page
Creates, edits, previews, publishes, and manages hosted link-in-bio and landing pages with configurable content blocks, themes, m…
Postclick by PPC.io: Landing Page CRO
io.ppc/postclick-landing-page-cro
Audits landing pages, analyzes buyers and objections, generates copy and design concepts, builds HTML pages, and exports or share…
MagicScreenshots
io.github.Humanleap/magicscreenshots-mcp
Searches App Store screenshot references and preview videos, and supports screenshot restyling and localization jobs.
WebZum - The Hosting Layer for AI-Generated Web Content
io.github.suprraz/webzum
Creates, edits, clones, and hosts live HTML/CSS/JS websites, including SEO-focused business and lead-generation pages.
Dali by Lulu
io.github.Lulu-The-Narwhal/dali
Scores and improves creative prompts and advertising images using generation-target analysis, community patterns, performance ben…
uxgen
ai.uxgen/ecommerce-conversion
Audits and assembles ecommerce pages, generates product imagery and packshots, supports Shopify sections, and provides SEO and co…