Add a note to a release review issue — for example to explain a fix or add context for the reviewer. review_issue_id is the id of the issue (from list_review_issues).

Confirm a release that Preflight QC placed on hold, moving it into distribution review. Use after you have reviewed the quality report and accept the release as-is. Safe to repeat.

Create a new artist. Pass its attributes in fields.

Create a new label. Pass its attributes in fields.

Create a new publisher. Pass its attributes in fields.

Create a new release in DRAFT state. Pass its metadata in fields. Required: content_type, label_id, artists, titles, cat (catalog number), artwork_ai_usage, primary_genre_id. Pass idempotency_key and reuse the SAME value if you retry a call whose outcome you did not observe — the server deduplicates by it for 24h; without a key each call is a new operation. Add tracks with create_track, then validate_release before distributing.

Create (or return the existing) short URL for a release’s smart-link landing page. Safe to repeat.

Create a track on a release. Pass its metadata in fields. Required: release_id, disc, track_num, composition_type, artists, audio_ai_usage, composition_ai_usage, commercial_samples, audio_language, contributors, and recording_country (a required ISO 3166-1 alpha-2 country code, e.g. "US"). Pass idempotency_key and reuse the SAME value if you retry a call whose outcome you did not observe — the server deduplicates by it for 24h; without a key each call is a new operation.

Create a webhook subscription. name and url (the HTTPS endpoint that will receive events) are required, along with events selecting which event types to deliver. The API returns a signing secret once on creation — store it to verify incoming payloads.

Create a new songwriter. Pass its attributes in fields.

Delete an artist. The API refuses deletion when the artist is still referenced by releases or tracks.

Delete a label. The API refuses to delete a label that still has releases — remove or reassign its releases first.

Delete a publisher. The API refuses deletion when the publisher is still referenced by writers.

Delete a release. The API only allows deleting a draft that has never been submitted; it refuses to delete a release that has been submitted or distributed.

Delete a release animated cover (motion artwork) video — the square or the tall/portrait cover video. Allowed only while the release is still an editable draft.

Delete a track. Allowed while the parent release is an editable draft; the API refuses once the release is submitted or distributed.

Delete one of a track’s asset files (stereo, Dolby Atmos, or lyrics). Allowed only while the parent release is still an editable draft; the API refuses once the release is locked or distributed.

Permanently delete a track license and its file. track_license_id is the license id (from list_track_licenses). This cannot be undone.

Delete a webhook subscription permanently. It will stop receiving events.

Delete a writer. The API refuses deletion when the writer is still referenced by tracks.

Submit a release for distribution to the stores/outlets — this is the FINAL, consequential action that sends the release out; validate_release should pass first. The server enforces your account’s weekly submission limit and returns a structured error if it is exceeded. Pass idempotency_key and reuse the SAME value if you retry a call whose outcome you did not observe — the server deduplicates by it for 24h; without a key each call is a new submission.

Download statement line items as CSV. Pass invoice_number for a single statement, OR a start_date/end_date range to export across statements. If save_to_path (an absolute path whose parent directory exists) is given, the CSV is written there — an existing file is never overwritten (returns FILE_EXISTS) — and the tool returns the byte count. Otherwise the CSV is returned inline, truncated at 100KB (with truncated: true) — use save_to_path for large exports.

Download the invoice PDF for a statement. save_to_path is REQUIRED (the PDF is binary) and must be an absolute path whose parent directory exists; the PDF is written there — an existing file is never overwritten (returns FILE_EXISTS) — and the tool returns the byte count.

Request Beatport onboarding for a label. This is a one-time action that cannot be un-requested once submitted, so confirm the label is correct first.

Retrieve your accounting summary — current balance and related account-level financial totals.

Retrieve a streaming analytics summary for your catalog in a single call. start_date and end_date (both YYYY-MM-DD) are required and the window is capped at 30 days by the server. Optionally narrow the result by platform (SPOTIFY, ITUNES, APPLE_MUSIC), release_id, isrc, upc, or artist_names. By default all 15 metric sections are returned; pass metrics to request only a subset. Available metrics: streams, listeners, saves, skips, shares, completion-rate, lyrics-view-rate, canvas-view-rate, device-split, source-split, saves-by-tier, streams-by-country, streams-by-gender, streams-by-age, shares-by-country. This endpoint is rate-limited (about 60 requests per minute); a 429 response carries retry_after_seconds.

Retrieve the per-release breakdown of an artificial-streaming fee for one billing period. period is the month in YYYY-MM format.

Retrieve one artist by id, including bio, identifiers and platform links.

List the distribution queue entries for your account, paginated — one entry per (release, outlet) delivery with its current status (e.g. pending review, processing, scheduled, complete, error). Filter by release_id, outlet_id, or status. Use this to see where a release is in the delivery pipeline to each store.

Retrieve one label by id, including its settings and defaults.

Retrieve the smart-link landing-page configuration for a release: whether the links page is enabled, its style/mode, custom copy, the action list and any pre-order links. Pair with update_landing_config to change it.

Return the authenticated LabelGrid account profile, including the release submission limit/quota and terms-acceptance status. Use this to confirm which account your API token belongs to before making other calls.

Retrieve one publisher by id.

Retrieve the Preflight QC quality report for a release: the customer-facing issues found by the automated checks so you can review them before confirming the release into distribution. Preflight QC is an optional add-on — if your account does not have it enabled the API returns a 403, which is surfaced verbatim.

Retrieve one release by id, including its metadata, artwork state and track listing.

Retrieve metadata about a release animated cover (motion artwork) video asset — the square or the tall/portrait cover video — including its processing state.

Get a cursor-paginated royalty breakdown grouped by one or more dimensions. group_by is REQUIRED and is a comma-separated, ordered subset of: track, dsp, release, territory, period (e.g. "release,dsp"). Filter by label_id, release_id, isrc, upc, and a start_date/end_date range.

Retrieve one royalty statement by its invoice number.

Retrieve one Stream Radar flag by id, with its full detail. Stream Radar is an optional add-on; without it the API returns a 403, surfaced verbatim.

Retrieve one track by id, including titles, contributors, writers, publishers and royalty splits.

Return a time-limited, signed URL to download one of a track’s audio assets. asset_type selects the asset: audio_16, audio_24, and audio_32 are the WAV master at that bit depth; audio_preview_full and audio_preview_clip are the generated MP3 preview (full-length / clip). Returns { download_url, expires_in }; the URL expires roughly 10 minutes after it is issued, so request a fresh one when it lapses. Fetch the URL directly — do not send your API token to it.

Retrieve metadata about one of a track’s asset files (its stereo audio, Dolby Atmos audio, or lyrics file), including its processing state. This returns file information, not the bytes — use get_track_audio_download_url for a downloadable link.

Retrieve one license attached to a track by its license id.

Retrieve one webhook subscription by id.

Retrieve the recent delivery log for a webhook — the attempts, response codes and outcomes — to debug why events did or did not reach your endpoint.

Retrieve one writer by id, including PRO/IPI identifiers and publisher link.

List the artificial-streaming records reported for your catalog, cursor-paginated — the per-record detail behind any artificial-streaming fee. Filter by dsp (spotify or apple), a start_date/end_date range, release_id, or isrc.

List the artists in your account, paginated. Filter by artist_name to find a specific artist. Use get_artist for one artist’s full profile and links.

Retrieve the catalog of review issue definitions: each code’s human-readable title, description, severity and whether it blocks distribution. Use it to interpret the codes returned by list_review_issues and the quality report. Issue codes are string slugs.

List the labels in your account, paginated. A label groups your releases and carries default copyright, website and outlet settings. Use get_label for the full detail of one label.

List the publishers in your account, paginated. Filter by name or ipi. Publishers are linked to writers for publishing administration.

Fetch a LabelGrid reference dataset used to resolve the IDs and codes that catalog and release tools expect. Pick ONE dataset with type: genres and genre_categories (values for primary/secondary/tertiary genre IDs), languages (audio and metadata language codes), contributor_roles (valid role names for track contributors), instruments, distro_outlets (the distribution outlets/stores available to your account), or territories (country/territory codes). Call this before creating or updating a release or track when you need a valid ID or code.

List releases in your account, paginated. Filter by label_id, is_live (1 = live/distributed), barcode_number (UPC/EAN), or cat (catalog number). Use get_release for one release’s full metadata and track listing.

List the review issues raised against a release during its automated quality checks. release_id is required. Each issue carries a code (see list_issue_definitions for what each code means), severity, and whether it blocks distribution. Use this to see what a customer must fix before a release can go out.

List your royalty statements, paginated. Filter by label_id, release_id, isrc, upc, and a start_date/end_date range. Pass group_by="release" to roll the totals up per release. Use get_statement for one statement, or download_statement_csv for its line items.

List Stream Radar flags for your releases, paginated — early-warning flags from streaming-integrity monitoring that surface possible artificial-streaming activity so you can act early. Filter by status, severity, dsp, isrc, release_id, and the last-detected date range (detected_from/detected_to). Stream Radar is an optional add-on; without it the API returns a 403, surfaced verbatim.

List the licenses attached to a track (e.g. cover/mechanical or sample clearances), paginated.

List tracks in your account, paginated. Filter by release_id to list a release’s tracks, or by isrc. Use get_track for one track’s full metadata, credits and splits.

List account transactions, paginated. Filter by label_id, release_id, isrc, upc, and a start_date/end_date range; sort with sort; pass group_by="release" to roll up per release.

List every available webhook event type, each with the schema of the payload it delivers. Use it to decide which events to subscribe a webhook to.

List the webhook subscriptions configured on your account, each with its URL, subscribed events and active state.

List the songwriters in your account, paginated. Filter by name or ipi. Writers are attached to tracks for composition credits and royalty splits.

Re-run the Preflight QC automated checks and refresh the release’s quality report. Read the results with get_quality_report. The server applies an hourly refresh budget, so frequent calls may be rate-limited. Preflight QC is an optional add-on.

Revoke a LabelGrid API token. Pass token_id to revoke a specific token; omit it to revoke the token currently in use. WARNING: revoking the current token immediately ends this session — the server loses access and stops working until you configure a new token.

Generate a new signing secret for a webhook and return it. WARNING: the old secret stops working immediately — update your endpoint’s signature verification with the new secret right away or deliveries will fail verification.

This LabelGrid MCP server is not connected to an account yet because no API token is configured. Call this tool to get step-by-step instructions to walk the user through creating a LabelGrid API token and adding it to their MCP client configuration. Returns the setup steps, ready-to-copy client config examples (with a placeholder token), a security note, and the optional settings. Makes no API calls.

Take a release down from ALL outlets/stores — a final, consequential action that removes it everywhere it was delivered. Re-distribution afterward is a fresh submission.

Send a test event to a webhook’s endpoint so you can confirm it is reachable and your signature verification works. Safe to repeat.

Update an artist. Supply only the fields you want to change in fields.

Update a label. Supply only the fields you want to change in fields.

Set the smart-link landing-page configuration for a release. actions uses the current (v2) action-list contract — each entry describes one call-to-action on the page. You can also set links_page_enabled, config_mode, page_style, custom_cta_text, custom_description, and pre_order_links. This replaces the landing configuration.

Update a publisher. Supply only the fields you want to change in fields.

Update a release’s metadata. Supply only the fields you want to change in fields. Once a release has been submitted or distributed, some fields are locked: attempting to change a locked field returns a 403 with code RELEASE_LOCKED_FIELDS, surfaced verbatim so you can see exactly which fields cannot be changed.

Update a track’s metadata. Supply only the fields you want to change in fields. As with releases, some fields lock once the parent release is submitted or distributed.

Replace the file and/or metadata of an existing track license. track_license_id is the id of the license (from list_track_licenses); file_path is the license file to submit. Optionally update license_id, license_provider, license_provider_name, and original_track_link.

Update a webhook subscription. Supply only the fields you want to change: name, url, events, or is_active (set false to pause deliveries).

Update a writer. Supply only the fields you want to change in fields.

Upload an artist photo from a local file. file_path must be a local image file.

Upload a label image from a local file. image_type selects which asset: logo, logo-dark (a dark-mode variant), or background. file_path must be a local image file.

Upload or replace the release’s static cover art image from a local file. Cover art is immutable once the release is distributed — upload the final artwork before distributing.

Upload a finalized animated cover (motion artwork) video for a release — the square or the tall/portrait cover video. The video is uploaded directly to storage and then processed; check its state with get_release_file. Upload the correct video before distributing — it is immutable once the release is live. For the static cover art image use upload_release_artwork.

Upload a finalized audio file (stereo WAV/FLAC or Dolby Atmos) or lyrics (LRC) file for a track. The file is uploaded directly to storage and then processed asynchronously; check its state with get_track_file. Once a release is distributed the file is immutable — upload the correct master before distributing.

Attach a license document to a track (for a cover or a cleared sample). file_path is the local license file and type is "cover" or "sample". Optionally record license_id, license_provider, license_provider_name, and original_track_link. Licenses are immutability-governed once the release is live.

Run validation on a release and return any problems that would block distribution, as both a human-readable errors list and a machine-readable errors_structured list. This is a near-read check: it changes nothing and is safe to repeat. Run it before distributing.