Patchline

https://docs.patchline.ai
Admin
Patchline is an AI command center for the modern music business that integrates catalog management,...
Tokens:51,775
Snippets:621
Trust Score:3.5
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install Patchline AI plugin on Claude Code

Source: https://docs.patchline.ai/for-agents/claude-plugin.md

Installation and authentication steps for the Patchline AI plugin on Claude Code. Add the marketplace, install the plugin, authenticate via /mcp, then type 'get started' to have Aria report your workspace and best next move.

```bash
/plugin marketplace add Patchline-AI/aria
```

```bash
/plugin install aria@patchline-ai
/reload-plugins
```

```bash
/mcp
```

```text
get started
```

--------------------------------

### analyze_url example return

Source: https://docs.patchline.ai/for-agents/mcp-tools-reference.md

Example JSON response from the analyze_url tool, showing canonical identity and next steps.

```json
{
  "type": "track",
  "id": "4iV5W9uYEdYUVa79Axb7Rh",
  "isrc": "GBUM71029604",
  "name": "Bohemian Rhapsody",
  "artist": "Queen",
  "platform": "spotify",
  "nextSteps": [
    { "tool": "get_song_intelligence", "args": { "spotify_url": "..." } },
    { "tool": "get_audio_features",     "args": { "isrc": "GBUM71029604" } }
  ]
}
```

--------------------------------

### analyze_url example call

Source: https://docs.patchline.ai/for-agents/mcp-tools-reference.md

Example JSON-RPC call to the analyze_url tool with a Spotify track URL.

```json
{
  "name": "analyze_url",
  "arguments": {
    "url": "https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh"
  }
}
```

--------------------------------

### Configure claude_desktop_config.json for Patchline MCP

Source: https://docs.patchline.ai/for-agents/claude-plugin.md

Add this configuration to your claude_desktop_config.json to install the Patchline MCP server for Claude Desktop. After adding it, restart Claude Desktop and say "get started" to begin.

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

--------------------------------

### Cursor MCP deeplink installer URL

Source: https://docs.patchline.ai/for-agents/mcp-install.md

One-click install URL for Cursor's MCP deeplink installer. Open this URL on the same machine running Cursor to trigger the installation of the Patchline MCP server named 'aria'.

```text
cursor://anysphere.cursor-deeplink/mcp/install?name=aria&config=eyJhcmlhIjp7InVybCI6Imh0dHBzOi8vd3d3LnBhdGNobGluZS5haS9hcGkvbWNwL3YxIn19
```

--------------------------------

### Install Aria plugin in Claude Code

Source: https://docs.patchline.ai/aria/claude.md

Install the official Patchline plugin for Aria in Claude Code. Run these two commands in sequence, then authenticate with /mcp and start a project with /aria:start.

```bash
/plugin marketplace add Patchline-AI/aria
/plugin install aria@patchline-ai
```

--------------------------------

### Claude Code one-line install and verification

Source: https://docs.patchline.ai/for-agents/install-docs-mcp.md

Install the Patchline Docs MCP server in Claude Code with a single command, then verify it appears in the list with `claude mcp list`.

```bash
claude mcp add --transport http patchline-docs https://docs.patchline.ai/mcp
```

```bash
claude mcp list
```

--------------------------------

### Example campaign blueprint for a dreampop single (Mira's "Sleeper")

Source: https://docs.patchline.ai/releases/release-planner.md

Shows the full 8-week campaign blueprint for a dreampop single, with phases from pre-production to post-release. Each item is an actionable, dated task; some include inline Patchline actions like pitch links, smart links, media kits, drop links, or store link flows.

```text
🎵  Sleeper — Mira — Single, self-releasing
    Target release: 2026-07-15 (in 8 weeks — standard runway)
    Sonic positioning: dreampop-adjacent, slow, melancholy, soft acoustic

━ PRE-PRODUCTION (day -75 to -46) ─────────────────────────────
  □ Finalize master + alt-mix references
  □ Lock cover art + canvas video
  □ Confirm distribution timeline
  □ Brief any collaborators on release-week deliverables

━ PLANNING (day -45 to -22) ───────────────────────────────────
  □ Build Patchline Smart Link (pre-save + storefront wired in)
  □ Assemble curator research list for dreampop-adjacent pitching
  □ Draft Spotify editorial pitch — submission window opens day -28

━ PRE-RELEASE (day -21 to -8) ─────────────────────────────────
  □ Submit Spotify editorial pitch via S4A
  □ Submit Apple Music for Artists editorial
  □ Pre-save go-live
  □ Prepare fan-email copy
  □ Personal DMs to the 8 priority curators
  □ Teaser content drop (Patchline media kit)

━ ANNOUNCEMENT (day -7 to -1) ─────────────────────────────────
  □ Release-week social posts (3 platforms — drafts in Aria)
  □ Fan-email final send
  □ Storefront banner swap

━ RELEASE (day 0 to +7) ───────────────────────────────────────
  □ Release-day post (Aria has the drafts)
  □ TikTok teaser drop
  □ First-week DM follow-ups to curators who added
  □ Storefront launch

━ POST-RELEASE (day +8 to +42) ────────────────────────────────
  □ TikTok ad test — $50, dreampop cluster
  □ Follow-up pitch to curators who didn't add (Aria drafts)
  □ Week 2 performance review
  □ Post-mortem: streams vs forecast
  □ Hand momentum to next release
```

--------------------------------

### Manual Cursor MCP configuration for patchline-docs

Source: https://docs.patchline.ai/for-agents/install-docs-mcp.md

JSON configuration for adding the Patchline docs MCP server manually in Cursor. Paste into Settings → MCP → + Add new MCP server. The server URL is https://docs.patchline.ai/mcp.

```json
{
  "mcpServers": {
    "patchline-docs": {
      "url": "https://docs.patchline.ai/mcp"
    }
  }
}
```

--------------------------------

### Aria analyze_url MCP tool call example

Source: https://docs.patchline.ai/catalog/import.md

Shows a bash comment describing Aria's analyze_url tool, which determines the type of URL (track, album, EP, artist, or playlist) and returns the canonical identity plus a ranked list of follow-up tool calls.

```bash
# Aria's analyze_url is the universal dispatcher — it figures out whether
# the URL is a track, album, EP, artist, or playlist, and returns the
# canonical identity plus a ranked list of follow-up tool calls.
```

--------------------------------

### Install and authenticate Patchline Aria plugin in Claude Code

Source: https://docs.patchline.ai/for-agents/mcp-install.md

Add the Patchline-AI/aria marketplace, install the aria plugin, reload plugins, then run /mcp to authenticate with plugin:aria:aria via browser OAuth.

```bash
/plugin marketplace add Patchline-AI/aria
```

```bash
/plugin install aria@patchline-ai
/reload-plugins
```

```bash
/mcp
```

--------------------------------

### Fan graph output example

Source: https://docs.patchline.ai/artists/audience.md

Example of the fan graph output when asking Aria to show the fan graph across the roster. The response includes an overlap matrix, cluster breakdowns, and identifies Velvet Bird as the bridge artist.

```text
You: Show me the fan graph across my roster
Aria: 5 artists, ~32k unique fans:

       Mira    Tessa   Cleo Bell   Run Hot   Velvet Bird
Mira       —    14%       18%         3%         9%
Tessa     14%     —       22%         2%         11%
CleoB     18%   22%        —          1%         8%
RunHot     3%    2%        1%         —          15%
VelvB      9%   11%        8%        15%         —

Cluster 1 (dreampop, 56% of unique fans):
  Mira + Tessa + Cleo Bell + Velvet Bird (slightly)
  Top markets: LA, NYC, London, Stockholm

Cluster 2 (electronic, 18%):
  Run Hot + Velvet Bird (slightly)
  Top markets: Berlin, Detroit, Tokyo

Cluster 3 (crossover, 11%):
  Velvet Bird connects both clusters.
  3,500 fans listen to ≥ 2 artists across clusters.

Bridge artist: Velvet Bird. Pushing her releases benefits both
clusters disproportionately.
```
Tokens:
Raw