> ## 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.

# Aria via MCP

> Aria's tools, routed straight into Cursor, Codex, VS Code, and any MCP-compatible AI client. Your catalog, roster, releases, playlists, and music data become callable tools — OAuth 2.0 with PKCE, one command to install.

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>;
};

If your AI tool speaks **MCP** — Cursor, Codex, VS Code, or any
MCP-compatible client — Aria's tools plug straight in. Your catalog,
roster, releases, playlists, smart links, and music data become
callable functions your AI can use without leaving its window.

<TierBadge tier="all" />   Free to install on every tier.

## What you get via MCP

* **Your music infrastructure as tools** — `find_playlists`,
  `get_artist_intelligence`, `create_smart_link`, `analyze_url`, and the
  rest of the Patchline tool surface.
* **Your data, in your AI** — paste a Spotify link in Cursor and it
  resolves the track, finds playlists, and drafts a pitch, all inline.
* **Secure by design** — OAuth 2.0 with PKCE; your credentials never
  touch the AI client.

## Install

The endpoint is the same for every client:

```text theme={null}
https://www.patchline.ai/api/mcp/v1
```

Cursor example — Settings → MCP → **+ Add new MCP server**:

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

First tool call opens browser-based OAuth and you're connected.

**Full per-client install, the tool reference, and auth details →
[MCP overview](/for-agents/mcp-overview)** and
**[Install the MCP server](/for-agents/mcp-install).**

## Same Aria, everywhere else

* [Aria on the Web App](/aria/web-app) — the full dashboard
* [Aria on Slack](/aria/slack) — chat with Aria in your team channels
* [Aria on Claude](/aria/claude) — the higher-level Claude plugin

<AICallout page="/aria/mcp" />