Your entire catalog,
routed directly into your AI.

Orient a new or returning user: reports the workspace (artists, tracks, releases) and the single best next action — connect an artist, add music, get a release out, or grow the audience. Call this FIRST when unsure where to begin; works with no prior context.

Set whether the authenticated workspace is onboarding as an artist, label, or manager. Labels and managers must include labelName. Does NOT complete onboarding — next claim the public username with set_username, then connect an artist with add_artist using the returned rosterRelationshipIntent.

Claim or change the authenticated user's public Patchline username after choosing a role and before adding artist profiles. Uses the same validation, ShareLinks reservation, and rename/alias semantics as web onboarding and Settings; a role (artist/label/manager) must be set first.

Universal dispatcher for Spotify URLs (track, artist, album, playlist) and YouTube URLs (video, channel). Paste a link and get the canonical identity plus a ranked list of next MCP tools to call with exact arguments. Call this FIRST whenever a user shares a Spotify or YouTube link; for artist profiles on other platforms, pass the profile URL straight to add_artist.

List tracks in the user catalog with pagination — title, ISRC, BPM, key, status. Optional artistId scopes to one roster artist (manager accounts).

Import a track's metadata into the catalog from a Spotify track URL — creates a catalog entry with title, artist, ISRC, and platform link (no audio; pair with get_asset_upload_link for audio). Resolve title/artist/ISRC via get_song_intelligence first. Dedup-safe on re-import. A provider-resolved artist that can't be independently corroborated is refused (fail-closed); pass allowLowConfidenceArtist:true only after confirming the artist with the user.

Aggregate fan-graph overview: total fans, captures (7/30d), repeat and active fans, buyers, store revenue, capture rate, and identity stats. Aggregates only — no fan names or emails.

City-level fan geography: hubs with fan counts, total countries/cities, configurable lookback window. For tour routing and geo-targeted promotion. Aggregates only.

Search across the user catalog by title, artist, ISRC, and metadata. Defaults to music/audio assets; set includeNonAudio only when the user asks for cover art, images, or documents.

Full metadata for a single track by asset ID — covers, audio features, version history, distribution status.

Operator actions for owned catalog assets: duplicate candidate scan, reversible archive/restore, dry-run reattribution preview, confirmed canonical-recording repair, and set_cover_art (set a track cover from an owned image asset). No hard delete and no roster deletion.

Cached roster intelligence for a single artist: streaming, social audience, genres, recent activity. Run add_artist first if the artist is missing.

Search artists by name within the user roster.

Top artists by streaming reach. Optional genre and ISO2 market filters return Aria artist ids that can be passed directly to add_artist.

Queue a refresh for one roster artist through Patchline's existing artist intelligence refresh pipeline. Stale-only by default; skips fresh or already pending rows.

Queue bounded stale-only intelligence refreshes for up to 10 roster artists through Patchline's existing artist intelligence refresh pipeline. Returns queued/skipped/failed counts.

Add an artist to the user roster from a platform URL or an ariaArtistId returned by search_artists/get_trending_artists. Name-only is rejected unless explicitly creating a manual profile. Triggers background audience enrichment when canonical identity is available.

Remove an artist from the user roster by patchlineArtistId.

List or filter the authenticated user roster — artists with IDs, platform IDs, enrichment status, genres, and metrics. No query required.

Read-only Monday brief for a serious artist or label owner: roster health, missing identity fields, catalog counts, live surfaces, release/campaign summary, aggregate audience highlights, cleanup candidates, and next actions. No raw fan names, emails, or per-fan journeys.

Release plans, schedules, and campaign details for the authenticated user.

Playlist match opportunities ranked by sonic fit and curator responsiveness for a given track.

Full Spotify playlist intelligence: curator identity, genres, freshness, followers, track turnover, recent additions, submission status.

Smart link landing page for an owned catalog track — server-side resolves ISRC, DSP URLs, and cover art. For pre-release campaigns use create_drop_link instead.

List authenticated-user store inventory and listing readiness. Read-only; reports seller agreement, payout, rights, AI-policy, audio, and marketplace blockers inherited from the store inventory service.

Validate, list, unlist, price, reorder, or update metadata for store inventory through the store inventory service. Mutations inherit all commerce safety checks.

Create or return the authenticated user’s public store surface through the store share service. Returns a store share URL and normalized section config.

Read aggregate store analytics: views, revenue, orders, conversion, and recent sales with buyer emails redacted from MCP output.

Read aggregate store fan segments and engagement stats for the user-owned store surface. No raw fan emails, names, or per-fan journeys.

Create a public release/drop link for an owned release (link-only). For full launch kits with promo videos, captions, and calendar, prefer generate_release_kit.

Create a public asset share link for an owned catalog asset without changing the asset itself. Returns a share URL and normalized section config.

Create a public briefing/report microsite from markdown, validated structured modules, and optional Patchline source references. Template-driven only; does not create arbitrary HTML/CSS/JS.

List owner-safe focused link surfaces for the authenticated user: drops, smart links, asset shares, plus report/briefing microsites for MCP report sharing.

Read owner-safe metadata, normalized section config, source refs, and analytics for a public share surface by URL or shareId.

Update briefing/report microsite metadata or revoke a public share surface. Revoke unpublishes the surface and is destructive.

Read aggregate analytics for an owned public share surface: views, captures, downloads, plays, last viewed, and linked asset/project/campaign IDs.

Read owner-safe metadata and section config for a public surface by URL or shareId.

BPM, key, mood, danceability, and genre tags for a track. Accepts assetId or ISRC.

Full track intelligence: ISRC, audio analysis, playlist matches, streaming stats, collaborators. Accepts a Spotify track URL.

Live chart positions of an artist's tracks on a supported platform (default Spotify) with pagination. Requires an artistId from roster/intelligence tools; canary feature that may be disabled per deployment.

Coverage-limited/experimental musical-work lookup for writers, publishers, and ISWC. Requires Spotify track ID/URL or ISRC; unresolved works return WORK_NOT_RESOLVED with do-not-retry guidance.

Find tracks with similar audio characteristics (vibe, instrumentation, production) to a given catalog asset, ranked by audio-embedding similarity. Restricted to the caller-owned catalog.

Returns the AI-generated bio for an artist from intelligence cache. Populated during enrichment — no live LLM call.

Playlist curator pitch for a specific track. Standard mode is grounded in real track/audio/audience data; cold_start requires verified_context and returns INSUFFICIENT_DATA instead of ungrounded or template copy.

Start release cover art or a promo flyer grounded in catalog intelligence. Pass assetId to derive title/artist/genre/description from the owned track row. Returns an accepted job; poll get_image_job for the coverAssetId before calling set_cover_art.

Check an async cover/image generation job started by generate_image. Returns pending progress, a terminal failure, or the completed cover with coverAssetId ready for set_cover_art. Poll every ~15s while pending; never re-run generate_image on a live job.

Render a promotional disc video for a catalog track: its cover art on a rotating vinyl-style disc over a styled background, with a clipped snippet of the real audio. Outputs multiple aspect ratios (16:9 storefront hero/YouTube, 1:1 feed/drop disc, 9:16, silent 8s spotify-canvas). Rendering is async; read the track with get_asset for status and per-aspect downloads.

Return short-lived playable URLs for every owned promo-video export on a track, including generated 1:1, 16:9, 9:16, and Spotify Canvas variants when available. Raw S3 keys are never exposed.

Full launch kit for drop-this-track intent: promo disc videos, platform captions, 7-day calendar, and drop URL. If no owned S3 cover exists, call generate_image with assetId then set_cover_art before retrying. Poll get_asset mode full for promoDiscVideo; promote with set_promo_video.

Select an uploaded promo-video version, or promote an already-rendered generated promo-disc output, as the public hero video for a caller-owned catalog track.

Create a new Asset Hub record and return a short-lived signed upload URL so the client can PUT bytes directly to storage. Supports audio masters (→ track analysis) and image covers (→ visual library, usable as a track cover via manage_catalog_asset set_cover_art); kind inferred from the extension. Bytes do NOT pass through the MCP server. After the upload completes, call confirm_asset_upload.

Create a short-lived secure browser upload link for a human handoff when the MCP client cannot upload bytes directly. The user opens the link while signed in to Patchline; this does not upload bytes or bypass user auth.

Confirm an upload created by get_asset_upload_link. Marks the asset ready; for audio it also triggers Patchline track analysis (audio fingerprinting, aiMetadata extraction). Image covers finalize with no analysis.

Open the in-chat release-plan panel when the MCP client can render Apps UI. The panel lets the user drop a local audio file, uploads bytes directly from the browser, confirms the asset, calls create_project with trackAssetIds + releaseDate, auto-queues the release plan, and then shows the live track/release-plan/cover/share/storefront checklist.

Resolve the most recent in-progress release-plan session for the signed-in user so remounted MCP Apps UI panels can rehydrate from server state.

Read-only checklist status for a catalog track: track ready, release plan, cover art, share link, storefront, release date, and sonic-profiling state. Pass projectId when available so the plan step reflects campaign generation. Backs the release-plan panel and is safe to poll.

Create a real Patchline project for the signed-in user. For a drop, pass trackAssetIds and releaseDate so the release is born with audio attached and its release plan is generated automatically. Use during Aria start after artist resolution so the local workspace is linked to the Patchline dashboard. Requires artistId from add_artist.

Change the canonical release date for a project/release. Writes through the project API so linked assets and release-backed drop links reflect the new date.

Best-effort read of safe artist/account campaign context for Aria planning: connected platforms, distributor preference, email-list bucket, Telegram linkage, recent releases, defaults. Unknown fields return null instead of failing.

Start async Aria campaign planning for a Patchline project. Requires projectId from create_project and returns polling guidance; use get_campaign to read generated tasks.

Read campaign generation progress for a Patchline project. Defaults to a compact summary; page bounded task or report views explicitly.

Mark an existing campaign task complete or pending through the concurrency-safe campaign task path. Never creates a task.