OnChain Music for AI Agents
Search, license, and work with music programmatically.
Built for AI agents, developers, and autonomous workflows.
What Is the OnChain Music MCP Server?
The Model Context Protocol (MCP) is an open standard that lets AI agents â like Claude, ChatGPT, Cursor, and others â call external tools directly inside their workflows. No manual API integration required. Agents simply connect to our MCP server and immediately have access to our full music catalog, licensing system, and music industry knowledge tools.
Think of it as giving any AI agent a direct line to everything OnChain Music offers â search, license, and music knowledge â with a single connection. We also expose a standard REST API and OpenAPI spec for agents and developers who prefer that route.
How Our Tools Compare
MCP Server
Connect once, use all tools instantly. Works natively with Claude Desktop, Cursor, OpenAI agents, and any MCP-compatible client. No manual API calls required â agents discover and call tools automatically.
REST API
A standard HTTP REST API with full OpenAPI 3.1 spec. Agents that prefer direct HTTP calls can query our catalog, retrieve track metadata, and initiate license purchases programmatically.
OnChain Music GPT
A dedicated ChatGPT agent pre-loaded with our catalog and licensing tools. Users on ChatGPT can search our music and purchase licenses through natural conversation â no setup needed.
llms.txt & agent.json
Machine-readable discovery files that tell AI agents and crawlers what OnChain Music offers, how to authenticate, and how to interact â following emerging standards for AI-readable web content.
Available MCP Tools
12 tools available today. Catalog tools are free â they drive licensing.
Knowledge tools are free for any music project, not just our catalog.
Catalog
đ search_catalog
Search the OnChain Music catalog of 8,700+ independently owned, fully cleared songs, plus partner catalogs.
đ§ ai_search
Search the OnChain Music catalog using a plain English description.
đĩ get_track
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.
Licensing
𧞠initiate_license
Start a license purchase for any track, including partner tracks.
â verify_license
Check whether a license payment has been confirmed on Base.
Music Industry Knowledge
đ get_loudness_standards
Returns the official loudness normalization standards for major music and video platforms.
đ° calculate_songwriter_publisher_split
Split gross songwriter royalties between the songwriter and publisher, and describe the deal type (self-published, co-publishing, full publishing).
đ° calculate_cowriter_split
Split gross songwriter royalties among co-writers by their percentage shares.
đ° calculate_producer_points
Calculate per-unit and total earnings for a producer points deal: the master royalty, the producer's share, and the artist's net.
đ° calculate_sync_fee_split
Split a sync licensing fee between the master rights side and the publishing side, then split the publishing side between publisher and songwriter.
đ° estimate_streaming_royalties
Estimate low, mid, and high streaming payouts for a number of streams on a platform, before and after the artist royalty rate.
đ¸ get_genre_conventions
Returns music industry conventions for a given genre including typical BPM ranges, song structure, instrumentation, key tendencies, production characteristics, and common sync use cases.
Autonomous Licensing Flow
Agents can go from discovery to a signed license document â entirely without human intervention. Payment is USDC on Base via the x402 protocol.
Search the catalog
Use search_catalog or ai_search to find tracks matching your project needs. Filter by genre, BPM, mood, instrumentation, or just describe what you need in plain English.
Get full track details
Call get_track with the track ID to retrieve complete metadata, available formats, and exact license pricing before committing to a purchase.
Initiate the license
POST to /api/v1/agent/license/{track_id}/{license_type} with your Base wallet address. Receive a 402 response with exact USDC payment instructions.
Send USDC on Base
Send the exact USDC amount from your declared wallet to the receiving address on Base (chain ID 8453). No memo or calldata required. Payment is verified by wallet address match.
Receive your license
Poll /api/v1/agent/license/verify/{payment_id} every 5 seconds. Once confirmed, receive a signed license document with HMAC-SHA256 signature and S3 download URLs for MP3, WAV, and AIF.
Social Media License
TikTok, Instagram, YouTube, X, Facebook. Perpetual, worldwide, non-exclusive.
All Digital License
Advertising, apps, games, podcasts, websites, streaming. Perpetual, worldwide, non-exclusive.
Connect in Minutes
Add to your MCP client config, or call the REST API directly. No API key required to get started.
Discoverable by AI Agents & Developers
We follow emerging standards for AI-readable web content and are listed in the major MCP server directories. Agents can find and connect to us automatically.
llms.txt
A plain-text file that tells LLM crawlers what OnChain Music offers and how to interact with us.
View llms.txt âagent.json
Machine-readable agent manifest declaring our capabilities, endpoints, payment protocols, and license types.
View agent.json âOpenAPI Spec
Full OpenAPI 3.1 specification covering every REST endpoint, parameter, and response schema.
View openapi.json âMCP Endpoint
Live JSON-RPC 2.0 MCP server. GET for human info, POST for agent tool calls.
View /api/mcp âListed in MCP Directories
Ready to Build with Music?
Connect your AI agent to our MCP server or call our REST API directly.
No API key required to start searching.
X
Discord
Instagram
TikTok
LinkedIn