Song ad

The structure of the ad

Products with one clear result and a buyer who likes to share.

1. 10–3 s hook: the catchiest line, sung on camera or over the product's most visual moment.
2. 23–12 s verse: the problem in the buyer's words, one silent picture per line.
3. 312–18 s chorus: the result, sung, with the product shown in use.
4. 418–26 s short verse: one proof the facts back, silent shots cut on the beat.
5. 526–30 s last chorus line and the ask on the final resolve, the product whole in frame.

---
name: roasos-song-ad
description: Plan and make a song ad with roasOS over MCP. Use when the user asks for a song ad, a jingle or a sung ad.
---

# Song ad

A short original song carries the ad: the lyrics sing the result the customer gets, the picture follows the finished track, and the song is the only soundtrack.

## Step 1: Connect the roasOS MCP server

Do this step first. Stop when this step fails, and tell the user.

1. Look for tools with names that start with `roasos_`. If you find them, go to step 4.
2. Connect the server at `https://mcp.roasos.com/mcp`. It uses Streamable HTTP. In Claude Code, run `claude mcp add --transport http roasos https://mcp.roasos.com/mcp`, then type `/mcp` and sign in. Other clients: https://docs.roasos.com/mcp
3. The user needs a roasOS account: https://www.roasos.com/auth/signup. MCP access is included on every plan. Only the user can sign up and pay.
4. Call `roasos_get_catalog`. It is free. A role name in this file, for example "the song role", is a key in `roles` in that answer.

## Step 2: Quote before you spend

Every paid tool quotes first. Send `quote_only: true` and read `credits`. Show the credits to the user and wait for a clear yes. Then send the same input with the `quote_id`.

In this file, "card", "approval card" and "quote and confirm" all mean this exchange. Never confirm a quote without a yes.

## Step 3: Make the ad

A song ad is a tiny music video. The track is the clock and every cut answers to it. Write a small real song a stranger would let play, not a slogan on a loop.

### Order of work
1. Ground it: the product facts (`roasos_get_product`), the brand voice (`roasos_get_brand_kit`), the buyer and the one result they want. Sing only what the facts back.
2. Offer 2 or 3 lyric options before anything is spent. Make them differ: who sings (buyer, friend, product), the mood, or the hook. If the user brings lyrics, those are the song, word for word; skip the options.
3. Make the picked song once, whole, on an approval card with the words visible (quote and confirm for a `roasos_music_*` tool, on the song role). Stop until it is back.
4. Measure it, then board it (a storyboard table). Never board to a planned length.
5. Render on approved cards, then finish.

### Genre
Infer it from the audience the user states, say it in one line, and let them correct it. Use age, taste, hobby, or a culture or market the user names (its current sound, in its language if asked). Younger: current pop, rap, electronic. Past forty: soft pop, country, throwback. Gym: hard drums. Premium: restrained, jazz or cinematic. No audience given: follow the product's mood and say so.
Never guess anyone's race, and never map race to a genre.

### Lyrics
- Sing the result the customer gets. The name appears but is not the point. For a short ad or a new name, the alternative is name-repeat: the name on the downbeat three or four times, one benefit between.
- The catchiest line lands in the first 3 seconds.
- One picture per line, 2 to 3 seconds each.
- Budget: start near 2.5 sung words per second, then calibrate on our music model: sung words over sung seconds on a finished track, and use that figure next time. Section tags do not count.
  15 s, about 35 words: hook, one benefit, hook again as the ask.
  30 s, about 70: hook chorus, verse on the problem, chorus, short proof verse, ask.
  60 s, about 140: two verses, a bridge for the doubt, chorus either side.
- Too long: cut words, not seconds. The ask sits on the final resolve: the user's own offer, never an invented one. Spell an invented name by sound in the song input only.

### Style line
Genre, voice, BPM, mood, production, in one line. Never an artist, a band or an existing melody. No dead air: vocals on the first beat, no instrumental intro or break, no long outro, a tight ending, the length stated.

### Measuring
The finished track is the fact; requested timestamps were only a request. Read it with `roasos_transcribe`. Sung words transcribe badly: check an odd line against the lyrics, and with the user. Never remake one section: the model will not match itself. A wrong song is a new song on a new card.

### The board
- One shot per line or phrase, each tied to a range of the real track, first note to last, no gaps.
- Mark every shot SUNG or SILENT. Sung: the lead mouths the line, driven by the song as audio. Silent: the picture shows what the words say at that moment, with no speech. Usually the hook and last chorus are sung and the rest silent.
- One lead, pinned in every shot and named the same way; the product pinned too.
- Cut on a beat, in the gap between words, never inside one. An instrumental stretch stays and gets a picture; carry the shot that leads into it.
- Cut one clip per SUNG shot at those gaps, for shots driven by the song.

### Finishing
The song is the only soundtrack. Lay it under the cut (`roasos_assembly_merge_audio_video`) and match the ends (`roasos_assembly_trim_video`). No text in footage; captions (`roasos_captions_auto_subtitle`) and the ask (`roasos_assembly_text_overlay`) come last, spelled right.

### Example, 15 s
[0:00-0:03 SUNG] Dry socks, dry socks, all the way home
[0:03-0:09 SILENT] Rain on the path, boots through a puddle.
[0:09-0:15 SUNG] Puddl Boots, dry socks, get yours today

## Format data

- Aspect ratio: 9:16
- Default length: 30 seconds
- Needs: a product
- Example request: Make a 30 second song ad for my product.

Beats:
- 0–3 s hook: the catchiest line, sung on camera or over the product's most visual moment.
- 3–12 s verse: the problem in the buyer's words, one silent picture per line.
- 12–18 s chorus: the result, sung, with the product shown in use.
- 18–26 s short verse: one proof the facts back, silent shots cut on the beat.
- 26–30 s last chorus line and the ask on the final resolve, the product whole in frame.

How to shoot it: Make and measure the song first, then board to its real timing, one shot per lyric line, each marked sung or silent. One pinned lead for the sung shots (animated or cast); the rest silent picture of what the words say. Cut on beats between words. Captions and the ask are added after the render.

What breaks it: Boarding to a guessed length, a named artist's voice or an existing melody, a long instrumental intro or dead air, lyrics that only chant the name, claims the facts do not back, cuts inside a word, a second song composed in finishing.

More formats

• Talking character
• Progression ad
• Whiteboard presenter
• History explainer
• Podcast ad
• Continuous 3D explainer