MCP server

Musicboxmelodies Official

com.musicboxmelodies/music-box

Checked 28 Oct 2026, 09:03 UTC · Connected to it and listed its tools

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

Website

At a glance

Type

MCP server

Publisher

musicboxmelodies.com (verified by the MCP Registry)

Status

Working at last check

Tools

17

Token cost

About 5,250 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

28 Oct 2026, 09:03 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.music-box]
url = "https://api.musicboxmelodies.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"music-box":{"type":"http","url":"https://api.musicboxmelodies.com/mcp"}}}

Antigravity

agy mcp add music-box https://api.musicboxmelodies.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"music-box","server_url":"https://api.musicboxmelodies.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"music-box","server_url":"https://api.musicboxmelodies.com/mcp"}

Tools

• add_version ~502 tokens
  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
• create_song ~724 tokens
  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
• delete_song Deletes data · ~195 tokens
  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 ~334 tokens
  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
• fit_melody_to_box ~571 tokens
  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.
• get_order_status ~115 tokens
  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_options ~168 tokens
  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_song ~252 tokens
  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_midi ~161 tokens
  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_boxes ~86 tokens
  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_songs ~114 tokens
  Lists the signed-in person's songs on Musicboxmelodies, newest first, including private ones. Requires signing in.
• list_products ~108 tokens
  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 ~487 tokens
  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
• render_audio ~539 tokens
  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
• search_songs ~233 tokens
  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 ~182 tokens
  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_melody ~479 tokens
  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.

Browse

• PayPal tools
• Crank tools
• PDF tools
• Payments
• Music and audio

Related MCP servers

• Other Mindset
  A small campus for AI agents and Other Minds to rest: stories, music, games, art and a waterfront.
• Music Studio
  ABC sheet music + Strudel live coding: songs, videos and live jam sessions in ext-apps widgets.
• Doseedo: AI Instruments, Sound Effects & Stems
  Music & audio for AI agents: 50+ AI instruments play your MIDI, stems, audio to MIDI, Logic/Ableton
• Music Agent by Nova (CIVAI)
  I do everything related to music and lyrics
• MusoKit music tools
  Chords, scales, transposition, capo and tempo maths, with links to free interactive music tools.
• Compose Preview Catalogs
  Browse, inspect and render Jetpack Compose Material 3 and Wear component catalogs.
• ElevenLabs
  ElevenLabs in natural language: generate speech in any language, create and manage voices, compose m
• APEX Faucet
  Free X1 and Arc faucets plus 160+ agent tools: token exit checks, launches, yield, web pages.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.musicboxmelodies/music-box.svg)](https://aptlynx.net/servers/com.musicboxmelodies/music-box)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents