Musicboxmelodies
Server Details
Compose, save and print music box tunes for 15, 20 and 30-note music boxes.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 17 tools
Most tools target distinct resources and actions, but there are a few soft overlaps: render_audio and export_song both produce audio output (differing in purpose—listening vs. download link), and list_music_boxes / list_products / get_product_options are three separate informational tools that a hasty agent could conflate. The detailed descriptions do resolve these boundaries, so confusion is limited.
Every tool follows a clean snake_case verb_noun or verb_object pattern (create_song, delete_song, get_song, list_my_songs, validate_melody, set_song_visibility, prepare_order), with no camelCase or mixed conventions. The pattern is highly predictable throughout.
17 tools is slightly on the heavy side, but the domain genuinely spans composition (validate/fit/import/render), song management (CRUD + versions + visibility), discovery (search/list), and e-commerce (products/options/order/status), so each tool earns its place. It is not padded.
The surface covers the full lifecycle: create/read/update/delete for songs and versions, validation and box-fitting helpers, MIDI import, audio/PDF/MIDI export, public catalog search, and a complete ordering flow (options, prepare, status). No obvious dead ends for the composer/shop workflow.
Available Tools
17 toolsadd_versionAdd or replace a box version of a songADestructiveIdempotentInspect
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.
Inputs: box (required), bpm (required), notes (required), song_id (required), +2 more. Returns: box, song_id, replaced, validation, +1 more
create_songSave a new music box songAInspect
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.
Inputs: box (required), bpm (required), name (required), notes (required), +5 more. Returns: box, quota, private, song_id, +6 more
delete_songDelete a songADestructiveIdempotentInspect
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.
Inputs: song_id (required), confirmed, claim_token. Returns: name, status, song_id
export_songExport a song as MIDI or a printable stripARead-onlyInspect
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.
Inputs: format (required), song_id (required), box, grid, +2 more. Returns: box, format, song_id, download_url
fit_melody_to_boxFit a melody to a music boxARead-onlyInspect
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.
Inputs: box (required), bpm (required), notes (required), strategy, +3 more. Returns: melody, changes, summary, semitones, +2 more
get_order_statusCheck my ordersARead-onlyInspect
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.
Inputs: order_id. Returns: orders
get_product_optionsGet the options of a productARead-onlyInspect
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.
Inputs: product (required). Returns: name, fields, product, variations
get_songGet a music box tuneARead-onlyInspect
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.
Inputs: song_id (required), box, claim_token. Returns: url, name, tags, stats, +8 more
import_midiRead a MIDI file as a melodyARead-onlyInspect
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.
Inputs: midi_base64 (required), box. Returns: name, melody, validation, notes_in_file, +1 more
list_music_boxesList music boxesARead-onlyInspect
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.
Inputs: no named parameters. Returns: boxes, ticks_per_beat, default_min_repeat_beats
list_my_songsList my songsARead-onlyInspect
Lists the signed-in person's songs on Musicboxmelodies, newest first, including private ones. Requires signing in.
Inputs: page, page_size. Returns: page, pages, songs, total
list_productsList productsARead-onlyInspect
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.
Inputs: no named parameters. Returns: currency, products
prepare_orderPrepare an order for the person to payAInspect
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.
Inputs: time (required), product (required), song_name (required), song_artist (required), +5 more. Returns: summary, cart_url, price_usd, expires_at
render_audioListen to a melody or songARead-onlyInspect
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).
Inputs: box, bpm, notes, sound, +3 more. Returns: note, sound, audio_url, duration_seconds
search_songsSearch music box tunesARead-onlyInspect
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.
Inputs: box, page, query, page_size. Returns: page, pages, songs, total
set_song_visibilityMake a song public or privateAIdempotentInspect
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.
Inputs: song_id (required), visibility (required), confirmed. Returns: url, status, song_id, visibility
validate_melodyValidate a melody for a music boxARead-onlyInspect
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.
Inputs: box (required), bpm (required), notes (required), snap_beats, +1 more. Returns: ok, stats, issues, composer_link
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Convert MusicXML, MIDI, ABC, MEI and Humdrum, print sheet music, and verify every note survived.
Compose printable VHS, DVD, Blu-ray, cassette, CD and vinyl packaging from any movie, show or album.
Write, edit, transpose and play guitar tabs and staff notation in Cesure.
Write tunes for your Tesla coil, browse the teslacoil.app community and check leaderboards.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI tools to convert music scores between MusicXML, MIDI, ABC, MEI and Humdrum while verifying each result note by note and reporting exactly what was kept or lost. Also supports rendering printable sheet music and audio previews, transposing, extracting parts or bars, validating bars, and comparing versions across formats.37 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceinteractive programming of melodies, producing MIDI214-
- AlicenseNot gradedqualityDmaintenanceEnables AI-assisted music composition through copyable pattern templates, style constraints, and arrangement tools that compile to MIDI files. Provides 30+ tools for managing musical structures, layers, patterns, and styles with deterministic compilation from YAML arrangements.1MIT
- AlicenseNot gradedqualityBmaintenanceTurns one audio source into playable notation and MIDI outputs, generating staff images, numbered notation, MusicXML, and MIDI across three difficulty tiers.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.