{"schema_version":"1.1","name":"OnChain Music","description":"A music licensing platform offering 8,700+ independently owned, fully cleared songs plus partner catalogs. AI agents can search by genre, mood, tempo, BPM, instrumentation, and use, then license tracks with USDC payments on Base. Personal (non-commercial) licenses cover social media and digital use; business licenses come from the full rate card (branded social media, commercials, film, television, trailers, and more). No human in the loop.","url":"https:\/\/onchainmusic.com","documentation_url":"https:\/\/onchainmusic.com\/api-docs","developers_url":"https:\/\/onchainmusic.com\/developers","contact":{"partnerships":"https:\/\/onchainmusic.com\/contact","licensing":"licensing@onchainmusic.com","press":"press@onchainmusic.com"},"capabilities":["search","retrieve","purchase","catalog_search","natural_language_search","track_metadata","license_options","license_purchase","x402_payments","license_agreement_pdf","mcp_server","mcp_tools","loudness_standards","royalty_calculations","genre_conventions"],"preferred_flow":["search","select_track","choose_license","initiate_license","make_payment","verify_license","download"],"mcp":{"endpoint":"https:\/\/onchainmusic.com\/api\/mcp","protocol":"MCP 2025-06-18","transport":"HTTP","authentication":"none","config":{"mcpServers":{"onchain-music":{"type":"url","url":"https:\/\/onchainmusic.com\/api\/mcp"}}},"tools":[{"name":"search_catalog","description":"Search the OnChain Music catalog of 8,700+ independently owned, fully cleared songs, plus partner catalogs.","free":true},{"name":"ai_search","description":"Search the OnChain Music catalog using a plain English description.","free":true},{"name":"get_track","description":"Retrieve full metadata for a specific track from the OnChain Music catalog or a partner catalog, including license pricing, available download formats, artist information, BPM, key, mood, and license terms.","free":true},{"name":"get_loudness_standards","description":"Returns the official loudness normalization standards for major music and video platforms.","free":true},{"name":"calculate_songwriter_publisher_split","description":"Split gross songwriter royalties between the songwriter and publisher, and describe the deal type (self-published, co-publishing, full publishing).","free":true},{"name":"calculate_cowriter_split","description":"Split gross songwriter royalties among co-writers by their percentage shares.","free":true},{"name":"calculate_producer_points","description":"Calculate per-unit and total earnings for a producer points deal: the master royalty, the producer's share, and the artist's net.","free":true},{"name":"calculate_sync_fee_split","description":"Split a sync licensing fee between the master rights side and the publishing side, then split the publishing side between publisher and songwriter.","free":true},{"name":"estimate_streaming_royalties","description":"Estimate low, mid, and high streaming payouts for a number of streams on a platform, before and after the artist royalty rate.","free":true},{"name":"get_genre_conventions","description":"Returns music industry conventions for a given genre including typical BPM ranges, song structure, instrumentation, key tendencies, production characteristics, and common sync use cases.","free":true},{"name":"get_license_options","description":"List license options with prices in USD.","free":true},{"name":"initiate_license","description":"Start a license purchase for any track, including partner tracks.","free":false},{"name":"verify_license","description":"Check whether a license payment has been confirmed on Base.","free":true}]},"payment":{"protocol":"x402","networks":[{"chain":"base","chain_id":8453,"tokens":["USDC"],"status":"active","usdc_contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"chain":"ethereum","chain_id":1,"tokens":["USDC","USDT"],"status":"planned"},{"chain":"solana","tokens":["USDC","USDT"],"status":"planned"}],"payment_window":"15 minutes","matching":"By sending wallet and exact amount. No memo or calldata."},"license_types":[{"id":"social_media","name":"Personal Social Media","description":"Personal, non-commercial videos on TikTok, Instagram, YouTube, X, Facebook, and similar platforms.","price_usdc":"10.00","term":"perpetual","exclusivity":"non-exclusive","territories":"worldwide","permitted_uses":["TikTok","Instagram","YouTube","X (Twitter)","Facebook","Personal social media"]},{"id":"all_digital","name":"Personal All Digital","description":"Non-commercial use on websites, podcasts, streaming, and online video.","price_usdc":"35.00","term":"perpetual","exclusivity":"non-exclusive","territories":"worldwide","permitted_uses":["Personal websites","Podcasts","Streaming","Online video","Personal social media"]}],"rate_card":{"description":"Business licenses for any medium, category, territory, and term, priced by track tier. Prices in USD, paid as the same amount of USDC.","options_url":"https:\/\/onchainmusic.com\/api\/v1\/agent\/license\/options","quote_url":"https:\/\/onchainmusic.com\/api\/v1\/agent\/license\/quote"},"pages":[{"url":"https:\/\/onchainmusic.com\/tools\/music-health-scan","title":"Free Music Health Scan","description":"Free web tool for any artist: upload a track to check LUFS, true peak, dynamic range, embedded metadata, and sync readiness, with recommendations. No account required."},{"url":"https:\/\/onchainmusic.com\/developers","title":"Developers","description":"Overview of the OnChain Music MCP server, REST API, OpenAPI spec, and developer tools."},{"url":"https:\/\/onchainmusic.com\/press","title":"Press","description":"Press coverage, interviews, and media appearances featuring OnChain Music."},{"url":"https:\/\/onchainmusic.com\/api-docs","title":"Agent API Documentation","description":"Full documentation for the OnChain Music Agent REST API."}],"api":{"type":"openapi","url":"https:\/\/onchainmusic.com\/api\/docs\/openapi.json","base_url":"https:\/\/onchainmusic.com\/api\/v1\/agent","authentication":{"type":"none"},"flow":{"step_1":"Search: GET \/api\/v1\/agent\/catalog\/search, or POST \/api\/v1\/agent\/ai-search for natural language queries","step_2":"Optional track detail: GET \/api\/v1\/agent\/catalog\/tracks\/{id}","step_3":"Ask personal or business. Personal (non-commercial): POST \/api\/v1\/agent\/license\/{track_id}\/social_media or \/all_digital. Business: GET \/api\/v1\/agent\/license\/options?track_id={id}, then POST \/api\/v1\/agent\/license\/quote with licensee_type \"business\"","step_4":"Include paying_wallet (required) in the body. The 402 response has the payment_id (like OCM-Q000123), exact amount, receiving address, and terms_url","step_5":"Send exactly that amount of USDC on Base from paying_wallet within 15 minutes","step_6":"Poll GET \/api\/v1\/agent\/license\/verify\/{payment_id}","step_7":"Receive the license number, download links, license agreement PDF, and signed license document. Links expire after 30 days"},"notes":{"terms":"Initiating a license accepts the license agreement at terms_url.","disclosures":"Answering yes to sensitive or altered never blocks a license. The answer is printed on the agreement, and that use still requires written approval from licensing@onchainmusic.com.","eligibility":"Only tracks whose artists opted in to AI agent licensing can be licensed through the API.","licensee":"Optional body fields licensee_name, project_title, usage, email, and country are printed on the agreement. With email, the license is also emailed."},"search_tips":{"primary_field":"Use description= as the primary search field for style, mood, and energy. The API searches each word individually across multiple fields.","example":"description=epic orchestral trailer","natural_language":"Use POST \/api\/v1\/agent\/ai-search with a plain English phrase for automatic parameter extraction.","avoid":"Do not use mood=. Pass mood words in description= instead."},"endpoints":[{"path":"\/api\/v1\/agent\/catalog\/search","method":"GET","description":"Search the catalog. Use description= as the primary field. Returns a results_url that opens every match on onchainmusic.com.","payment_required":false,"parameters":{"description":"string. PRIMARY FIELD. Style, mood, energy, instrumentation, or use-case words. Example: \"epic orchestral trailer\"","genre":"string. Matches Category (for example \"Rock\", \"Hip Hop\", \"Orchestral\")","subgenre":"string. Matches SubCategory","additional":"string. Matches Additional_Categories","tempo":"string. For example \"Medium\", \"Fast\", \"Slow\"","bpm_min":"integer. Minimum BPM","bpm_max":"integer. Maximum BPM","key":"string. For example \"C Minor\", \"G Maj\"","instrumental":"string. Yes (no vocals) or No (has vocals)","keywords":"string. Keyword search","license_type":"string. social_media | all_digital","per_page":"integer. Results per page (max 50, default 20)","page":"integer. Page number"}},{"path":"\/api\/v1\/agent\/ai-search","method":"POST","description":"Natural language search. Send a plain English phrase; the API translates it into search parameters.","payment_required":false,"body":{"phrase":"string. Example: \"I need an upbeat indie rock track for a TV commercial\"","per_page":"integer. Results per page (default 10)"}},{"path":"\/api\/v1\/agent\/catalog\/tracks\/{id}","method":"GET","description":"Full metadata for one track, with standard license pricing and available formats. Ids look like \"417\" or \"partner_82\".","payment_required":false},{"path":"\/api\/v1\/agent\/license\/options","method":"GET","description":"License options with prices: \"personal\" (non-commercial standard licenses) and \"business\" (the rate card: medium, category, territory, term). Add ?track_id= for that track's prices and whether it can be licensed.","payment_required":false},{"path":"\/api\/v1\/agent\/license\/{track_id}\/{license_type}","method":"POST","description":"Personal (non-commercial) license. Returns 402 with payment instructions. Append ?mode=gpt to receive 200 instead of 402.","payment_required":true,"payment_protocol":"x402","body":{"paying_wallet":"string, required. Base wallet the USDC will be sent from (0x...)","licensee_name":"string, optional","project_title":"string, optional","usage":"string, optional","email":"string, optional. Receives the license email","country":"string, optional. Two-letter country code"},"license_types":{"social_media":"$10.00. Personal, non-commercial videos on TikTok, Instagram, YouTube, X, and similar platforms. Perpetual, worldwide","all_digital":"$35.00. Non-commercial use on websites, podcasts, streaming, and online video. Perpetual, worldwide"}},{"path":"\/api\/v1\/agent\/license\/quote","method":"POST","description":"Business license from the rate card. Returns 402 with payment instructions.","payment_required":true,"payment_protocol":"x402","body":{"licensee_type":"string, optional. business (default) or personal","track_id":"string, required. For example \"417\" or \"partner_82\"","medium":"string, required. From \/license\/options (business)","category":"string, required. From \/license\/options","territory":"string, required. From \/license\/options","term":"string, required. From \/license\/options","custom_months":"integer, optional. 1 to 36, where allows_custom_term is true","paying_wallet":"string, required","licensee_name":"string, optional","project_title":"string, optional","usage":"string, optional","email":"string, optional","country":"string, optional"}},{"path":"\/api\/v1\/agent\/license\/verify\/{payment_id}","method":"GET","description":"Poll for the license. 202 while waiting, 200 with license number, download links, and agreement PDF once paid, 410 if the payment window expired.","payment_required":false,"poll_interval":"5 seconds"},{"path":"\/api\/mcp","method":"POST","description":"MCP JSON-RPC 2.0 endpoint. Supports initialize, tools\/list, tools\/call, and ping. No authentication.","payment_required":false,"protocol":"MCP 2025-06-18"}]},"responses":{"catalog_search":{"data":[{"id":"string. \"417\" or \"partner_82\"","source":"string. onchain | partner","title":"string","artists":"array. [{id, name}]","genre":"string","subgenre":"string","bpm":"integer","duration":"string","instrumental":"boolean","description":"string","preview_url":"string. MP3 preview","artwork_url":"string","formats_available":"object. {mp3, wav, aif}","license_purchase_url":"string"}],"meta":{"total":"integer","per_page":"integer","current_page":"integer","last_page":"integer","fallback":"boolean. true if filters were relaxed to return results","results_url":"string. Opens every match on onchainmusic.com"}},"license_issued":{"status":"license_issued","payment_id":"string. OCM-Q000123","license_number":"string. OCM-L000123","license_document":"object. Track, license, payment, and HMAC signature","downloads":"object. Signed link per format","license_pdf_url":"string. License agreement PDF","links_expire_at":"string. Links expire after 30 days"}}}