Analyze lyrics for singing
lyricsAnalyzes lyric text for setting to music: each word's syllables, stress and phones (ARPAbet), the rhyme scheme with perfect and near rhymes, scansion against a poetic meter, and where each syllable can start on a tracker rhythm grid for a time signature (stressed syllables on strong beats, a pickup for an unstressed start), with warnings for lines that do not scan. EXPERIMENTAL: the singing voice and lyric setting are early features; word clarity and fit vary from song to song, so render and listen before relying on a result. It writes no melody and no words of its own (fit mode only reshapes a melody you send): the assistant writes the notes, then puts each syllable on its note in MTL (C4'twin- D4'kle; '_ holds a syllable over more notes). Word setting: mode=plan returns, for every line, exactly how many notes it needs and their lengths as a melody template (x:2 x:2 x:4: write the tune on that rhythm); mode=fit with melody checks and fits the words on a melody you wrote, adapting it (adapt, default true): extra syllables split a note (split=repeat repeats the pitch, pass steps toward the next note), a line that starts unstressed on the downbeat gets a pickup note, extra notes carry the syllable (melisma '_), and the last note is held to its bar line (hold); every change is listed, and warnings name syllables that are crammed, stress-inverted or off the beat and phrases that are shorter or longer than the bars (bars). Each fit line returns a ready MTL cell string and the adapted melody. Pronunciation comes from the dictionary; words guessed by rule are listed (fix with say). melody: one line per lyric line (a "\n" between lines, or an array). Tokens split by spaces: a pitch (C5, F#4, Bb3; octave 0-9, C4 = 48), optionally with its length in rows (C5:4; default = step rows); "." a rest of one step, ".3" three steps, ".3r" three rows; "x" a placeholder pitch (from plan mode: x:2); "@-2" first token only: the line starts at row -2 (a pickup before the bar; default 0). A note lasts until the next token. Example: "C5 D5 E5:4 . G5:2". Up to 48 lines per call. Schema a964948f.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"text": "<text>"
},
"name": "lyrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bpm | No | Tempo, for the shortest singable syllable (default 100) | |
| rpb | No | Rows per beat (quarter note) of the pattern, default 4 | |
| say | No | Pronunciations for names or invented words, ARPAbet with stress: {"kurtis":"K ER1 T IH0 S"} | |
| bars | No | Bars per line; omitted, one count that suits every line | |
| hold | No | fit: hold the last note of a line to its bar line (default true) | |
| mode | No | analyze (default): grid rows only. plan: notes and rhythm each line needs (write the melody second). fit: put the words on melody (default when melody is sent) | |
| step | No | Rows per melody token without a length (default rpb/2, an eighth note) | |
| text | Yes | The lyrics, one sung line per line | |
| time | No | Time signature for the grid (default 4/4) | |
| adapt | No | fit: change the melody to suit the words (split, pickup, melisma); false only reports (default true) | |
| meter | No | Poetic meter to scan against; auto picks the best fit | |
| split | No | fit: pitch of a note split in two: repeat it, or step toward the next note (default repeat) | |
| detail | No | full adds phones and meter notes to the text | |
| melody | No | With fit: one melody line per lyric line, e.g. "C5 D5 E5:4 . G5:2" (pitch[:rows], . rest, x placeholder, @-2 pickup start) | |
| pickup | No | Allow unstressed syllables before the bar (default true) |