> ## Documentation Index
> Fetch the complete documentation index at: https://docs.patchline.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude plugin

> The official Patchline plugin for Claude Code and Claude Desktop. Wraps the Patchline MCP with the Aria moment skills — drop a track, make a smart link, know your fans, run your day. Install with /plugin marketplace add Patchline-AI/aria.

export const TierBadge = ({tier}) => {
  const styles = {
    free: {
      label: "Free",
      color: "#A1A1AA"
    },
    starter: {
      label: "Starter+",
      color: "#00E6E2"
    },
    pro: {
      label: "Pro+",
      color: "#0068FF"
    },
    scale: {
      label: "Scale+",
      color: "#7A5BFF"
    },
    enterprise: {
      label: "Enterprise",
      color: "#FF7A59"
    },
    all: {
      label: "All plans",
      color: "#22C55E"
    }
  };
  const t = styles[tier?.toLowerCase()] ?? styles.all;
  return <span style={{
    display: "inline-flex",
    alignItems: "center",
    gap: "4px",
    padding: "2px 10px",
    borderRadius: "999px",
    border: `1px solid ${t.color}40`,
    background: `${t.color}1A`,
    color: t.color,
    fontSize: "12px",
    fontWeight: 600,
    fontFamily: "var(--font-family-mono)",
    verticalAlign: "middle"
  }}>
      {t.label}
    </span>;
};

export const AICallout = ({page}) => {
  const slug = page ?? "";
  const mdUrl = `https://docs.patchline.ai${slug}.md`;
  return <div style={{
    marginTop: "32px",
    padding: "16px 20px",
    borderRadius: "12px",
    border: "1px solid rgba(0,230,226,0.25)",
    background: "linear-gradient(135deg, rgba(0,230,226,0.08), rgba(0,104,255,0.05))",
    color: "inherit",
    fontSize: "14px",
    lineHeight: 1.6
  }}>
      <strong style={{
    display: "block",
    marginBottom: "6px",
    color: "#00E6E2"
  }}>
        For AI agents reading this page
      </strong>
      The canonical machine-readable version of this page is at{" "}
      <a href={mdUrl}>
        <code>{mdUrl}</code>
      </a>
      . For product actions, connect to{" "}
      <code>www.patchline.ai/api/mcp/v1</code>
      {" "}and call MCP <code>tools/list</code> for the current tool schema.
      Rules for navigating these docs:{" "}
      <a href="https://docs.patchline.ai/AGENTS.md">
        <code>docs.patchline.ai/AGENTS.md</code>
      </a>
      .
    </div>;
};

The official Patchline plugin for **Claude** (Code + Desktop). It wraps
the [MCP server](/for-agents/mcp-overview) with the **Aria moment
skills** — lean, single-job flows for the moments that matter in a
release. Install once, reload, then just say what you want.

<TierBadge tier="all" />   Free to install. Tool calls consume your AI credit pool.

## Why use the plugin vs. raw MCP

The MCP server gives Claude access to Patchline's product tools. The
Claude plugin adds a thin skill layer on top:

* **Moment skills** — four guided flows, each triggered by a natural
  phrase, that know which tools to call and in what order:
  * `drop` — take a track from upload to a live store listing and a
    shareable release page.
  * `link` — one smart link routing fans to every platform.
  * `fans` — your audience overview, geography, and segments.
  * `operator` — a prioritized to-do list across your catalog and campaigns.
* **A get-started floor** — say "get started" and Aria reads your
  workspace and names the single best next move.
* **Grounded in your catalog** — every skill reads and writes your real
  Patchline data; nothing is invented.

If you're using Claude for music work, the plugin is the right start.
For pure tool access (no skills), use [raw MCP](/for-agents/mcp-install).

## Install on Claude Code

<Steps>
  <Step title="Add the marketplace">
    ```bash theme={null}
    /plugin marketplace add Patchline-AI/aria
    ```
  </Step>

  <Step title="Install the plugin">
    ```bash theme={null}
    /plugin install aria@patchline-ai
    /reload-plugins
    ```
  </Step>

  <Step title="Authenticate">
    ```bash theme={null}
    /mcp
    ```

    Then authenticate `plugin:aria:aria`. Browser opens for OAuth.
  </Step>

  <Step title="Say get started">
    Just type:

    ```text theme={null}
    get started
    ```

    Aria reports your workspace and the best next move. From there, say
    things like "drop my new single" or "make a smart link for my release".
  </Step>
</Steps>

## Install on Claude Desktop

Add to your `claude_desktop_config.json`:

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

Restart Claude Desktop, then say "get started" to begin.

## The moment skills

You don't run commands — you say what you want, and the matching skill
takes over. The four moments:

| Say this                           | Skill      | What it does                                                         |
| ---------------------------------- | ---------- | -------------------------------------------------------------------- |
| "drop my new single"               | `drop`     | Upload to a live store listing and a shareable release page.         |
| "make a smart link for my release" | `link`     | One link routing fans to every platform, resolved from your catalog. |
| "who are my fans"                  | `fans`     | Audience overview, geography, and segments from your live surfaces.  |
| "what should I do today"           | `operator` | A prioritized to-do list across your catalog and campaigns.          |
| "get started"                      | —          | Orients you and names the single best next action.                   |

Each skill knows which MCP tools to call and which Patchline data to
read, so one phrase runs the whole flow.

## Pricing

| Tier      | Plugin access | Per-tool credit costs            |
| --------- | ------------- | -------------------------------- |
| All tiers | Free          | Standard tool credit costs apply |

The plugin itself is free. It's a thin skill layer over the MCP server.

## Repo & support

* **Plugin source:** [github.com/Patchline-AI/aria](https://github.com/Patchline-AI/aria)
* **Issues:** [github.com/Patchline-AI/aria/issues](https://github.com/Patchline-AI/aria/issues)

## Related pages

* [MCP overview](/for-agents/mcp-overview) — the underlying tool surface
* [MCP install](/for-agents/mcp-install) — raw MCP if you don't use Claude
* [MCP tools reference](/for-agents/mcp-tools-reference) — every tool, by family
* [Aria overview](/aria/overview) — Aria in general

## FAQ

<AccordionGroup>
  <Accordion title="Do I need both the plugin AND the MCP server?">
    The plugin includes the MCP server. Don't install both separately —
    you'll get duplicate tool listings. Pick one (plugin if you use
    Claude, raw MCP for other clients).
  </Accordion>

  <Accordion title="Can I use the plugin without a Patchline account?">
    No. The plugin connects to your Patchline workspace. You need a
    free account at minimum.
  </Accordion>

  <Accordion title="How do I trigger a skill?">
    Just say what you want in plain language — "drop my new single",
    "make a smart link", "who are my fans", "what should I do today".
    There are no slash commands to memorize.
  </Accordion>

  <Accordion title="Do I have to follow a fixed order?">
    No. Each skill is a standalone, single-job action. Use whichever
    moment you're in; say "get started" any time you're unsure.
  </Accordion>
</AccordionGroup>

<AICallout page="/for-agents/claude-plugin" />