find_song_synergies
Find every Disney Lorcana character that can sing a given song by cost or Singer keyword, with optional ink-color filters and owned-copy counts for deck building.
Instructions
Find every Character that can sing a given song — the tool for building or
checking a Singer/song combo (e.g. the Amber/Steel Steelsong package), not
for general card search (use search_cards for that).
A character can sing a song if its printed ink cost meets the song's cost outright, OR it has a "Singer X" keyword with X meeting the song's cost — Singer lets a cheap character punch above its actual cost for singing purposes only (see the Steelsong package: Amber Singers unlocking expensive Steel songs for free). Provide either song_name (resolved the same fuzzy way as resolve_card, so "beauty and beast" or a slight typo still works) or a raw cost threshold — exactly one is required; passing neither, or both, returns an error message instead of guessing.
Results are grouped: Singer-keyword characters first (the actual
"discount" picks — highest Singer value, then cheapest actual cost),
followed by characters that simply cost enough to sing it outright,
cheapest first. This only tells you who can sing — it doesn't check
whether that character is otherwise good (stats, other abilities) or
whether you own enough copies to make the combo consistent unless you
pass collection_csv, in which case each result is annotated with owned
quantity so you can see the combo's real consistency at a glance.
Args: song_name: Name of a Song card, e.g. "Be Our Guest". Fuzzy-matched. cost: Raw song cost threshold to use instead of song_name, e.g. 5. colors: Optional comma-separated ink color(s) to restrict characters to, e.g. "Amber,Steel". collection_csv: Optional path to an enriched collection CSV — when given, each character is flagged with how many copies you own. limit: Max characters to list (default 50, capped at 200).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| limit | No | ||
| colors | No | ||
| song_name | No | ||
| collection_csv | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |