Prepare an order for the person to pay
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"product": "<product>",
"variation_id": "<variation_id>",
"song_name": "<song_name>",
"song_artist": "<song_artist>",
"time": "<time>"
},
"name": "prepare_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | Yes | Part of the song to convert, e.g. "0:00 - 1:30" or "whole song". | |
| theme | No | Strip designs only. | |
| product | Yes | "custom_melody" (a song arranged in music box style, delivered as audio) or "custom_strip_design" (printable strips for a 15 or 30-note hand-crank box). | |
| song_name | Yes | ||
| note_count | No | Strip designs only: notes of the person's music box. | |
| song_artist | Yes | ||
| variation_id | Yes | From get_product_options. | |
| existing_tune | No | Strip designs only: the song is already on our YouTube channel (25% off). | |
| reference_link | No | YouTube or other link to the version the person wants. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| summary | Yes | ||
| cart_url | Yes | ||
| price_usd | Yes | ||
| expires_at | Yes |