Siren

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`brand`	No	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`	Yes	Plain-language request for the post, e.g. "announce the new export feature, use the dashboard screenshot".
`media`	No	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`	No	Films: a music bed track_id. Omit and the bed follows the film and the direction.
`caption`	No	Optional caption for the post this run becomes. Your words are kept; omit and Siren writes the caption.
`channel`	No	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.	twitter
`timezone`	No	IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York.	UTC
`direction`	No	Films: one free line on mood, pace, motion and music, e.g. "emotional, slow, soft piano" or "dark, club energy, fast cuts".
`platforms`	No	Where to post: any of x, instagram, tiktok, linkedin, youtube, or ["everything"] for every connected channel.
`voiceover`	No	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`	No	What to make: card (still image) or video.	card
`output_type`	No	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`	No	ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 20, 2026

changedInput schema / properties / brand / description

Previous value: -"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. Look up the brand's real site, logo URL and colours first. Omit to use this workspace's Brand DNA."New value: +"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."

Changed1 schema field changedSep 19, 2026

changedInput schema / properties / channel / description

Previous value: -"Target channel for the render: twitter, instagram, linkedin, tiktok, or youtube. Sets the aspect and copy length."New value: +"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."

Changed4 schema fields changedSep 19, 2026

addedInput schema / properties / direction

Added value: +{
+  "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\"."
+}

addedInput schema / properties / media

Added value: +{
+  "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."
+}

addedInput schema / properties / music

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Films: a music bed track_id. Omit and the bed follows the film and the direction."
+}

addedInput schema / properties / voiceover

Added value: +{
+  "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."
+}

Changed1 schema field changedSep 18, 2026

changedInput schema / properties / brand / description

Previous value: -"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), accent (hex: the brand's signature colour, the one films are painted in), primary (hex: its dark or ink colour), secondary, tagline, font, 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. Look up the brand's real site, logo URL and colours first. Omit to use this workspace's Brand DNA."New value: +"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. Look up the brand's real site, logo URL and colours first. Omit to use this workspace's Brand DNA."

Changed1 schema field changedSep 18, 2026

changedInput schema / properties / brand / description

Previous value: -"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), primary, accent, secondary (hex), tagline, font, 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. Look up the brand's real site, logo URL and colours first. Omit to use this workspace's Brand DNA."New value: +"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), accent (hex: the brand's signature colour, the one films are painted in), primary (hex: its dark or ink colour), secondary, tagline, font, 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. Look up the brand's real site, logo URL and colours first. Omit to use this workspace's Brand DNA."

Changed1 schema field changedSep 18, 2026

addedInput schema / properties / brand

Added value: +{
+  "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), primary, accent, secondary (hex), tagline, font, 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. Look up the brand's real site, logo URL and colours first. Omit to use this workspace's Brand DNA."
+}

Changed1 schema field changedSep 17, 2026

addedInput schema / properties / caption

Added value: +{
+  "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."
+}

Changed1 schema field changedSep 17, 2026

addedInput schema / properties / output_type

Added value: +{
+  "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."
+}

Changed6 schema fields changedSep 9, 2026

addedInput schema / properties / asset_type / description

Added value: +"What to make: card (still image) or video."

addedInput schema / properties / brief / description

Added value: +"Plain-language request for the post, e.g. \"announce the new export feature, use the dashboard screenshot\"."

addedInput schema / properties / channel / description

Added value: +"Target channel for the render: twitter, instagram, linkedin, tiktok, or youtube. Sets the aspect and copy length."

addedInput schema / properties / platforms / description

Added value: +"Where to post: any of x, instagram, tiktok, linkedin, youtube, or [\"everything\"] for every connected channel."

addedInput schema / properties / scheduled_at / description

Added value: +"ISO-8601 time to post, e.g. 2026-09-12T09:00:00. Interpreted in the given timezone."

addedInput schema / properties / timezone / description

Added value: +"IANA timezone name for scheduled_at, e.g. Africa/Lagos or America/New_York."

First observedSep 9, 2026

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations are all generic false hints, so the description carries the behavioral burden. It richly discloses credit costs (image 10, video 25), scheduled sequential posting with the Allow posting requirement, 402 failure when balance is insufficient, deterministic rendering, a 24-hour replay returning replayed=true without new charge, and clean-slate behavior for external brands. This exceeds what annotations provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but dense, with bold section headers (FILM KNOBS, ANY BRAND) that make it scannable. It front-loads the core purpose and return-and-poll instruction before moving to details, and every sentence adds operational value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 13-parameter creation tool with an output schema, this description is complete: it covers the end-to-end lifecycle, failure mode, pricing, scheduling side effects, media-vs-image behavior, brand override clean-slate rules, and idempotent retries. Nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds operational nuance beyond the schema: film knobs are ignored by images, output_type requires list_films/describe_film, scheduled_at enqueues sequential posting, and the brand object gets concrete refusal conditions. That extra context earns a 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence names a specific action and resource ('Create a Siren campaign') and describes the exact pipeline: plan, on-brand copy, deterministic render, verify. This clearly distinguishes it from siblings like render_asset or schedule_post without needing an explicit comparison.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives concrete decision rules: pass output_type to pin a film or omit it, use upload_product_screen for images instead of media, pass brand for non-workspace brands, and poll get_run after creation. It stops short of explicitly contrasting with render_asset or schedule_post, but the workflow guidance is strongly directional.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Siren tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

create_campaign

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources