Server definition
- Hash
- sha256:5d2826c584348ffb172541fc93cd60b85f8a3d2d4eda8f32410959c343760452
- What it is
- What a remote MCP server returned when asked what it offers: 38 tools
The blob, as servednamed by its sha256
{
"instructions": "Siren is the customer's deterministic marketing engine: one brief becomes on-brand images, videos, and posts. Call get_account first to learn the plan and scopes, then get_brand_dna and fix what its checks name (thin Brand DNA makes generic films). Browse films with list_films, then describe_film for a film's body contract. Films are 25 credits; platinum films (list_platinum_films, ids end in -plt) are 50 and only for a big launch the human wants to go far. create_campaign runs the full pipeline; poll get_run until status is terminal, waiting poll_after_seconds between polls. Pass scheduled_at (ISO-8601) on create_campaign to queue a post when the render finishes. schedule_post queues a finished run. post_run queues a live publish behind a short window (about two minutes); poll get_run after it fires and read posts[].url for the permalink. Sequential platforms: X, LinkedIn, Instagram, TikTok, YouTube. Always confirm live posts with the user first. Full manual with copy-paste prompts: https://mcp.mysiren.ai/skill.md. Credit or plan errors come back structured; relay them verbatim.",
"tools": [
{
"description": "Add a face to the people library. Siren crops it round in a few\nseconds (status cropping, then ready). Only upload people who agreed.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"image_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The portrait as base64, if you have no URL."
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public https URL of a portrait (PNG, JPG or WebP), one face."
},
"name": {
"default": "",
"description": "The person's name.",
"type": "string"
},
"role": {
"default": "",
"description": "Their role, e.g. Founder, Head of Design.",
"type": "string"
},
"team": {
"default": "",
"description": "Their team, if any.",
"type": "string"
}
},
"type": "object"
},
"name": "add_person",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Get a Stripe checkout link for more credits. Give the link to the\nhuman; they pay on Stripe and the credits land in about a minute.\nNothing is charged by this call. Read the balance on get_account.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"credits": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Or a custom amount, 50 to 5000, at $0.20 each."
},
"pack_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "small (50 credits, $9.99), medium (100, $20) or large (300, $50)."
}
},
"type": "object"
},
"name": "buy_credits",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Ask Siren's clarifier whether a brief is specific enough to\ngenerate from. Returns ready=true/false plus follow-up questions.\nUse before create_campaign when the user's request is vague.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"brief": {
"description": "Plain-language request for the post, e.g. \"announce the new export feature, use the dashboard screenshot\".",
"type": "string"
}
},
"required": [
"brief"
],
"type": "object"
},
"name": "clarify_brief",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Create a Siren campaign from a plain-language brief — the full\npipeline: plan, on-brand copy, deterministic render, verify. Returns\nthe run; poll get_run until it finishes. Spends credits (image 10,\nvideo 25; voice or music-only is the same 25). Pass output_type to\npin a film (list_films has the catalog); omit it and Siren picks.\nOptional scheduled_at (ISO-8601)\nqueues a sequential post (X → Instagram → TikTok, or platforms you\npass) when the render succeeds — requires Allow posting. Fails with\na 402 upgrade message if the plan or balance can't cover it.\n\nFILM KNOBS: voiceover (true narrated / false music only), direction\n(mood, pace, motion, music in one line), music (a bed id), media\n(upload_media URLs the film shows). Images ignore the film knobs:\nSiren writes and paints them from the brief and Brand DNA.\n\nANY BRAND: pass `brand` to make it for a brand that is not this\nworkspace's own, e.g. brand={\"name\": \"Acme\", \"site\": \"acme.com\",\n\"logo_url\": \"https://acme.com/logo.png\", \"primary\": \"#FF4400\"}.\nNothing of this workspace's identity leaks in.\n\nThe exact same request within 24 hours returns the run it already\nstarted, as it is now, with replayed=true and no new charge. Change\nthe brief to make another.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"asset_type": {
"default": "card",
"description": "What to make: card (still image) or video.",
"type": "string"
},
"brand": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Make it for ANOTHER brand instead of this workspace's own (a client, a brand people recognise, a side project). Object: {name (required), site, logo_url (https PNG/SVG/JPG of the brand's MARK or app icon, e.g. Duolingo's owl, not the wordmark: the film sets the name in type), accent (hex: the brand's signature colour, the one films are painted in), primary (hex: its dark or ink colour), secondary, tagline, font (the brand's typeface name, e.g. Nunito), x_handle, sells (one line: what they make)}. Clean slate: none of this workspace's logo, colours, mascot, font, handle, screenshots or memory is used; only what you send. 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": {
"description": "Plain-language request for the post, e.g. \"announce the new export feature, use the dashboard screenshot\".",
"type": "string"
},
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caption for the post this run becomes. Your words are kept; omit and Siren writes the caption."
},
"channel": {
"default": "twitter",
"description": "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.",
"type": "string"
},
"direction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Films: one free line on mood, pace, motion and music, e.g. \"emotional, slow, soft piano\" or \"dark, club energy, fast cuts\"."
},
"media": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Films: URLs from upload_media (images and videos) for the film to show. Omit and the film shows the brand's recent work. Images: not used; add pictures to Brand DNA with upload_product_screen instead."
},
"music": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Films: a music bed track_id. Omit and the bed follows the film and the direction."
},
"output_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional film to pin, e.g. \"story\" or \"pitch\". Call list_films to browse; describe_film for the contract. Omit and Siren picks the format from the brief."
},
"platforms": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Where to post: any of x, instagram, tiktok, linkedin, youtube, or [\"everything\"] for every connected channel."
},
"scheduled_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone."
},
"timezone": {
"default": "UTC",
"description": "IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York.",
"type": "string"
},
"voiceover": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"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."
}
},
"required": [
"brief"
],
"type": "object"
},
"name": "create_campaign",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Start the brand mascot: from a description (note, kind) or from a\nreference picture. Paid plans; 100 credits. Siren paints a hero in\nabout a minute; poll get_mascot, show the human, then mascot_step\nkeep (build the pose sheet) or retry (paint again, 3 tries). One\nmascot per workspace.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"image_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The reference picture as base64, if you have no URL."
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "A reference picture of the mascot (https PNG/JPG/WebP). Siren paints it in the brand's style, keeping the character."
},
"kind": {
"default": "auto",
"description": "auto (Siren picks from the brand), animal, creature, object, robot, food, or abstract.",
"type": "string"
},
"name": {
"default": "",
"description": "The mascot's name, if the human has one.",
"type": "string"
},
"note": {
"default": "",
"description": "Describe the character in the human's words: what it is, colours, personality, what to avoid. Up to 280 characters.",
"type": "string"
},
"style": {
"default": "vinyl",
"description": "Material: vinyl (default), clay, plush, wool, or glossy.",
"type": "string"
}
},
"type": "object"
},
"name": "create_mascot",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Remove a clip from Brand DNA, file and poster included.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"video_id": {
"description": "Id from list_brand_videos.",
"type": "string"
}
},
"required": [
"video_id"
],
"type": "object"
},
"name": "delete_brand_video",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Delete one photo or video uploaded with upload_media. Only this\nworkspace's uploads; a film that already rendered keeps its copy.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"url": {
"description": "The URL upload_media returned (or one from list_media).",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "delete_media",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Remove a face from the people library.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"person_id": {
"description": "Id from list_people.",
"type": "string"
}
},
"required": [
"person_id"
],
"type": "object"
},
"name": "delete_person",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Remove a product screenshot from Brand DNA. Does not delete Brand Memory.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"screen_id": {
"description": "Id of the brand asset from list_product_screens.",
"type": "string"
}
},
"required": [
"screen_id"
],
"type": "object"
},
"name": "delete_product_screen",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "The full contract for one film: what it is and when to hire it, its\nbody JSON Schema, a reference body, the seed envelope, media slots\n(which fields take image/video URLs), the brand prefills (colours,\nlogo, screens) and the override rules. Call it before writing a\nrender_asset body.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"output_type": {
"description": "Film id from list_films, e.g. \"story\", \"pitch\", \"gallery\".",
"type": "string"
}
},
"required": [
"output_type"
],
"type": "object"
},
"name": "describe_film",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Get the connected Siren workspace: plan, key scopes, auto-post\nsetting, and daily limit. Call this first to learn what the account\ncan do before generating. Empty asset_types / channels /\nconnected_accounts lists mean UNRESTRICTED, not missing — never stop\non them. Films render on every plan; credits are the only meter.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_account",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Get this workspace's Brand DNA: brand_name, brand_kind, overview,\ntagline, offer, features, products, audience, palette, logos, plus\n`checks`: what to fix before rendering (thin Brand DNA, a typed\naccent the brand's own work does not use). Call right after\nget_account; fix thin DNA first with update_brand_dna and\nupload_product_screen, or ask the human for the site. Not Brand\nMemory.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_brand_dna",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "The workspace mascot: status (hero, keeping, frames, ready), the\nhero picture, tries left, and every pose frame with its URL. Null\nmascot = none yet.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_mascot",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "How the posts did: totals (impressions, engagement, replies,\nengagement rate) and the top posts with views, likes and replies.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"window": {
"default": "30d",
"description": "7d, 30d or 90d.",
"type": "string"
}
},
"type": "object"
},
"name": "get_performance",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Get one run by id — full status, output text, asset URLs,\ncaption, and any error. Poll this after create_campaign\nor render_asset until status is terminal. Wait `poll_after_seconds`\nbetween polls; `progress` and `eta_seconds` say how far along it is.\nA finished film carries `film_check`, advice only: when `ok` is\nfalse, show the human the video and the findings and let them decide.\nRe-render at most once, and only for a defect you can name in what you\nsent (a missing image, a wrong name). `notices` are plain-words notes\non the request (e.g. it asked for a mood the brand's look does not\nwear): the asset is made as asked; pass the note to the human. A\nfinished run carries `caption`: the post caption Siren wrote in the\nrun's brand (or yours, if you passed one); show it with the asset. After\npost_run, `posts[]` carries each platform's status and, once it\nfires, the live URL and the caption that went out.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"run_id": {
"description": "The run id returned by create_campaign, render_asset, or list_runs.",
"type": "string"
}
},
"required": [
"run_id"
],
"type": "object"
},
"name": "get_run",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "The brand's own clips in Brand DNA: name, what each shows, when to\nuse it, tags, best moments with timestamps, poster and scan_status.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_brand_videos",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "The film library, one ranked page at a time. Films sit on job\nshelves; pass job and the human's goal and hire from the top of the\npage. Each film says what it is, when to hire it, its length and\nshapes, fits_this_brand (with what is missing) and made_recently\n(this brand already got it: prefer another film on the shelf unless\nthe human asked for that one). Page on with next_page. Want it all at\nonce? all=true, or fetch the catalog file (https://api.mysiren.ai/api/v1/films.md,\nevery film by shelf, also .txt/.json) and read it in steps. search=\nfinds films by word. Then describe_film for the body. Videos are on every plan;\ncredits are the only limit. Every film here is 25 credits. Platinum films (50 credits) are\nnot in these pages: the answer's platinum section flags them, and\nlist_platinum_films has the shelf.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"all": {
"default": false,
"description": "true = every film that passes the filters on one page (about 10k tokens for the whole library). Prefer job + page, or the catalog.md file.",
"type": "boolean"
},
"aspect": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only films that render this shape: wide-desktop, square-ig, story-reel, vertical-ig-feed."
},
"detail": {
"default": "short",
"description": "\"short\" (default) or \"full\" to add the long description per film.",
"type": "string"
},
"goal": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The human's own words for the outcome, e.g. \"launch video for our new AI agent\" or \"show our 10k users\". Ranks the films by fit."
},
"job": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The shelf: launch, feature (one feature or update), explain (what the product does), brand (story, manifesto, mood), ai (AI or agent product), proof (a number, testimonials), app (mobile app), shop (products, food, property), people (team or mascot). Omit to rank the whole library."
},
"max_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Only films this long or shorter, e.g. 15 for a short feed post."
},
"narrated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "true = only films with a voice-over part; false = only music-and-motion films."
},
"page": {
"default": 1,
"description": "Page number, from 1. Each page is page_size films; next_page in the answer says what to call next.",
"type": "integer"
},
"page_size": {
"default": 8,
"description": "Films per page, 1 to 25.",
"type": "integer"
},
"search": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Find films by word across ids, names and descriptions, e.g. \"phone\", \"chat\", \"mascot\", \"halftone\". Every word must match."
}
},
"type": "object"
},
"name": "list_films",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Photos and videos uploaded with upload_media, newest first, with\ntheir URLs. Reuse a URL in create_campaign media or a film body.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_media",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "The people library: team faces Siren can put in stills (name,\nrole, team, status cropping or ready, round crop URL).",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_people",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "The platinum shelf: studio-grade films that match a top motion\nstudio's craft, told as the brand's own story. Each costs 50 credits,\nevery time (a normal film is 25). Offer one only when the human is\nmaking a big launch they genuinely want to go far; everyday posts and\nnormal budgets use list_films. Say the price before you render. Ids end\nin -plt. Platinum needs a paid plan or a credit top-up: a complimentary\nplan sees it but gets 402 platinum_needs_paid_plan. voice MM = motion and music only (no voice-over question, no\nnarration); MVM = motion, voice and music. Then describe_film for the\nbody, same as any film.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_platinum_films",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Every post Siren sent or queued: platform, status, live URL, time,\nand counts by status (posted, queued, failed).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 50,
"description": "How many posts, 1 to 200. Newest first.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Skip this many, to page back.",
"type": "integer"
}
},
"type": "object"
},
"name": "list_posts",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List the brand assets in Brand DNA: product photos, app screenshots,\npackaging. Each row has name, kind, description, use_when, tags,\nscan_status (scanning / ready / failed), device, theme, url.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_product_screens",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List the workspace's generation runs (newest first): status, brief,\nchannel, asset URLs, and caption. Page with offset to see them all.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"description": "How many runs to return, 1 to 50. Newest first.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Skip this many runs, to page back through every video and image the workspace has made.",
"type": "integer"
}
},
"type": "object"
},
"name": "list_runs",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "The still style library, one ranked page at a time. Every painted\nstill (an ad creative, poster, launch card, App Store frame,\nthumbnail) is one style; Siren picks one when you don't. Styles sit\non section shelves; pass section and the human's goal and take one\nfrom the top. made_recently = this brand already got that look,\nprefer another. To paint in a style, put its id in the\ncreate_campaign brief (asset_type card). The whole library as one\nfile: https://api.mysiren.ai/api/v1/styles.md (also .txt/.json).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"all": {
"default": false,
"description": "true = every style that passes the filters on one page. Prefer section + page, or the styles.md file.",
"type": "boolean"
},
"aspect": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only styles that paint on this shape: square-ig, vertical-ig-feed, story-reel, wide-desktop."
},
"goal": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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": {
"default": 1,
"description": "Page number, from 1. next_page in the answer says what to call next.",
"type": "integer"
},
"page_size": {
"default": 8,
"description": "Styles per page, 1 to 25.",
"type": "integer"
},
"search": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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": null,
"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."
}
},
"type": "object"
},
"name": "list_styles",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Move the mascot on: keep the hero, paint it again, or add a pose.\nAsk the human before keep, since it builds the whole sheet.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "keep = build the pose sheet from this hero; retry = paint the hero again; pose = add one more pose to a built mascot.",
"type": "string"
},
"label": {
"default": "",
"description": "For pose: the pose in a few words, e.g. waving, holding a phone.",
"type": "string"
},
"note": {
"default": "",
"description": "For retry: what to change this time.",
"type": "string"
},
"prompt": {
"default": "",
"description": "For pose: extra detail for the pose.",
"type": "string"
},
"with_model": {
"default": false,
"description": "For pose: also make a 3D model of it (20 credits instead of 10).",
"type": "boolean"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "mascot_step",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Post a finished run's assets to the workspace's CONNECTED SOCIAL\nACCOUNT. This is live, public distribution on the customer's channel\n— always confirm with the user before calling. Only works if the\ngrant was authorised with posting allowed. Pass `caption` to own the\nwords; it goes out verbatim. The call queues the post behind a short\npublish window (about two minutes, cancellable) rather than firing\ninline: poll get_run after that and read `posts[].url` for the live\npermalink and the caption that went out.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caption for this publish; goes out verbatim. Omit and Siren writes it."
},
"platform": {
"default": "x",
"description": "Connected channel to post to: x, instagram, tiktok, linkedin, or youtube.",
"type": "string"
},
"run_id": {
"description": "The run id returned by create_campaign, render_asset, or list_runs.",
"type": "string"
}
},
"required": [
"run_id"
],
"type": "object"
},
"name": "post_run",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Render films from pre-formed SirenSeed bodies (advanced). FILMS ONLY:\nimages are painted from a brief, so for any image, ad or creative call\ncreate_campaign with asset_type=card (a still here returns 422\nstills_use_a_brief). Each item: {output_type, channel,\nseed_body, archetype?, family?, surface?, caption?, voice_id?,\nmusic?, direction?, brand_override?}. Prefer create_campaign unless\nthe user has concrete seed JSON. Returns run ids, `estimated_seconds`\nand `poll_after_seconds`; wait that long, then get_run.\n\nTHE DIRECTOR: every film body is edited against Brand DNA before it\nrenders. It keeps the film and your brand-specific lines, rewrites\nempty, generic or reference-body copy, and never touches media.\n`director` in the response says what changed. `direction` is a free\nline (\"dark, club energy, fast\") that steers words, pace and music.\nA film that cannot use what you sent returns 422 film_does_not_fit\nwith a `fix` and `films_that_fit`.\n\nANY BRAND: put brand_override={\"name\": \"Acme\", \"site\": \"acme.com\",\n\"logo_url\": \"https://acme.com/logo.png\", \"primary\": \"#FF4400\",\n\"accent\": \"#111111\"} on an item to render it for a brand that is not\nthis workspace's own. With a name it is a clean slate: none of this\nworkspace's logo, mascot, font, handle, screenshots or stills are used.\nMedia slots take only URLs you uploaded with upload_media.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"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}.",
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable name for the asset or run."
}
},
"required": [
"items"
],
"type": "object"
},
"name": "render_asset",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Schedule a finished run to post at scheduled_at (ISO-8601).\nShows in the customer's local timezone. platforms: x, instagram,\ntiktok, linkedin, youtube, or everything. Posts fire sequentially.\nRequires Allow posting. Prefer this over post_run when the user\nnames a time. On create_campaign you can pass scheduled_at instead.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"captions": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caption override per platform, e.g. {\"x\": \"...\", \"linkedin\": \"...\"}."
},
"platforms": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Where to post: any of x, instagram, tiktok, linkedin, youtube, or [\"everything\"] for every connected channel."
},
"run_id": {
"description": "The run id returned by create_campaign, render_asset, or list_runs.",
"type": "string"
},
"scheduled_at": {
"description": "ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone.",
"type": "string"
},
"timezone": {
"default": "UTC",
"description": "IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York.",
"type": "string"
}
},
"required": [
"run_id",
"scheduled_at"
],
"type": "object"
},
"name": "schedule_post",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Create a Studio profile on this API key. Returns generate curl and\ninbound hook URLs (Stripe, GitHub, Uptime Kuma, Product Hunt, generic).\nPassing delivery.social_account_ids turns on social delivery for the\nprofile — that publishes, so it requires Allow posting.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Default caption for auto-posted cards."
},
"delivery": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional delivery: {social_account_ids?, telegram?, discord?}."
},
"name": {
"description": "Name for this automation profile.",
"type": "string"
},
"output_types": {
"description": "Studio types this profile may render.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"name",
"output_types"
],
"type": "object"
},
"name": "studio_automate",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Render a Studio data card from a type + body. Deterministic React,\nno paint. Optional live post after render. Returns run_id, image url,\nand post url when posted.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"accent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Hex accent, e.g. #5B82FF."
},
"aspect": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Canvas aspect, e.g. square-ig or wide-twitter."
},
"body": {
"additionalProperties": true,
"description": "Card fields for that type (amount, productName, …).",
"type": "object"
},
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Caption when posting."
},
"output_type": {
"description": "One of the 33 Studio types from studio_templates, e.g. sale-notification.",
"type": "string"
},
"platform": {
"default": "x",
"description": "Connected channel if post is true: x, instagram, tiktok, linkedin, or youtube.",
"type": "string"
},
"post": {
"default": false,
"description": "If true, post the finished card to a connected account. Confirm with the user first.",
"type": "boolean"
},
"theme": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "dark or light. Omit to use the workspace default."
}
},
"required": [
"output_type",
"body"
],
"type": "object"
},
"name": "studio_card",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Render a Studio card then queue a ScheduledPost at scheduled_at.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": true,
"description": "Card fields for that type.",
"type": "object"
},
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Caption for the scheduled post."
},
"output_type": {
"description": "Studio type to render.",
"type": "string"
},
"platforms": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "x, instagram, tiktok, linkedin, youtube, or everything."
},
"scheduled_at": {
"description": "ISO-8601 time to post.",
"type": "string"
},
"timezone": {
"default": "UTC",
"description": "IANA timezone for scheduled_at.",
"type": "string"
}
},
"required": [
"output_type",
"body",
"scheduled_at"
],
"type": "object"
},
"name": "studio_schedule",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "List Siren Studio's 33 React data-card types with family, description,\nand body schema. Use this before studio_card so the body matches.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "studio_templates",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Patch Brand DNA. Send only keys to change. Nested bags (offer,\nproduct_map, icp) merge. Examples: {tagline, overview,\noffer: {product_name, one_liner, features, who_its_for, primary_cta},\nproduct_map: {offerings, how_we_work}, icp: {who_buys, pains}}.\nDoes not read or write Brand Memory.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"fields": {
"additionalProperties": true,
"description": "Brand DNA keys to change, e.g. {\"tagline\": \"...\", \"offer\": {\"one_liner\": \"...\"}}. Nested bags merge.",
"type": "object"
}
},
"required": [
"fields"
],
"type": "object"
},
"name": "update_brand_dna",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Edit an existing brand asset: name, description, kind, use_when,\nand the screenshot tags (screen_type, device, theme).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What the picture shows and what it is for, in your words. When set, Siren files the asset without reading it."
},
"device": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Device the screenshot was taken on: phone, tablet, desktop, or none."
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Free-text kind: product photo, dashboard screenshot, packaging, logo, team photo."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable name for the asset or run."
},
"screen_id": {
"description": "Id of the brand asset from list_product_screens.",
"type": "string"
},
"screen_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Screen role: feature, hero, onboarding, settings, or marketing."
},
"theme": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "UI theme in the screenshot: light, dark, or unknown."
},
"use_when": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When Siren should reach for this asset, e.g. \"any post about the analytics page\"."
}
},
"required": [
"screen_id"
],
"type": "object"
},
"name": "update_product_screen",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Add a product demo, walkthrough or footage to Brand DNA. With only\nthe file, Gemini reads frames across the clip and writes what it\nshows, when to use it, tags and the best moments (scan_status\nscanning, then ready in about 15 seconds; poll list_brand_videos).\nFilms play it when a brief names it (\"launch film with our checkout\ndemo\"). Videos are for films; stills are painted from pictures.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The clip bytes as base64, if you have no URL."
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What the clip shows, in your words. When set, Siren files it without reading it."
},
"name": {
"default": "",
"description": "Human-readable name, e.g. \"checkout demo\".",
"type": "string"
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Short lowercase search words."
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public https URL of the clip (MP4, MOV or WebM, up to 200 MB and 5 minutes)."
},
"use_when": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When a film should play it, e.g. \"any film about checkout\"."
}
},
"type": "object"
},
"name": "upload_brand_video",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Set the workspace logo in Brand DNA. Every render uses it.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"image_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The logo bytes as base64, if you have no URL."
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public https URL of the logo (PNG, JPG or WebP)."
},
"variant": {
"default": "light",
"description": "light = the mark used on light backgrounds (the usual one); dark = the one for dark backgrounds.",
"type": "string"
}
},
"type": "object"
},
"name": "upload_logo",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Store a photo or video the human wants in a post, from an https URL\nor base64. Returns a workspace-owned URL to put in any media slot of a\nfilm body (describe_film lists the slots) — the renderer reads it\ndirectly. Images: PNG/JPG/WebP up to 15 MB. Videos: MP4/MOV/WebM up\nto 200 MB. The same bytes are stored once (content-hashed).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The media bytes as base64, if you have no URL. Pass this or url."
},
"kind": {
"default": "auto",
"description": "auto (default), image, or video. Detected from the bytes when auto.",
"type": "string"
},
"name": {
"default": "",
"description": "Human-readable name for the file.",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public https URL of the photo or video to store. Pass this or base64."
}
},
"type": "object"
},
"name": "upload_media",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"description": "Upload a brand asset (product photo, app screenshot, packaging) into\nBrand DNA and store it on R2. Pass image_url (https PNG/JPG/WebP) or\nimage_base64.\n\nTwo ways to file it:\n- Send `description` (and optionally kind, use_when, tags, name): Siren\n trusts your words and files the asset as-is. No read.\n- Send only the file: Gemini reads the picture and writes name, kind,\n description, use_when, tags itself. scan_status goes scanning → ready\n in about 8 seconds; poll list_product_screens.\n\nkind is free text (\"product photo\", \"dashboard screenshot\", \"packaging\"),\nthere is no fixed list. A brief that names an asset (\"advertise the\npink handbag\") pulls that file into the still. screen_type / device /\ntheme only matter for device-framed screenshot masters.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What the picture shows and what it is for, in your words. When set, Siren files the asset without reading it."
},
"device": {
"default": "phone",
"description": "Device the screenshot was taken on: phone, tablet, desktop, or none.",
"type": "string"
},
"image_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The image bytes as base64, if you have no URL."
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public https URL of a PNG, JPG, or WebP to store as a brand asset."
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Free-text kind: product photo, dashboard screenshot, packaging, logo, team photo."
},
"name": {
"default": "",
"description": "Human-readable name for the asset or run.",
"type": "string"
},
"screen_type": {
"default": "feature",
"description": "Screen role: feature, hero, onboarding, settings, or marketing.",
"type": "string"
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Short lowercase tags for search, e.g. [\"dashboard\", \"dark-mode\"]."
},
"theme": {
"default": "unknown",
"description": "UI theme in the screenshot: light, dark, or unknown.",
"type": "string"
},
"use_when": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When Siren should reach for this asset, e.g. \"any post about the analytics page\"."
}
},
"type": "object"
},
"name": "upload_product_screen",
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5d2826c584348ffb172541fc93cd60b85f8a3d2d4eda8f32410959c343760452 | sha256sum