Patchline MCP: instructions for AI agents

If you are an AI agent reading this page, this section is here for you. The visual UI above is the human install flow; this block is the machine-readable version.

Endpoint

https://www.patchline.ai/api/mcp/v1

Auth

OAuth 2.0 with PKCE. Discovery via /.well-known/oauth-protected-resource.

Install the Patchline MCP server

# Cursor (preferred)
Install or update the plugin: Patchline-AI/aria
The plugin owns MCP registration; do not add a duplicate direct server.

# Direct config fallback / Claude Desktop
{ "mcpServers": { "Aria": { "url": "https://www.patchline.ai/api/mcp/v1" } } }

# Claude web custom connector
Name: Aria
If the existing row says aria, remove it and add it again as Aria.
Disconnect/reconnect refreshes OAuth only; it does not rename the connector.

# Codex
codex mcp add Aria --url https://www.patchline.ai/api/mcp/v1

# VS Code
{ "mcpServers": { "Aria": { "command": "npx", "args": ["-y", "mcp-remote", "https://www.patchline.ai/api/mcp/v1"] } } }

ALWAYS DO

Call analyze_url FIRST when the user pastes any streaming URL.
Pass a platform URL to add_artist (Spotify, YouTube, TikTok, SoundCloud, Apple Music, Instagram).
Use get_artist_intelligence for cached data; only enrich when stale.
Reference tracks by ISRC or assetId, not free-text title.

NEVER DO

Do not ask the user to sign in manually. OAuth handles it.
Do not invent tool names. Authoritative list at https://www.patchline.ai/api/agents/discovery.
Do not retry on 403. Point the user at /pricing.
Do not scrape /dashboard. Use MCP tools.

Full rules

https://www.patchline.ai/AGENTS.md

Aria MCP Server

Run your music career
by talking to your AI

Connect Claude, ChatGPT, Cursor, or any MCP-ready assistant to Patchline. Aria knows your catalog, storefront, fans, and releases, and it does the work: gets tracks out, cuts share links, builds launch assets, and briefs your roster. Built for artists, managers, and labels.

140+live tools, one server URL

Connect your assistant See plans

Works in

Claude

Cursor

ChatGPT & Codex

VS Code

Included with every Patchline plan

Why operators connect Aria

One server URL. Your catalog, fans, and market data, ready for your assistant to act on.

It acts, it does not just answer

Ask for a share link and get a live one. Ask to get a release out and it lists the track, builds the assets, and hands you the link. Reads and writes, with guardrails.

Your data, fused with the market

Market intelligence tells you what is happening out there. Aria also knows your house: catalog, sales, fans, and release plans. The answer to "what next" needs both.

Automates the recurring work

A weekly roster brief. A release-week checklist that runs itself. A watch on every drop. Works with any assistant that supports scheduled tasks.

In the tools you already use

Claude, ChatGPT, Cursor, VS Code, and any MCP-ready client. One server URL. Sign in with your Patchline account.

How it works

One server, one sign-in. Your assistant does the rest.

Connect the server

Paste the server URL in your MCP client and sign in with Patchline. The install guide on docs.patchline.ai covers every supported app.

Ask, in plain language

No query syntax. New here? Tell your assistant to call get_started and Aria orients it to your account and your best next move.

Aria acts

Reads return instantly. Writes (listings, links, kits, campaigns) run with confirmations and account scoping.

Server URL

https://www.patchline.ai/api/mcp/v1

Set it up in one paste

Copy the install prompt into your assistant and it connects itself. Prefer to do it by hand? Every client is below.

Install prompt

I want to connect Aria, Patchline's music MCP server, to this assistant. 1. Read Patchline's MCP install guide: https://docs.patchline.ai/for-agents/mcp-install 2. Add this remote MCP server with the client registration name "Aria" using https://www.patchline.ai/api/mcp/v1. The server continues to identify itself internally as "aria"; that protocol name is not the saved client label. 3. When prompted, sign in with my Patchline account. After connecting, call get_started and tell me what's already set up on my account plus three concrete things you can do for me as an artist, manager, or label operator.

Prefer to set it up yourself? Read the install guide.

Claude

Use "Aria" as the saved connector name. If Claude already shows "aria", Disconnect/Reconnect only refreshes OAuth: Remove the custom connector, then re-add it with this name and https://www.patchline.ai/api/mcp/v1.

json

{
  "mcpServers": {
    "Aria": {
      "url": "https://www.patchline.ai/api/mcp/v1",
      "transport": "http"
    }
  }
}

After installing, your client opens a browser so you can sign in with Patchline. OAuth 2.0 with PKCE keeps your credentials out of the assistant.

Your first five minutes

Copy one of these into your connected assistant. Each runs real tools against your real account, not a demo.

Artist

>My next single is ready. Check what is left before release, then get it live and give me a link to share.

Returns A readiness check, a live listing, and a share link for your track.

Manager

>Give me this week’s brief for my artists and tell me which one has the highest growth rate.

Returns A weekly brief across your artists, with the growth leaders called out.

Label

>Where are our buyers? Show me top cities and fan segments across the roster.

Returns A geography and fan-segment breakdown you can route promotion against.

Artist

>Give me a release kit for my new song coming out in 6 weeks.

Returns A launch kit: promo assets, captions, a timeline, and a drop link.

Every tool is scoped to your account. Destructive actions stay in the dashboard, on purpose.

Inside the server

The whole job, covered

Research, releases, commerce, fan growth, booking, and content: 140+ live tools organized the way the work actually happens. Your assistant picks the right one; you never memorize a tool name.

The MCP server comes with every plan.Advanced packs unlock as you upgrade

Releases13 tools

Plan and ship a release

Take a finished track from your library to a live release without a spreadsheet in sight.

Upload a master in chat and Aria starts the audio analysis for you
Open a release plan with a date, a readiness checklist, and campaign tasks
Ask what is still blocking the drop and get a straight answer

Ideal for Artists, Managers

Commerce13 tools

Sell direct to fans

Put your music in front of buyers: storefront listings, drop links, and smart links, cut from one conversation.

List a track in your storefront and get a share-ready page back
Create or reuse one exact-track Smart Link with up to five verified Soundcharts destinations, an optional live store offer, and an email gate
Media kits and pitch pages for curators, press, and partners
See which links convert, so promo budget follows the numbers

Ideal for Artists, Labels

Fan Growth · Booking23 tools

Grow the fanbase, book the shows

See who your fans are, where they actually listen, and which cities deserve a show next.

Owned fan counts, cities, and segments from your storefront and captures
Streaming and social audience trends across every platform
The cities where you over-index, so touring money goes where fans are
Venues, local concerts, and festival footprints for routing a run

Ideal for Managers, booking teams

Research21 tools

Run your roster

A living profile of every artist you work with, kept fresh without anyone asking.

Add an artist from a streaming link and Aria builds the profile
A weekly digest that calls out who is growing and who stalled
Refresh intelligence for one artist or the whole roster at once
Keep scouted prospects separate from artists you already represent

Ideal for Managers, Labels

Research53 tools

Scout the market

Spot fast-rising artists before they break, and know if a playlist is worth the pitch.

Rising artists and fast-growing songs in your lane, not just the charts
Playlist fit and live placements, sized before you spend a pitch
Growth compared against competitors, with the evidence attached
Charts, radio spins, and festival lineups on demand

Ideal for A&Rs, Managers

Content19 tools

Make the release content

Cover art, promo videos, bios, and pitches that come from your track, not a template.

Cover art and promo videos generated from the actual song
A full release kit: captions, a launch-week calendar, and a drop link
Bios and curator pitches that cite your real numbers
Audio analysis that tells you what a song is, in plain words

Ideal for Artists, content teams

See the full tool reference on docs.patchline.ai →

Put an operator on your team

Aria MCP is included with every Patchline plan. Connect it in five minutes.

Connect your assistant See plans

Run your music career
by talking to your AI

140+live tools, one server URL

Works in

Claude

Cursor

ChatGPT & Codex

VS Code

Included with every Patchline plan

Patchline MCP: instructions for AI agents

Endpoint

Auth

Install the Patchline MCP server

ALWAYS DO

NEVER DO

Full rules

Run your music careerby talking to your AI

Why operators connect Aria

It acts, it does not just answer

Your data, fused with the market

Automates the recurring work

In the tools you already use

How it works

Connect the server

Ask, in plain language

Aria acts

Set it up in one paste

Your first five minutes

The whole job, covered

Plan and ship a release

Sell direct to fans

Grow the fanbase, book the shows

Run your roster

Scout the market

Make the release content

Put an operator on your team

Patchline MCP: instructions for AI agents

Endpoint

Auth

Install the Patchline MCP server

ALWAYS DO

NEVER DO

Full rules

Run your music careerby talking to your AI

Why operators connect Aria

It acts, it does not just answer

Your data, fused with the market

Automates the recurring work

In the tools you already use

How it works

Connect the server

Ask, in plain language

Aria acts

Set it up in one paste

Your first five minutes

The whole job, covered

Plan and ship a release

Sell direct to fans

Grow the fanbase, book the shows

Run your roster

Scout the market

Make the release content

Put an operator on your team

Run your music career
by talking to your AI

Run your music career
by talking to your AI