Home Creators Fund LIVR Token Artists Developers Streamers Fest FAQ Open App
DEVELOPER & AGENT PLATFORM

Build on Streamlivr

Access creator APIs, MCP servers, and x402 agent payments on Celo to license and reward creators.

x402 Protocol MCP Server USDC on Celo ERC-8004 OpenAPI 3.1

Install the MCP Server

Add Streamlivr's MCP server to your AI agent in one step. Copy the config below for your platform.

Cursor / Claude Desktop / Windsurf
{
  "mcpServers": {
    "streamlivr": {
      "url": "https://api.streamlivr.com/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
ChatGPT / OpenAI Agents
// Use the OpenAPI spec for ChatGPT Actions:
// GET https://api.streamlivr.com/openapi.json
//
// Or call the REST API directly:
GET https://api.streamlivr.com/api/v1/agent/listings?q=lagos&limit=5
GET https://api.streamlivr.com/api/v1/agent/catalog?q=afrobeats&limit=10
GET https://api.streamlivr.com/api/v1/agent/posts?q=gaming&limit=10
A2A Agent Discovery
// Agent-to-Agent discovery card:
GET https://api.streamlivr.com/.well-known/agent.json

// MCP server manifest:
GET https://api.streamlivr.com/.well-known/mcp.json

// OpenAPI document with x402 pricing:
GET https://api.streamlivr.com/openapi.json

How It Works

  • MCP Protocol — Your agent connects via JSON-RPC. Same routes, same prices as HTTP.
  • x402 Payments — The agent signs an EIP-3009 authorization. The Celo facilitator handles gas. No CELO needed.
  • 60/40 Split — 60% goes to the creators whose data was served. 40% to the platform.
  • On-Chain Settlement — Every payment settles as a USDC transfer on Celo. Verifiable on Blockscout.
  • Creator Safety — Only public data is served. No emails, wallets, KYC, or private content. Ever.
Cursor Claude Desktop ChatGPT Windsurf Cline

x402 Agent API Routes

Five paid routes, priced at $0.01 per credited creator. Payments settle in USDC on Celo.

Route Price Returns Attribution
GET /api/v1/agent/ping $0.01 Liveness check that proves settlement works —
GET /api/v1/agent/listings $0.01/creator Public creator listings, searchable and paged Every creator on the page
GET /api/v1/agent/posts $0.01/creator Public posts: captions, tags, media, engagement Owner of the audio on each post
GET /api/v1/agent/catalog $0.01/creator Catalog metadata with recording ownership Artist who owns each recording
GET /api/v1/agent/creator/:id $0.01 One public profile with public counts That creator

Free Discovery Endpoints

Route Returns
GET /api/v1/agent/pricing Price rule, asset details, and worked examples
GET /api/v1/agent/stats Creator/post/track counts and busiest tags
POST /api/v1/agent/chat/interpret Turns a visitor sentence into one API call
GET /.well-known/agent.json A2A agent card with prices and ERC-8004 identity
GET /.well-known/mcp.json MCP server card listing routes as tools
GET /openapi.json OpenAPI 3.1 document with x402 pricing
GET /api/v1/agent/reputation On-chain ERC-8004 reputation + settled volume
# Example: Search for creators in Lagos
curl "https://api.streamlivr.com/api/v1/agent/listings?q=lagos&limit=5"

# Example: Get top afrobeats tracks
curl "https://api.streamlivr.com/api/v1/agent/catalog?q=afrobeats&limit=10"

# Example: Search posts about gaming in Nigeria
curl "https://api.streamlivr.com/api/v1/agent/posts?q=gaming+nigeria&limit=10&sort=views"

Developer Tools

Everything you need to build with Streamlivr's creator data and payment infrastructure.

🔍 Creator Discovery

Find creators by name, country, genre, or content type. Natural language search that understands what you're looking for.

💰 Autonomous Payments

AI agents pay creators directly in USDC on Celo. 60% goes to creators, 40% to the platform. Zero friction.

📊 Creator Attribution

Every payment is attributed to the specific creators whose data was served. Transparent on-chain settlement.

🎵 Music Catalog

Search and license music from Streamlivr's catalog. Every play and license pays the artist who owns the recording.

🔗 MCP Protocol

Connect any AI agent via JSON-RPC. Same routes, same prices as HTTP. Works with Cursor, Claude, ChatGPT, and more.

🛡️ Creator Safety

Only public data is served. No emails, wallets, KYC, or private content. Creators can revoke agent access anytime.

Payment Flow

Every paid request follows the x402 protocol. The buyer never needs CELO — the facilitator covers gas.

1

Request without payment

Call a paid route. Server returns 402 Payment Required with an x402 invoice in the header and JSON body.

2

Sign EIP-3009 authorization

The buyer signs a transferWithAuthorization off-chain. The facilitator picks it up and executes.

3

Retry with payment header

Repeat the request with the X-PAYMENT header containing the signed authorization.

4

Settlement on Celo

USDC transfers to the platform wallet. 60% is attributed to credited creators. Transaction hash in the response header.

Open App