Search / com.musicboxmelodies/music-box
Musicboxmelodies
R0· no sign-inCompose, save and print music box tunes for 15, 20 and 30-note music boxes.
v1.2.0 · active · website · descriptor JSON · versions
Search / com.musicboxmelodies/music-box
R0· no sign-inCompose, save and print music box tunes for 15, 20 and 30-note music boxes.
v1.2.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"music-box": {
"type": "http",
"url": "https://api.musicboxmelodies.com/mcp"
}
}
}claude mcp add --transport http music-box https://api.musicboxmelodies.com/mcp[mcp_servers.music-box]
url = "https://api.musicboxmelodies.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"music-box": {
"type": "remote",
"url": "https://api.musicboxmelodies.com/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"music-box": {
"type": "http",
"url": "https://api.musicboxmelodies.com/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=music-box&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLm11c2ljYm94bWVsb2RpZXMuY29tL21jcCJ9"
}{
"servers": {
"music-box": {
"type": "http",
"url": "https://api.musicboxmelodies.com/mcp"
}
}
}{
"mcpServers": {
"music-box": {
"httpUrl": "https://api.musicboxmelodies.com/mcp"
}
}
}extensions:
"music-box":
enabled: true
name: "music-box"
type: streamable_http
uri: "https://api.musicboxmelodies.com/mcp"
timeout: 300
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every useauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations17 of 17 tools declare readOnlyHint or destructiveHinttools.directory_hints5 of 17 tools declare all four hints; missing: list_music_boxes (destructiveHint, idempotentHint); search_songs (destructiveHint, idempotentHint); render_audio (destructiveHint, idempotentHint); …tools.token_costabout 4,637 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes9 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packagefit_melody_to_boxchangedoutput schemavalidate_melodychangedoutput schemaget_order_statusaddedShows 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.
prepare_orderaddedPrepares 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.
get_product_optionsaddedLists 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.
render_audioaddedCreates 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).
export_songchangeddescription, input schemaCreates a download link for one box version of a song: 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.
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, like exporting in the composer.
delete_songaddedPermanently 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.
create_songchangedoutput schemaFull history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-100% +updated-21d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://api.musicboxmelodies.com/mcp streamable-http | none | yes | 100% | 159 ms | 2026-07-28 | 2026-10-20 |
add_versiondestructive | 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 no errors. |
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 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. |
delete_songdestructive | 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_songread-only | 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, like exporting in the composer. |
fit_melody_to_boxread-only | 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. Returns the new melody and its validation. |
get_order_statusread-only | 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. |
get_product_optionsread-only | 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. |
get_songread-only | 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. |
import_midiread-only | 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. |
list_music_boxesread-only | 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. |
list_my_songsread-only | Lists the signed-in person's songs on Musicboxmelodies, newest first, including private ones. Requires signing in. |
list_productsread-only | 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. |
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 and the price with the person before calling it. The price is calculated by the site. |
render_audioread-only | 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 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). |
search_songsread-only | 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. |
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. |
validate_melodyread-only | 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. |
Schemas: list_tools.
{
"name": "com.musicboxmelodies/music-box",
"title": "Musicboxmelodies",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://api.musicboxmelodies.com/mcp",
"type": "streamable-http"
}
],
"version": "1.2.0",
"websiteUrl": "https://musicboxmelodies.com/ai",
"description": "Compose, save and print music box tunes for 15, 20 and 30-note music boxes."
}