ai.mysiren/siren

Est-ce que ai.mysiren/siren est sûr ?

Au dernier audit MCP Hub, le serveur MCP « ai.mysiren/siren » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 44 outils

• add_person≈ 252 tokens

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

  Paramètres, retour & exemple (5)

  Paramètres

  • name · string · optionnel
    The person's name.
  • role · string · optionnel
    Their role, e.g. Founder, Head of Design.
  • team · string · optionnel
    Their team, if any.
  • image_url · ? · optionnel
    Public https URL of a portrait (PNG, JPG or WebP), one face.
  • image_base64 · ? · optionnel
    The portrait as base64, if you have no URL.

  Exemple d'appel

  {"name": "add_person", "arguments": {"name": "texte", "role": "texte", "team": "texte", "image_url": "texte", "image_base64": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• buy_credits≈ 203 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • credits · ? · optionnel
    Or a custom amount, 50 to 5000, at $0.20 each.
  • pack_id · ? · optionnel
    small (50 credits, $9.99), medium (100, $20) or large (300, $50).

  Exemple d'appel

  {"name": "buy_credits", "arguments": {"credits": "texte", "pack_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• clarify_brief≈ 168 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • brief · string · requis
    Plain-language request for the post, e.g. "announce the new export feature, use the dashboard screenshot".

  Exemple d'appel

  {"name": "clarify_brief", "arguments": {"brief": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_campaign≈ 1476 tokens

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

  Paramètres, retour & exemple (14)

  Paramètres

  • brand · ? · optionnel
    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 · string · requis
    Plain-language request for the post, e.g. "announce the new export feature, use the dashboard screenshot".
  • media · ? · optionnel
    Films: URLs from upload_media (images and videos) for the film to show. Omit and the film shows the brand's recent work. Images (asset_type=card): photos from upload_media are painted into the creative as given, placed where the brief says ("our mug in the top-left"); videos are refused for images.
  • music · ? · optionnel
    Films: a music bed track_id. Omit and the bed follows the film and the direction.
  • caption · ? · optionnel
    Optional caption for the post this run becomes. Your words are kept; omit and Siren writes the caption.
  • channel · ? · optionnel
    Omit to cut one render per connected platform, up to the credit balance and the plan cap (Spark stops at 2). Pass twitter, instagram, linkedin, tiktok, or youtube for a single cut. A shape named in the brief wins: square, vertical, portrait, story, wide, landscape, 4:5, 9:16, 16:9.
  • timezone · string · optionnel
    IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York.
  • variants · integer · optionnel
    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.
  • direction · ? · optionnel
    Films: one free line on mood, pace, motion and music, e.g. "emotional, slow, soft piano" or "dark, club energy, fast cuts".
  • platforms · ? · optionnel
    Where to post: any of x, instagram, tiktok, linkedin, youtube, or ["everything"] for every connected channel.
  • voiceover · ? · optionnel
    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 · string · optionnel
    What to make: card (still image) or video.
  • output_type · ? · optionnel
    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 · ? · optionnel
    ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone.

  Exemple d'appel

  {"name": "create_campaign", "arguments": {"brief": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_mascot≈ 380 tokens

  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.

  Paramètres, retour & exemple (6)

  Paramètres

  • kind · string · optionnel
    auto (Siren picks from the brand), animal, creature, object, robot, food, or abstract.
  • name · string · optionnel
    The mascot's name, if the human has one.
  • note · string · optionnel
    Describe the character in the human's words: what it is, colours, personality, what to avoid. Up to 280 characters.
  • style · string · optionnel
    Material: vinyl (default), clay, plush, wool, or glossy.
  • image_url · ? · optionnel
    A reference picture of the mascot (https PNG/JPG/WebP). Siren paints it in the brand's style, keeping the character.
  • image_base64 · ? · optionnel
    The reference picture as base64, if you have no URL.

  Exemple d'appel

  {"name": "create_mascot", "arguments": {"kind": "texte", "name": "texte", "note": "texte", "style": "texte", "image_url": "texte", "image_base64": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_brand_video≈ 117 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • video_id · string · requis
    Id from list_brand_videos.

  Exemple d'appel

  {"name": "delete_brand_video", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_media≈ 139 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • url · string · requis
    The URL upload_media returned (or one from list_media).

  Exemple d'appel

  {"name": "delete_media", "arguments": {"url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_person≈ 111 tokens

  Remove a face from the people library.

  Paramètres, retour & exemple (1)

  Paramètres

  • person_id · string · requis
    Id from list_people.

  Exemple d'appel

  {"name": "delete_person", "arguments": {"person_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_product_screen≈ 128 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • screen_id · string · requis
    Id of the brand asset from list_product_screens.

  Exemple d'appel

  {"name": "delete_product_screen", "arguments": {"screen_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• describe_film≈ 185 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • output_type · string · requis
    Film id from list_films, e.g. "story", "pitch", "gallery".

  Exemple d'appel

  {"name": "describe_film", "arguments": {"output_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• edit_asset≈ 331 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • run_id · string · requis
    A finished ad creative (painted still) to change: the run id from create_campaign, get_run or list_runs.
  • instruction · string · requis
    What to change, in plain words: "make her hair pink", "swap the mug for a laptop", "fix the spelling of the headline". Name one or two changes; everything else stays.

  Exemple d'appel

  {"name": "edit_asset", "arguments": {"run_id": "texte", "instruction": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_account≈ 158 tokens

  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; credits are the only meter.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_account", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_brand_dna≈ 175 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_brand_dna", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_mascot≈ 114 tokens

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

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_mascot", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_performance≈ 129 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • window · string · optionnel
    7d, 30d or 90d.

  Exemple d'appel

  {"name": "get_performance", "arguments": {"window": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_run≈ 341 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • run_id · string · requis
    The run id returned by create_campaign, render_asset, or list_runs.

  Exemple d'appel

  {"name": "get_run", "arguments": {"run_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_brand_videos≈ 112 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_brand_videos", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_films≈ 848 tokens

  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. Videos are on every plan; credits are the only limit. 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.

  Paramètres, retour & exemple (11)

  Paramètres

  • all · boolean · optionnel
    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 · ? · optionnel
    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 · ? · optionnel
    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 · integer · optionnel
    Page number, from 1. Each page is page_size films; next_page in the answer says what to call next.
  • aspect · ? · optionnel
    Only films that render this shape: wide-desktop, square-ig, story-reel, vertical-ig-feed.
  • detail · string · optionnel
    "short" (default) or "full" to add the long description per film.
  • search · ? · optionnel
    Find films by word across ids, names and descriptions, e.g. "phone", "chat", "mascot", "halftone". Every word must match.
  • narrated · ? · optionnel
    true = only films with a voice-over part; false = only music-and-motion films.
  • for_brand · ? · optionnel
    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).
  • page_size · integer · optionnel
    Films per page, 1 to 25.
  • max_seconds · ? · optionnel
    Only films this long or shorter, e.g. 15 for a short feed post.

  Exemple d'appel

  {"name": "list_films", "arguments": {"all": true, "job": "texte", "goal": "texte", "page": 1, "aspect": "texte", "detail": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_media≈ 108 tokens

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

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_media", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_people≈ 106 tokens

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

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_people", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_platinum_films≈ 235 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_platinum_films", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_posts≈ 153 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    How many posts, 1 to 200. Newest first.
  • offset · integer · optionnel
    Skip this many, to page back.

  Exemple d'appel

  {"name": "list_posts", "arguments": {"limit": 1, "offset": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_product_screens≈ 128 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_product_screens", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_runs≈ 175 tokens

  List the workspace's generation runs (newest first): status, brief, channel, asset URLs, and caption. Page with offset to see them all.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    How many runs to return, 1 to 50. Newest first.
  • offset · integer · optionnel
    Skip this many runs, to page back through every video and image the workspace has made.

  Exemple d'appel

  {"name": "list_runs", "arguments": {"limit": 1, "offset": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_styles≈ 521 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

  • all · boolean · optionnel
    true = every style that passes the filters on one page. Prefer section + page, or the styles.md file.
  • goal · ? · optionnel
    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 · integer · optionnel
    Page number, from 1. next_page in the answer says what to call next.
  • aspect · ? · optionnel
    Only styles that paint on this shape: square-ig, vertical-ig-feed, story-reel, wide-desktop.
  • search · ? · optionnel
    Find styles by word in their id or when-to-pick line, e.g. "comic", "receipt", "billboard".
  • section · ? · optionnel
    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 · integer · optionnel
    Styles per page, 1 to 25.

  Exemple d'appel

  {"name": "list_styles", "arguments": {"all": true, "goal": "texte", "page": 1, "aspect": "texte", "search": "texte", "section": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• mascot_step≈ 270 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • note · string · optionnel
    For retry: what to change this time.
  • label · string · optionnel
    For pose: the pose in a few words, e.g. waving, holding a phone.
  • action · string · requis
    keep = build the pose sheet from this hero; retry = paint the hero again; pose = add one more pose to a built mascot.
  • prompt · string · optionnel
    For pose: extra detail for the pose.
  • with_model · boolean · optionnel
    For pose: also make a 3D model of it (20 credits instead of 10).

  Exemple d'appel

  {"name": "mascot_step", "arguments": {"action": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• post_run≈ 319 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • run_id · string · requis
    The run id returned by create_campaign, render_asset, or list_runs.
  • caption · ? · optionnel
    Optional caption for this publish; goes out verbatim. Omit and Siren writes it.
  • platform · string · optionnel
    Connected channel to post to: x, instagram, tiktok, linkedin, or youtube.

  Exemple d'appel

  {"name": "post_run", "arguments": {"run_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• render_asset≈ 617 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • name · ? · optionnel
    Human-readable name for the asset or run.
  • items · array · requis
    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}.

  Exemple d'appel

  {"name": "render_asset", "arguments": {"items": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• schedule_post≈ 384 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • run_id · string · requis
    The run id returned by create_campaign, render_asset, or list_runs.
  • captions · ? · optionnel
    Optional caption override per platform, e.g. {"x": "...", "linkedin": "..."}.
  • timezone · string · optionnel
    IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York.
  • platforms · ? · optionnel
    Where to post: any of x, instagram, tiktok, linkedin, youtube, or ["everything"] for every connected channel.
  • scheduled_at · string · requis
    ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone.

  Exemple d'appel

  {"name": "schedule_post", "arguments": {"run_id": "texte", "scheduled_at": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_automate≈ 285 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · requis
    Name for this automation profile.
  • caption · ? · optionnel
    Default caption for auto-posted cards.
  • delivery · ? · optionnel
    Optional delivery: {social_account_ids?, telegram?, discord?}.
  • output_types · array · requis
    Studio types this profile may render.

  Exemple d'appel

  {"name": "studio_automate", "arguments": {"name": "texte", "output_types": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_card≈ 396 tokens

  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.

  Paramètres, retour & exemple (8)

  Paramètres

  • body · object · requis
    Card fields for that type (amount, productName, …).
  • post · boolean · optionnel
    If true, post the finished card to a connected account. Confirm with the user first.
  • theme · ? · optionnel
    dark or light. Omit to use the workspace default.
  • accent · ? · optionnel
    Hex accent, e.g. #5B82FF.
  • aspect · ? · optionnel
    Canvas aspect, e.g. square-ig or wide-twitter.
  • caption · ? · optionnel
    Caption when posting.
  • platform · string · optionnel
    Connected channel if post is true: x, instagram, tiktok, linkedin, or youtube.
  • output_type · string · requis
    One of the 33 Studio types from studio_templates, e.g. sale-notification.

  Exemple d'appel

  {"name": "studio_card", "arguments": {"body": {}, "output_type": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_edit≈ 303 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • text · string · requis
    The change, in plain words: "shorter hook", "show the timer first", "use our orange", "make it vertical". May be empty when attachments say it all.
  • thread_id · string · requis
    The thread id from studio_start or studio_threads.
  • attachments · ? · optionnel
    Optional files to use: URLs from upload_media (a screenshot to show, a logo to put in, a reference). Up to 6.

  Exemple d'appel

  {"name": "studio_edit", "arguments": {"text": "texte", "thread_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_export≈ 236 tokens

  Render a Studio design or video to files. Spends credits like any render: a video 25 (platinum 50), a card 10, a set 10 a slide (an App Store set of 6 is 60), charged once. A card or a set waits for 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 is terminal, then show the human the file or post it with post_run.

  Paramètres, retour & exemple (2)

  Paramètres

  • version · ? · optionnel
    Version to render. Omit for the current one.
  • thread_id · string · requis
    The thread id.

  Exemple d'appel

  {"name": "studio_export", "arguments": {"thread_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_get≈ 126 tokens

  One Studio video: the chat so far (who said what, with diffs), every version, and which version is current.

  Paramètres, retour & exemple (1)

  Paramètres

  • thread_id · string · requis
    The thread id.

  Exemple d'appel

  {"name": "studio_get", "arguments": {"thread_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_schedule≈ 273 tokens

  Render a Studio card then queue a ScheduledPost at scheduled_at.

  Paramètres, retour & exemple (6)

  Paramètres

  • body · object · requis
    Card fields for that type.
  • caption · ? · optionnel
    Caption for the scheduled post.
  • timezone · string · optionnel
    IANA timezone for scheduled_at.
  • platforms · ? · optionnel
    x, instagram, tiktok, linkedin, youtube, or everything.
  • output_type · string · requis
    Studio type to render.
  • scheduled_at · string · requis
    ISO-8601 time to post.

  Exemple d'appel

  {"name": "studio_schedule", "arguments": {"body": {}, "output_type": "texte", "scheduled_at": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_start≈ 366 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • prompt · string · requis
    What to make, in plain words: "an App Store preview for our timer app, calm, show the station picker first". An App Store link works too.
  • surface · ? · optionnel
    Optional shape: story-reel (9:16), square-ig, wide-desktop (16:9).
  • template · ? · optionnel
    Optional film id to start from (list_films names them). Omit and the director picks.
  • attachments · ? · optionnel
    Optional files Siren reads and uses: URLs from upload_media (app screenshots, a logo, a reference picture, a short screen recording). Up to 6.

  Exemple d'appel

  {"name": "studio_start", "arguments": {"prompt": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_templates≈ 112 tokens

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

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "studio_templates", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• studio_threads≈ 107 tokens

  The workspace's Studio videos, newest first: title, shelf, current version, and whether a human or an agent started it.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "studio_threads", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_brand_dna≈ 204 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • fields · object · requis
    Brand DNA keys to change, e.g. {"tagline": "...", "offer": {"one_liner": "..."}}. Nested bags merge.

  Exemple d'appel

  {"name": "update_brand_dna", "arguments": {"fields": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_product_screen≈ 436 tokens

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

  Paramètres, retour & exemple (8)

  Paramètres

  • kind · ? · optionnel
    Free-text kind: product photo, dashboard screenshot, packaging, logo, team photo.
  • name · ? · optionnel
    Human-readable name for the asset or run.
  • theme · ? · optionnel
    UI theme in the screenshot: light, dark, or unknown.
  • device · ? · optionnel
    Device the screenshot was taken on: phone, tablet, desktop, or none.
  • use_when · ? · optionnel
    When Siren should reach for this asset, e.g. "any post about the analytics page".
  • screen_id · string · requis
    Id of the brand asset from list_product_screens.
  • description · ? · optionnel
    What the picture shows and what it is for, in your words. When set, Siren files the asset without reading it.
  • screen_type · ? · optionnel
    Screen role: feature, hero, onboarding, settings, or marketing.

  Exemple d'appel

  {"name": "update_product_screen", "arguments": {"screen_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• upload_brand_video≈ 406 tokens

  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.

  Paramètres, retour & exemple (6)

  Paramètres

  • url · ? · optionnel
    Public https URL of the clip (MP4, MOV or WebM, up to 200 MB and 5 minutes).
  • name · string · optionnel
    Human-readable name, e.g. "checkout demo".
  • tags · ? · optionnel
    Short lowercase search words.
  • base64 · ? · optionnel
    The clip bytes as base64, if you have no URL.
  • use_when · ? · optionnel
    When a film should play it, e.g. "any film about checkout".
  • description · ? · optionnel
    What the clip shows, in your words. When set, Siren files it without reading it.

  Exemple d'appel

  {"name": "upload_brand_video", "arguments": {"url": "texte", "name": "texte", "tags": "texte", "base64": "texte", "use_when": "texte", "description": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• upload_logo≈ 206 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • variant · string · optionnel
    light = the mark used on light backgrounds (the usual one); dark = the one for dark backgrounds.
  • image_url · ? · optionnel
    Public https URL of the logo (PNG, JPG or WebP).
  • image_base64 · ? · optionnel
    The logo bytes as base64, if you have no URL.

  Exemple d'appel

  {"name": "upload_logo", "arguments": {"variant": "texte", "image_url": "texte", "image_base64": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• upload_media≈ 298 tokens

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

  Paramètres, retour & exemple (4)

  Paramètres

  • url · ? · optionnel
    Public https URL of the photo or video to store. Pass this or base64.
  • kind · string · optionnel
    auto (default), image, or video. Detected from the bytes when auto.
  • name · string · optionnel
    Human-readable name for the file.
  • base64 · ? · optionnel
    The media bytes as base64, if you have no URL. Pass this or url.

  Exemple d'appel

  {"name": "upload_media", "arguments": {"url": "texte", "kind": "texte", "name": "texte", "base64": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• upload_product_screen≈ 669 tokens

  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.

  Paramètres, retour & exemple (10)

  Paramètres

  • kind · ? · optionnel
    Free-text kind: product photo, dashboard screenshot, packaging, logo, team photo.
  • name · string · optionnel
    Human-readable name for the asset or run.
  • tags · ? · optionnel
    Short lowercase tags for search, e.g. ["dashboard", "dark-mode"].
  • theme · string · optionnel
    UI theme in the screenshot: light, dark, or unknown.
  • device · string · optionnel
    Device the screenshot was taken on: phone, tablet, desktop, or none.
  • use_when · ? · optionnel
    When Siren should reach for this asset, e.g. "any post about the analytics page".
  • image_url · ? · optionnel
    Public https URL of a PNG, JPG, or WebP to store as a brand asset.
  • description · ? · optionnel
    What the picture shows and what it is for, in your words. When set, Siren files the asset without reading it.
  • screen_type · string · optionnel
    Screen role: feature, hero, onboarding, settings, or marketing.
  • image_base64 · ? · optionnel
    The image bytes as base64, if you have no URL.

  Exemple d'appel

  {"name": "upload_product_screen", "arguments": {"kind": "texte", "name": "texte", "tags": "texte", "theme": "texte", "device": "texte", "use_when": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://mcp.mysiren.ai/mcp