Skip to main content

Musicboxmelodies

com.musicboxmelodies/music-boxVersion 1.2.0

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

Status

Responds354 msAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.
Last checked
Nov 14, 2026, 14:06 UTC
Latency
354 ms
Remotes responding
1 of 1
Sign-in
No sign-in
Hosting
Hosted outside the EU (detected)
Registry data as of
Nov 14, 2026, 22:14 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP
https://api.musicboxmelodies.com/mcpResponds354 ms
No sign-in

Claude Code

claude mcp add --transport http music-box https://api.musicboxmelodies.com/mcp

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: music-box
Remote MCP server URL: https://api.musicboxmelodies.com/mcp

Cursor

{
  "mcpServers": {
    "music-box": {
      "url": "https://api.musicboxmelodies.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"music-box","type":"http","url":"https://api.musicboxmelodies.com/mcp"}'

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

17 tools

Tools of Musicboxmelodies
Read-only
Idempotent
Open world
add_versionSaves 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 no errors.YesNoYesNo
create_songSaves 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 composer. Without an account the song is saved anonymously and you get a claim link: give it to the person so they can keep it (valid 30 days). Set save_to_my_account to true to ask the person to sign in first (apps that cannot sign in mid-conversation should save without an account and give the claim link instead). Limits: 5 songs a day without an account, 15 a day with one.NoNoNoNo
delete_songPermanently 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.YesNoYesNo
export_songCreates 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, like exporting in the composer.Not declaredYesNot declaredNo
fit_melody_to_boxAdjusts 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. Returns the new melody and its validation.Not declaredYesNot declaredNo
get_order_statusShows 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.Not declaredYesNot declaredNo
get_product_optionsLists 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.Not declaredYesNot declaredNo
get_songGets 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.Not declaredYesNot declaredNo
import_midiConverts 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.Not declaredYesNot declaredNo
list_music_boxesLists 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.Not declaredYesNot declaredNo
list_my_songsLists the signed-in person's songs on Musicboxmelodies, newest first, including private ones. Requires signing in.Not declaredYesNot declaredNo
list_productsLists 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.Not declaredYesNot declaredNo
prepare_orderPrepares 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 and the price with the person before calling it. The price is calculated by the site.NoNoNoYes
render_audioCreates 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 use the sound their author chose unless you pass one. Up to 5 minutes; 20 new audios a day without an account and 60 with one (the same melody again is free).Not declaredYesNot declaredNo
search_songsSearches 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.Not declaredYesNot declaredNo
set_song_visibilityMakes 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.NoNoYesYes
validate_melodyChecks 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.Not declaredYesNot declaredNo

Details

Registry status
Active
Published
Sep 29, 2026
Updated
Sep 29, 2026
Repository
Not given
Categories (suggested)
Design and mediaSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR
Not declared

Are you the operator? Claim this listing