Musicboxmelodies

com.musicboxmelodiesPublished by musicboxmelodies.comOfficial publisherv1.2.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableBusiness & CommerceMedia & Design

Overview

AI-generated overview

Composes, validates, saves, renders and exports music box melodies for 15, 20 and 30-note boxes, and prepares custom music box orders.

What you can do
List music box types with their playable notes and rules, and search or fetch community tunes from the public catalog by name, artist or arranger. Validate a melody against a box's limits, fit it to a box by transposing or moving notes to the nearest playable one, and import MIDI files into the melody format. Save melodies as private songs, add per-box versions, list your songs, set visibility and delete songs. Render an MP3 of a melody or saved song, and export a box version as MP3, MIDI or a printable strip PDF. Browse products and options with US dollar prices, prepare a custom melody or strip order with a cart link, and check order status.
When to use it
Useful when someone wants to write or adapt a tune for a physical hand-crank music box, check that it is playable, hear it, print a strip, or set up a custom music box order. Also handy for browsing existing community arrangements before composing.
Requirements
Remote streamable HTTP endpoint; nothing to install locally. Signing in is required for listing your songs, changing visibility, deleting songs, exporting and checking order status; some actions also accept a claim token for songs saved without an account. Network access is needed.
Before you install
Songs can be made public or permanently deleted; both require an explicit confirmation step, so confirm with the person first. Saving, adding versions and exporting write to an account. Order preparation returns a cart link where the person pays on the website with PayPal; nothing is charged by the tool itself. Real music box audio rendering is limited to PRO accounts.

Installation

In SourceWeft

  1. Open Musicboxmelodies in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.musicboxmelodies%2Fmusic-box/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "musicboxmelodies": {
      "type": "http",
      "url": "https://api.musicboxmelodies.com/mcp"
    }
  }
}

Tools

17

list_music_boxes

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.

Takes no parameters.

search_songs

Search music box tunes

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.

Parametersboxpagequerypage_size

get_song

Get a music box tune

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.

Parametersboxsong_idrequiredclaim_token

validate_melody

Validate a melody for a music box

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.

Parametersboxrequiredbpmrequirednotesrequiredsnap_beatsillegal_threshold_ticks

fit_melody_to_box

Fit a melody to a music 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. Returns the new melody and its validation.

Parametersboxrequiredbpmrequirednotesrequiredstrategytarget_boxquantize_beatsillegal_threshold_ticks

list_products

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.

Takes no parameters.

create_song

Save a new music box 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.

Parametersboxrequiredbpmrequirednamerequiredtagsnotesrequiredartistrequireddescriptionsave_to_my_accountillegal_threshold_ticks

add_version

Add or replace a box version of a song

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.

Parametersboxrequiredbpmrequirednotesrequiredsong_idrequiredclaim_tokenillegal_threshold_ticks

list_my_songs

List my songs

Lists the signed-in person's songs on Musicboxmelodies, newest first, including private ones. Requires signing in.

Parameterspagepage_size

set_song_visibility

Make a song public or private

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.

Parameterssong_idrequiredconfirmedvisibilityrequired

delete_song

Delete a 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.

Parameterssong_idrequiredconfirmedclaim_token

export_song

Export a song as MIDI or a printable strip

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.

Parametersboxgridformatrequiredsong_idrequiredshow_titlestrip_shape

render_audio

Listen to a melody or song

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).

Parametersboxbpmnotessoundsong_idclaim_tokenillegal_threshold_ticks

import_midi

Read a MIDI file as a melody

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.

Parametersboxmidi_base64required

get_product_options

Get the options of a product

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.

Parametersproductrequired

prepare_order

Prepare an order for the person to pay

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.

Parameterstimerequiredthemeproductrequiredsong_namerequirednote_countsong_artistrequiredvariation_idrequiredexisting_tunereference_link

get_order_status

Check my orders

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.

Parametersorder_id

Version history

2
  1. v1.2.0LatestSep 30, 2026
  2. v1.0.0Sep 29, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.