Skip to main content
Developer hub — MCP + REST API

Talk to your royalties. Build on them too.

Connect Royalti to Claude or any MCP client in minutes — or build directly against the REST API. Same royalty data, your choice of interface.

169
MCP tools
700+
REST endpoints
19
tool domains
19
currencies
02 / MCP SERVER

Your royalty platform, inside your AI assistant

Royalti's MCP server gives Claude — or any MCP client — direct, permissioned access to your catalog, royalties, splits, and analytics. Ask in plain language; get answers from your real data.

  • "Which artists earned the most last quarter?"analytics · revenue
  • "Reconcile this month's accounting."accounting · payments
  • "Audit metadata across the catalog before Friday's delivery."catalog · files

8 pre-built prompts ship with the server — revenue forecasts, metadata audits, split configuration, and more.

Read the setup guide →
connect — any MCP clientmcp.royalti.io
{
  "mcpServers": {
    "royalti": {
      "url": "https://mcp.royalti.io?api_key=RWAK_…"
    }
  }
}
Claude DesktopClaude CodeCursorWindsurfVS CodeChatGPT DesktopGemini CLI
  • ·accounting
  • ·analytics
  • ·billing
  • ·catalog
  • ·checklists
  • ·currencies
  • ·ddex
  • ·downloads
  • ·expenses
  • ·files
  • ·labels
  • ·notifications
  • ·payments
  • ·releases
  • ·revenue
  • ·search
  • ·sources
  • ·splits
  • ·users
DDEX delivery — included with every paid plan
03 / REST API

700+ endpoints. Every royalty workflow.

// 1 — authenticate, 2 — scope to your workspace
const login = await fetch('https://api.royalti.io/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ email, password }),
}).then(r => r.json());

const { token } = await fetch(
  'https://api.royalti.io/auth/authtoken?currentWorkspace=ws_0001',
  { headers: { Authorization: `Bearer ${login.token}` } }
).then(r => r.json());

// 3 — query your catalog (page-based pagination)
const artists = await fetch(
  'https://api.royalti.io/artists?page=1&size=25',
  { headers: { Authorization: `Bearer ${token}` } }
).then(r => r.json());

Auth, catalog, splits, royalties, accounting, payments, publishing — plus webhooks and real-time events for long-running work.

auth
JWT (6h access / 1d refresh) · workspace + user API keys · OAuth: Google, LinkedIn, Facebook
pagination
page-based — page, size (max 100), sort, order
webhooks
HMAC-signed, per-event subscriptions
real-time
Socket.IO events for file processing + workflows
04 / WHAT YOU CAN BUILD ON

The whole platform is addressable

4.1

Royalty processing

Ingest statements from 30+ distributor formats; AI column mapping handles the rest.

4.2

Catalog + splits

Artists, releases, tracks — and advanced splits: temporal, conditional, succession, bulk CSV.

4.3

Analytics

9 dimensions, 7 chart types, BigQuery-powered at catalog scale.

4.4

Payments + billing

19 currencies, Stripe usage-based billing, member payment flows.

4.5

Publishing + CWR

Works, writers, agreements, registrations — live in production since June 2026.

4.6

DDEX deliveryevery paid plan

ERN/MEAD generation and DSP delivery to Spotify, Apple Music, and more — included with every paid plan.

05 / SECURITY

Scoped keys, your choice of transport

Scoped, revocable keys

Workspace keys (RWAK_) and user keys (RUAK_) — scoped to a tenant, revocable from the dashboard.

Run it locally

Prefer stdio? Run the server on your machine — your key lives in your own client config.

Or use the hosted endpoint

mcp.royalti.io with per-tenant isolation, structured audit logging, and rate limiting on upstream calls.

06 / FAQ

Quick answers

Which AI clients work with the MCP server?

Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, ChatGPT Desktop, and Gemini CLI — anything that speaks MCP.

Are DDEX delivery tools included in my plan?

DDEX delivery (ERN/MEAD) is included with every paid plan — there's nothing separate to buy. Every other tool domain ships with every workspace.

How do I authenticate against the REST API?

JWT sessions (6-hour access, 1-day refresh) or workspace API keys; OAuth sign-in via Google, LinkedIn, or Facebook.

Where's the full API reference?

apidocs.royalti.io — every endpoint, request/response shapes, and integration guides.

Can I run the MCP server myself?

Yes — clone it, build it, and run it locally over stdio; your key stays in your own client config. Most teams use the hosted endpoint at mcp.royalti.io instead.

Start now

Point your AI at your royalty data

Grab a workspace API key from your dashboard and connect your first client today.