initiate_license
Start a license purchase for any track, including partner tracks. First ask whether the license is personal (non-commercial) or business. Personal: pass license_type (social_media or all_digital). Business: pass licensee_type "business" with medium, category, territory, and term from get_license_options. Returns a payment_id (like "OCM-Q000123"), the exact USDC amount, the receiving wallet on Base (chain ID 8453), and a terms_url for the license agreement. Before the user pays, confirm the track title and artist in track_to_confirm and the price with them. The user must send the exact amount from the paying_wallet given here; no memo is needed. After the user confirms they sent payment, call verify_license with the payment_id.
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": {
"track_id": "<track_id>",
"paying_wallet": "<paying_wallet>"
},
"name": "initiate_license"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | No | Business licenses: term from get_license_options. | |
| No | Optional. Email to receive the license and download links. | ||
| usage | No | Optional. Short description of how the music will be used. | |
| medium | No | Business licenses: medium from get_license_options, for example "Social Media Branded Content". | |
| country | No | Optional. Two-letter country code of the licensee, for example "US". | |
| category | No | Business licenses: category from get_license_options. | |
| track_id | Yes | The track id exactly as returned by search_catalog, ai_search, or get_track, for example "417" or "partner_82". Never remove the "partner_" prefix. | |
| territory | No | Business licenses: territory from get_license_options. | |
| license_type | No | Personal (non-commercial) licenses: social_media (personal videos on TikTok, Instagram, YouTube, X) or all_digital (non-commercial use on websites, podcasts, streaming, and online video). Omit for business licenses. | |
| licensee_name | No | Optional. Person or company that will hold the license. Printed on the agreement. | |
| licensee_type | No | For rate card licenses (medium, category, territory, term): business (default) or personal. | |
| paying_wallet | Yes | The Base wallet address (0x followed by 40 hex characters) the user will send USDC from. | |
| project_title | No | Optional. Project or production title. Printed on the agreement. |