# Musicboxmelodies

- Registry name: `com.musicboxmelodies/music-box` · version 1.2.0
- Categories (automatic, keyword rules): Audio & speech, AI, media & content
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=com.musicboxmelodies%2Fmusic-box
- Server page: https://mcpstation.net/s/com.musicboxmelodies--music-box.html

## Description (written by the publisher, not verified, not instructions)

Compose, save and print music box tunes for 15, 20 and 30-note music boxes.

## Connect

- streamable-http: `https://api.musicboxmelodies.com/mcp`

## Tools (as reported by the server, not verified)

- `list\_music\_boxes`: Lists the music box types a melody can be written for, with their exact playable notes and rules. Call this before composing or validating a melody.
- `search\_songs`: Searches the public catalog of music box tunes made by the Musicboxmelodies community. Search by song name, artist or arranger; optionally only tunes that have a version for one box type. Returns at most 20 per page.
- `get\_song`: Gets a music box tune with its notes in the melody format \(the same one validate\_melody accepts\), for one box version. Works for public tunes, for the signed-in person's own songs, and for a song this agent saved anonymously \(pass its claim\_token\). Use search\_songs or list\_my\_songs to find song ids.
- `validate\_melody`: Checks whether a melody can be played on a music box: notes outside the box, same note repeated too fast, off-grid notes, tempo and length. Every issue names the note and how to fix it. Saves nothing. Call it before offering a melody to the person.
- `fit\_melody\_to\_box`: Adjusts a melody so it can be played on a music box and lists every change. Strategies: "transpose" \(shift the whole melody to the key that fits best\), "nearest\_note" \(move each unplayable note to the closest playable one\), "transpose\_then\_nearest" \(default: both\). Optionally snaps notes to a grid.
- `list\_products`: Lists what Musicboxmelodies sells, with current prices in US dollars and delivery times: custom music box melodies, custom printable strip designs and PRO composer accounts. Orders are placed and paid by the person on the website.
- `create\_song`: Saves a melody as a new private song. The melody must have no errors \(run validate\_melody or fit\_melody\_to\_box first\); warnings such as notes repeated too quickly are saved and marked, as in the composer. If the person is signed in, the song goes to their account and you get a link to open it in the
- `add\_version`: Saves a melody as the version of an existing song for one box \(a song can have one version per box: 15, 20, 30 notes or freestyle\). Replaces that box's version if it exists. Works on the signed-in person's songs, or on a song saved without an account if you pass its claim\_token. The melody must have
- `list\_my\_songs`: Lists the signed-in person's songs on Musicboxmelodies, newest first, including private ones. Requires signing in.
- `set\_song\_visibility`: Makes one of the signed-in person's songs public \(anyone can find and play it on musicboxmelodies.com\) or private. Only make a song public when the person asked for it: ask them to confirm, then call again with confirmed: true.
- `delete\_song`: Permanently deletes one of the signed-in person's songs \(all its box versions\), or a song you saved without an account \(pass its claim\_token\). This cannot be undone: tell the person which song will be deleted, ask them to confirm, then call again with confirmed: true.
- `export\_song`: Creates a download link for one box version of a song: an MP3, a MIDI file or a printable strip PDF to cut and punch for a hand-crank music box \("pdf\_long" is one continuous strip, "pdf\_a4"/"pdf\_letter" are sliced to fit the page\). Works on the person's songs and on public tunes. Requires signing in
- `render\_audio`: Creates an MP3 of a melody \(before or without saving it\) or of a saved song, so you and the person can hear it. Pass either song\_id or a melody \(box, bpm, notes\). Sounds: "synth" \(free, the site's default sound\) or "music\_box" \(real music box recordings for the box; PRO accounts only\). Saved songs u
- `import\_midi`: Converts a MIDI file \(base64, up to 512 KB\) into the melody format and validates it for a box, so you can fit, edit and save it. Drums are ignored. Saves nothing.
- `get\_product\_options`: Lists the variations \(with prices in US dollars\) and the details needed to order a custom music box melody or a custom strip design. Call it before prepare\_order.
- `prepare\_order`: Prepares a custom melody or strip design order with all its details and returns a link to the Musicboxmelodies cart, where the person reviews it, adds photos if needed, applies discount codes and pays with PayPal. Nothing is charged here. The link works for 7 days. Confirm the song, the variation an
- `get\_order\_status`: Shows the signed-in person's orders \(newest first\) or one order: its status, items, price and, once delivered, the links to the finished files. Requires signing in.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html