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
Six tools available today. Catalog tools are free — they drive licensing.
Knowledge tools are free for any music project, not just our catalog.
🔍 search_catalog
Search 5,000+ fully cleared tracks by genre, BPM, key, mood, instrumentation, and use case. All results are immediately available for licensing with USDC on Base.
🧠 ai_search
Natural language catalog search. Send a plain English phrase and GPT-4o-mini automatically extracts genre, mood, tempo, and other parameters. Best for open-ended creative requests.
🎵 get_track
Retrieve full metadata for a specific track: BPM, key, mood, artist, available formats (MP3, WAV, AIF), license pricing, and terms. Use after search to get full details before purchasing.
🔊 get_loudness_standards
Returns official loudness normalization targets for every major platform — Spotify, Apple Music, YouTube, TikTok, Netflix, broadcast (EBU R128), podcast, and more. Includes LUFS targets and true peak limits.
💰 calculate_royalty_split
Calculates royalty splits and estimated earnings. Handles songwriter/publisher splits, co-writer splits, producer points, sync fee splits, and streaming payout estimates by platform.
🎸 get_genre_conventions
Returns industry conventions for any genre: BPM range, song structure, instrumentation, key tendencies, production characteristics, and common sync use cases for TV, film, and advertising.
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
LinkedIn