Servidor MCP

Audora

music.audora/audora
Marketing y publicidad Medios y contenido Público y accesible MCP 2026-07-28

Qué hace este MCP

Manages an artist's music catalog, release preparation, distribution readiness, promotional campaigns, media assets, events, and performance statistics.

add_post
Add a post
Add a post to a campaign on one lane and day, as Promo's + does, with its words and a picture or video from the Library if you have them. It is a draft until it is scheduled.
Esquema de entrada
{'type': 'object', 'required': ['campaign_id', 'lane', 'date'], 'properties': {'date': {'type': 'string', 'description': "The day it goes out, YYYY-MM-DD, inside the campaign's window and not in the past."}, 'lane': {'enum': ['instagram', 'story', 'facebook', 'tiktok', 'youtube'], 'type': 'string', 'description': 'Where it goes.'}, 'time': {'type': 'string', 'description': "The time it goes out, HH:MM 24-hour, in the artist's own time zone."}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'caption': {'type': 'string', 'description': "The words of the post, as they will be published. The lane's limit and Audora's text rules apply (no placeholders, nothing that points back at another post)."}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would do, without writing anything.'}, 'hashtags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 12 hashtags, with or without #. Replaces the list.'}, 'link_url': {'type': ['string', 'null'], 'description': 'A web address the post links to, or null to remove it.'}, 'campaign_id': {'type': 'string', 'description': 'From list_campaigns.'}, 'media_asset_id': {'type': 'string', 'description': "A picture (for a picture post) or a video (for a video post) already in the artist's Library, by its media asset id. Audora does not make pictures or videos through this connection."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
answer_release_question
Send the artist's answer to Audora
Send the ARTIST'S answer to a question Audora asked about their release (see get_release_questions). Ask the artist and relay what they say. Never answer for them and never guess: an answer can be a statement about rights or ownership that Audora relies on. Audora is told it came through their assistant. The release status does not change; Audora reads the answer and moves the release on.
Esquema de entrada
{'type': 'object', 'required': ['release_id', 'answer'], 'properties': {'answer': {'type': 'string', 'description': "The artist's answer, in their words. Up to 4000 characters."}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'dry_run': {'type': 'boolean', 'description': 'True to check the question is open, without sending anything.'}, 'release_id': {'type': 'string'}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the answer is sent once.'}}, 'additionalProperties': False}
cancel_event
Cancel a show or party
Cancel one of the artist's events. Everyone invited or coming is told. Artist connections only.
Esquema de entrada
{'type': 'object', 'required': ['event_id'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'event_id': {'type': 'string'}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
catalog_import_status
How the import is going
The latest import (or the one named): how many records are in, and each record's outcome.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'job_id': {'type': 'string'}}, 'additionalProperties': False}
check_readiness
What is still missing
For one track or one album: everything Audora still needs before that release could be submitted, and anything worth a second look that does not block it. That includes the stores' intake rules, checked against the uploaded master and cover themselves (WAV 16/24-bit 44.1 kHz stereo; square RGB JPG 3000–6000 px). Call this after writing, and again before telling the artist something is ready.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'album_id': {'type': 'string', 'description': 'Check an album or EP. Give this or track_id, not both.'}, 'track_id': {'type': 'string', 'description': 'Check a single. Give this or album_id, not both.'}}, 'additionalProperties': False}
close_todo
Close a to-do
Close one to-do the artist does not want to see, exactly as closing it in Audora does: it comes back by itself when what it is about changes. A track's or album's missing details are not closed: they are fixed.
Esquema de entrada
{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': "The to-do's key, from list_todos."}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
confirm_my_music
Confirm which music is the artist's
"That's me": record the candidates the ARTIST said are theirs (a catalog can be split across pages). Only ids find_my_music offered. Ask the artist. Never confirm on a guess.
Esquema de entrada
{'type': 'object', 'required': ['deezer_ids'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'deezer_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': "The candidates' ids the artist picked."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and it happens once.'}}, 'additionalProperties': False}
create_album
Add an album
Create an album or EP. Put tracks on it afterward with set_album_tracks.
Esquema de entrada
{'type': 'object', 'required': ['fields'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'fields': {'type': 'object', 'description': 'The fields to set, by the `name` get_requirements gives each one.', 'additionalProperties': True}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would replace, without writing anything.'}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the create happens once.'}}, 'additionalProperties': False}
create_track
Add a track
Create a track from its metadata. The audio and the cover art are uploaded separately. Pass idempotency_key if you might retry, so a timeout does not leave two tracks.
Esquema de entrada
{'type': 'object', 'required': ['fields'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'fields': {'type': 'object', 'description': 'The fields to set, by the `name` get_requirements gives each one.', 'additionalProperties': True}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would replace, without writing anything.'}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the create happens once.'}}, 'additionalProperties': False}
design_in_audora
Open Audora's design tools
Audora can design a logo, cover art, brand colors and typefaces, artist photos, and promotion posts and short videos for the artist. Those are made inside Audora, not through this connection: call this to get the exact page to send the artist to, with a sentence on what they will find there. Use it whenever the artist wants a logo, artwork, a cover, visuals, photos or promo video made.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['what'], 'properties': {'what': {'enum': ['logo', 'cover_art', 'palette', 'typography', 'artist_photos', 'promotion'], 'type': 'string'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'album_id': {'type': 'string', 'description': 'For cover_art on an album or EP.'}, 'track_id': {'type': 'string', 'description': 'For cover_art on a single.'}}, 'additionalProperties': False}
finalize_upload
Check an uploaded file and attach it
Audora reads the file you uploaded (the file itself, not its name) and attaches it only if it meets the upload spec. A master that is secretly an MP3, or a cover that is not square or is under 3000 pixels, is refused here and the file is removed. Passing here is not the same as being releasable: a release also needs a WAV 16/24-bit 44.1 kHz stereo master and a square RGB JPG cover of 3000–6000 px, which check_readiness reports on.
Esquema de entrada
{'type': 'object', 'required': ['upload_id'], 'properties': {'name': {'type': 'string', 'description': 'A short name, for an artist image.'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'upload_id': {'type': 'string'}}, 'additionalProperties': False}
find_my_music
Find the artist's released music
Find which artist on Deezer (and Apple Music) is this artist, to bring their released records in: the confirmed one, or candidates to show the artist. A link to their music (Deezer, Spotify or Apple, artist or record) searches from that instead of the name.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'link': {'type': 'string', 'description': "Optional: a link to the artist's music."}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
find_online
Look the artist up online
Starts a lookup of what the artist has already published (streaming profiles, releases, their site and social profiles), or reads where one is and what it found. With action "start" it begins one, which takes 1–2 minutes; the artist gets a few a day, shared with Soundcheck in Audora. With action "status" (the default) it reads the newest lookup, or the one named by run_id. Every fact comes with the pages it was read on. It never changes the artist's profile: when it is done, call propose_profile so the artist keeps what is theirs in Audora.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'link': {'type': 'string', 'description': 'For start: one page the artist is on (Spotify, Apple Music, Deezer, SoundCloud, YouTube, Bandcamp, their site, Instagram), as a full https:// address. It is the best starting point.'}, 'action': {'enum': ['start', 'status'], 'type': 'string', 'description': '"start" a new lookup, or read its "status". Default: status.'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'not_me': {'type': 'array', 'items': {'type': 'string'}, 'description': 'For start: names of earlier matches the artist said are not them.'}, 'run_id': {'type': 'string', 'description': 'For status: a particular lookup. Default: the newest.'}}, 'additionalProperties': False}
get_campaign
A campaign's calendar
One campaign as Promo's calendar: every post by day and lane, with its words, hashtags, picture or video, status, and schedule_check: exactly what Audora's Schedule would decide about it now, and in the artist's words what it still needs.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['campaign_id'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'campaign_id': {'type': 'string', 'description': 'From list_campaigns.'}}, 'additionalProperties': False}
get_limits
What this account's plan allows
The plan, whether distribution is included, credits remaining, and the track, album and storage allowances. Check before uploading or preparing a submission.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
get_profile
The artist's profile
The artist profile as Audora holds it.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
get_release_questions
What Audora has asked the artist
Questions Audora's reviewers asked about the artist's releases (for example, whether the rights to a remix are cleared), with the whole conversation. A release with an unanswered question does not go out until the artist answers. Omit release_id for every open question.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'release_id': {'type': 'string', 'description': 'One release, including a closed conversation. Omit for all open questions.'}}, 'additionalProperties': False}
get_requirements
What Audora needs
Every field Audora needs, with its exact limit in characters or words, the closed list to choose from where there is one, and the accepted file formats and sizes. Call this BEFORE filling anything in. The limits differ per field: some are refused when exceeded and some only flagged. What blocks a release is set by Audora, and it changes.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'entity': {'enum': ['artist', 'track', 'track_artist', 'contributor', 'album', 'release', 'split', 'files'], 'type': 'string', 'description': 'Narrow to one kind of thing. Omit for everything.'}, 'release_type': {'enum': ['single', 'ep', 'album', 'compilation'], 'type': 'string', 'description': 'Narrow to the fields this kind of release needs. An album needs more than a single.'}}, 'additionalProperties': False}
get_stats
How the music is doing
Streams, saves and growth per track, which stores and playlists the listening comes from, TikTok use, the audience's age and gender, how the artist's promotion posts performed, and their followers. For the whole catalog, when the artist has connected their own Songstats account, it also gives their numbers across the web (listeners, followers, playlist reach, socials, Shazam, charts), the cities they are listened to in now, the playlists carrying them and dated events. The same numbers the artist sees in Audora. Use it to answer "how is my release doing", to write a pitch or bio from real numbers, or to suggest where to focus next. When a figure is missing, say "not reported yet", never zero.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'album_id': {'type': 'string', 'description': 'Every track on one album or EP.'}, 'track_id': {'type': 'string', 'description': 'One track. Leave out both ids for the whole catalog, which also includes posts, followers and audience.'}}, 'additionalProperties': False}
get_track
One track in full
One track with its billed artists and its song credits.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['track_id'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'track_id': {'type': 'string', 'description': "The track's id, from list_tracks."}}, 'additionalProperties': False}
import_catalog
Bring the records in
Start bringing the chosen records into the catalog, within the plan's room. Covers come in only when the artist said they are theirs to use (rights_confirmed: true, their own words, recorded as their consent); otherwise every record comes in with its codes and the cover is left to upload.
Esquema de entrada
{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['deezer_album_id', 'include'], 'properties': {'include': {'type': 'boolean'}, 'deezer_album_id': {'type': 'string'}}}}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and it happens once.'}, 'rights_confirmed': {'type': 'boolean', 'description': 'Only true when the artist said the covers are theirs to use.'}}, 'additionalProperties': False}
keep_post
Keep a post
Bring a skipped post, or one that did not go out, back as a draft to schedule. A draft is already kept.
Esquema de entrada
{'type': 'object', 'required': ['post_id'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'post_id': {'type': 'string', 'description': "The post's id (post_id from get_campaign or promo_this_week)."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
list_albums
Albums in the catalog
Every album in this account, newest first.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
list_campaigns
Promo campaigns
Every Promo campaign in this account (one per release, plus the posts between releases), with its window, whether it is ahead, running or over, and how many posts are to look at, scheduled, posted or did not go out. Also lists upcoming releases that have no campaign yet, and campaigns being planned right now.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
list_events
The artist's shows and parties
The shows, release parties and listening parties the artist has posted, with who is invited and who is coming. Artist connections only: Scene is between artists.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
list_media
The artist's Library
The artist's pictures or videos in Audora's Library, newest first, searchable by name and filterable by category (Brand kit, Logo, Cover art, Promo, a platform, Generated, Uploaded, Stock footage). Each has a media_asset_id (what update_post takes) and a preview link valid for an hour.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'kind': {'enum': ['images', 'videos'], 'type': 'string', 'description': 'Pictures (default) or videos.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'offset': {'type': 'integer', 'minimum': 0}, 'search': {'type': 'string', 'description': "Words in the item's name, or the artist, track or album it belongs to."}, 'categories': {'type': 'array', 'items': {'enum': ['branding', 'logo', 'cover-art', 'promo', 'tiktok', 'instagram', 'youtube', 'facebook', 'ai-generated', 'uploaded', 'stock'], 'type': 'string'}, 'description': 'Only items in every one of these.'}}, 'additionalProperties': False}
list_releases
Releases and their status
Every release in this account with where it has reached (status_label: Draft, Submitted, Changes asked, Going to the stores, Live, Rejected, Takedown asked, Taken down, Released elsewhere), including anything Audora asked about.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
list_release_todos
A release's checklist
With release_id: the release's "Around the release" checklist (pitch, pre-save, Canvas, lyrics, release day and the weeks after), each with when it is due, why, where it is done and whether it is done. Without: the artist's "Set up once" list (Instagram ready to post, claiming the store profiles, the bio link).
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'release_id': {'type': 'string', 'description': 'The release (list_releases). Leave out for "Set up once".'}}, 'additionalProperties': False}
list_todos
What the artist still needs to do
Every open to-do the artist sees on their pages, most urgent first: what it is, how urgent, where it is fixed and the tool that fixes it from here. Each has a key; closable says whether close_todo can close it.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
list_tracks
Tracks in the catalog
Every track in this account, newest first.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
preview_catalog_import
What can come in
Every record of the confirmed artist with its codes, date and type, matched against the catalog: new, already in the catalog, or in conflict with another account. Also the plan's room for songs and albums.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'deezer_album_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional: only these records.'}}, 'additionalProperties': False}
promo_results
How the posts did
The posts that went out, best first, with their latest reach, likes, comments, shares, saves and views, the totals over the window, and the followers on each connected account. A missing number is not reported yet, never zero.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'days': {'type': 'number', 'description': 'How far back, 1–365 days. Default 90.'}, 'limit': {'type': 'number', 'description': 'How many posts to list, 1–50. Default 10.'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
promo_this_week
What is posting this week
What goes out in the next days across every campaign, what in that time is not scheduled yet (and so will not go out unless it is), and what did not go out lately and needs the artist.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'days': {'type': 'number', 'description': 'How many days ahead, 1–14. Default 7.'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
propose_profile
Put what was found in front of the artist
Puts a finished find_online lookup in front of the artist in Audora and returns the link to it. The artist confirms it is them and keeps what is right there. This call writes nothing to their profile, and you should not copy the findings into update_profile yourself. Their Home says their assistant found something to look at.
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'run_id': {'type': 'string', 'description': 'The lookup to propose. Default: the newest.'}}, 'additionalProperties': False}
report_gap
Tell Audora what you could not do
Call this whenever the artist asks for something there is no tool for, or a tool refuses in a way you cannot work around. It files the ask in Audora's support inbox, where a person reads it, and it shows in the artist's Settings › Support. Call it before you tell the artist no. It changes nothing in their catalog, and it is the only way the ask reaches anyone.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['asked_for'], 'properties': {'note': {'type': 'string', 'description': 'Anything that would help Audora understand the ask.'}, 'asked_for': {'type': 'string', 'description': 'What the artist wanted, in their own words as far as you can keep them.'}, 'tool_tried': {'type': 'string', 'description': 'The tool you tried or looked for, if there was one.'}}, 'additionalProperties': False}
request_upload
Get somewhere to put a file
Ask for a one-time address to upload a master, cover art, a logo or an artist photo to. You need the file's NAME, nothing else. Never ask the artist how big a file is. PUT the file to the address you get back, then call finalize_upload, which reads the file itself and checks the size, the format and the account's storage against it.
Esquema de entrada
{'type': 'object', 'required': ['kind', 'filename'], 'properties': {'kind': {'enum': ['audio', 'cover_art', 'logo', 'artist_image'], 'type': 'string'}, 'bytes': {'type': 'number', 'description': 'Optional. The size in bytes, IF you already know it: it saves a doomed upload. Never ask anyone for it. The server measures the file when it arrives.'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'album_id': {'type': 'string'}, 'filename': {'type': 'string', 'description': "The file's own name, with its extension. Audio is .wav, .flac or .m4a; images are .png, .jpg or .webp. A release going out through Audora needs a .wav master (16/24-bit, 44.1 kHz, stereo) and a .jpg cover (square, 3000–6000 px, RGB). The others upload but cannot be released."}, 'track_id': {'type': 'string', 'description': 'Required for audio; for cover art, give this or album_id.'}, 'mime_type': {'type': 'string'}}, 'additionalProperties': False}
save_event
Post or change a show or party
Post the artist's own show, release party or listening party, or change one (pass event_id). Where: a city and a country, and/or an online link. Inviting artists or Audora stays the artist's to do in Audora; an edit keeps what they chose. Artist connections only.
Esquema de entrada
{'type': 'object', 'required': ['event'], 'properties': {'event': {'type': 'object', 'required': ['kind', 'title', 'starts_at', 'time_zone', 'is_public'], 'properties': {'city': {'type': ['string', 'null']}, 'kind': {'enum': ['show', 'release_party', 'listening_party'], 'type': 'string'}, 'line': {'type': ['string', 'null'], 'description': "One line about it, in the artist's words."}, 'title': {'type': 'string'}, 'country': {'type': ['string', 'null'], 'description': "The country's name as Audora's country list writes it (get_requirements has the list), e.g. Sweden."}, 'ends_at': {'type': ['string', 'null'], 'description': 'ISO date and time, or null.'}, 'is_public': {'type': 'boolean', 'description': "Show it on the artist's public page."}, 'starts_at': {'type': 'string', 'description': 'ISO date and time.'}, 'time_zone': {'type': 'string', 'description': 'IANA zone where it happens, e.g. Europe/Stockholm.'}, 'online_url': {'type': ['string', 'null'], 'description': 'https link, for one online.'}, 'release_id': {'type': ['string', 'null'], 'description': "A party for one of the artist's releases (once it is out)."}, 'ticket_url': {'type': ['string', 'null'], 'description': 'https link to tickets or info.'}, 'venue_name': {'type': ['string', 'null']}}}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'event_id': {'type': 'string', 'description': 'To change one; leave out to post a new one.'}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
save_release_draft
Prepare a release, as a draft
Write the release details for a track or album as a DRAFT. A draft costs nothing, can be changed and goes nowhere until the artist says so. Returns a draft_hash identifying exactly what you prepared, and release_rules: everything the track or album still needs to meet the stores' rules (master format, cover, sub-genre, languages, countries, performer roles) before it can be submitted. An older track or album usually needs some of it.
Esquema de entrada
{'type': 'object', 'required': ['type', 'item_id'], 'properties': {'type': {'enum': ['track', 'album'], 'type': 'string'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'item_id': {'type': 'string', 'description': "The track's or album's id."}, 'release': {'type': 'object', 'description': 'The release fields, by the names get_requirements(entity: "release") gives them, for example { "release_type": "single", "scheduled_date": "2026-11-20", "description": "...", "pitching_directly": "...", "release_timeline": "...", "artist_quotes": "..." }. Add "splits" for royalty splits. Send only what you are setting.', 'additionalProperties': True}}, 'additionalProperties': False}
send_feedback
Tell Audora how it could serve the artist better
Send Audora feedback it will read, as one of these kinds. missing_capability: a change you would need to do what the artist wants. connector_improvement: how this connector could work better for an assistant, such as a confusing tool, a missing field or a result that did not tell you enough. product_improvement: how Audora itself could serve artists better. bug: something that looks broken. other: anything else. It goes into Audora's support inbox and shows in the artist's Settings › Support, so write it for a person: what you were trying to do, what got in the way and what would have helped. Use it when you notice something worth fixing. You do not need the artist's permission, but set artist_asked to true when the artist asked for it. For a plain "there is no tool for that", report_gap is enough.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['kind', 'summary', 'details'], 'properties': {'kind': {'enum': ['missing_capability', 'connector_improvement', 'product_improvement', 'bug', 'other'], 'type': 'string', 'description': 'What this is about.'}, 'tool': {'type': 'string', 'description': 'The tool this is about, if it is about one.'}, 'details': {'type': 'string', 'description': 'What you or the artist were trying to do, what got in the way and the change that would have helped. Up to 5000 characters. No passwords, tokens or other secrets.'}, 'summary': {'type': 'string', 'description': 'One line someone at Audora can triage from. Up to 120 characters.'}, 'artist_asked': {'type': 'boolean', 'description': 'True when the artist asked for this or said it; false or omitted when it is your own observation.'}}, 'additionalProperties': False}
set_album_tracks
Set an album's running order
Put these tracks on this album, in this order. Replaces whatever was on it. A track left out is taken off the album, not deleted.
Esquema de entrada
{'type': 'object', 'required': ['album_id', 'track_ids'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would replace, without writing anything.'}, 'album_id': {'type': 'string'}, 'track_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'In running order.'}}, 'additionalProperties': False}
set_first_listen
First listen on release day
Switch a release on or off the list other artists on Audora see on release day, to give it a first listen. Refused for a release out more than four weeks ago or released elsewhere.
Esquema de entrada
{'type': 'object', 'required': ['release_id', 'on'], 'properties': {'on': {'type': 'boolean'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'release_id': {'type': 'string', 'description': 'From list_releases.'}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and it happens once.'}}, 'additionalProperties': False}
set_todo_done
Tick a checklist item
Mark one checklist item done, or not done again: the tick in Audora.
Esquema de entrada
{'type': 'object', 'required': ['todo_id', 'done'], 'properties': {'done': {'type': 'boolean'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'todo_id': {'type': 'string', 'description': 'From list_release_todos.'}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
set_track_artists
Set who a track is billed to
Replace the OTHER artists a track is billed to: the "Artist & Guest feat. Guest" line on every store. The account's own artist is always billed first and cannot be removed. Do not send it (a name equal to it is dropped, never printed twice). Send the others in billing order. `primary` and `with` join the main credit after the account's artist; `featured` and `remixer` become the "feat." part. Another `primary` artist is a collaboration: ask the artist whether they have all the rights needed for it, and send rights_confirmed: true only when they say yes. Without it the call is refused and nothing is written. `featured`, `with` and `remixer` need no confirmation. Optional: a track with none is billed to the artist profile's own name. The songwriter, performer and producer credits are a different list, set with set_track_credits.
Esquema de entrada
{'type': 'object', 'required': ['track_id', 'artists'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'artists': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'role'], 'properties': {'name': {'type': 'string', 'description': 'Exactly as it should read on the store.'}, 'role': {'enum': ['primary', 'featured', 'with', 'remixer'], 'type': 'string'}}}, 'description': "The artists besides the account's own, in billing order. An empty list clears the billing back to the artist's own name."}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would replace, without writing anything.'}, 'track_id': {'type': 'string'}, 'rights_confirmed': {'type': 'boolean', 'description': 'Required as true when the list has a `primary` artist besides the account\'s own. Ask the artist first, in these words: "I have all the rights needed for this collaboration". Send true only when they confirm it. Never assume it: it is recorded as their legal confirmation.'}}, 'additionalProperties': False}
set_track_credits
Credit who made a track
Replace a track's song credits with this list. Every track needs at least one songwriter, one performer and one producer before its release can be submitted. These are real people: ask the artist, and never invent a name to satisfy the requirement.
Esquema de entrada
{'type': 'object', 'required': ['track_id', 'credits'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'credits': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Each entry: name, role (songwriter | performer | producer). A performer also takes performer_type (primary | featured | non_featured, default primary) and instrument, which is REQUIRED for a performer: what they played or sang, spelled exactly as in get_requirements\' `performer_roles` list (e.g. "Vocals - Lead Vocals"). Songwriters and producers take no instrument.'}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would replace, without writing anything.'}, 'track_id': {'type': 'string'}}, 'additionalProperties': False}
skip_post
Skip a post
Skip a post so it does not go out. It stays on the campaign and keep_post brings it back. Skipping a post that is already scheduled takes it out of the queue and returns its posting credit, and needs the schedule permission.
Esquema de entrada
{'type': 'object', 'required': ['post_id'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'post_id': {'type': 'string', 'description': "The post's id (post_id from get_campaign or promo_this_week)."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
start_campaign
Start a Promo campaign
Start a campaign for an upcoming or released release, or the posts between releases. Audora plans it (every post's day, time, words and lane) for free; fill each post from the artist's Library with update_post, or, with the artist's spend permission, have Audora make the pictures and videos (make: true, priced first). Each post costs 1 credit when it goes out, set aside when it is scheduled. Use dry_run first to see the posts and the price and tell the artist.
Esquema de entrada
{'type': 'object', 'required': ['lanes', 'size'], 'properties': {'make': {'type': 'boolean', 'description': "Have Audora make every post's picture or video too (credits; needs the artist's spend permission). Default: plan only."}, 'note': {'type': 'string', 'description': "Optional, ≤ 200 characters: anything the planner should know (a show, the story behind the song), in the artist's words."}, 'size': {'enum': ['light', 'steady', 'loud'], 'type': 'string', 'description': 'light, steady or loud: how many posts over how many weeks.'}, 'lanes': {'type': 'array', 'items': {'enum': ['instagram', 'story', 'facebook', 'tiktok', 'youtube'], 'type': 'string'}, 'description': 'Where the posts go. Only lanes with a connected account are planned.'}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would do, without writing anything.'}, 'release_id': {'type': 'string', 'description': "The release (from list_releases or list_campaigns' can_start). Or use between_releases."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}, 'between_releases': {'type': 'boolean', 'description': 'True for the posts between releases instead of a release.'}, 'confirm_cost_credits': {'type': 'number', 'description': 'The price a dry run quoted (charged_at_start) and you told the artist. Required with make, or when the plan itself has a price.'}}, 'additionalProperties': False}
update_album
Change an album
Amend an album's details. Refused once its release has been submitted.
Esquema de entrada
{'type': 'object', 'required': ['album_id', 'fields'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'fields': {'type': 'object', 'description': 'The fields to set, by the `name` get_requirements gives each one.', 'additionalProperties': True}, 'dry_run': {'type': 'boolean', 'description': 'True to see what would change, and what it would replace, without writing anything. Use it before overwriting words the artist wrote.'}, 'album_id': {'type': 'string'}}, 'additionalProperties': False}
update_post
Change a post
Change a post's words, hashtags, link, day, time, or its picture or video (from the Library). Send only what changes. Returns the post with schedule_check: what Schedule would decide now. A post already scheduled can be changed only with the schedule permission; one that went out never.
Esquema de entrada
{'type': 'object', 'required': ['post_id'], 'properties': {'date': {'type': 'string', 'description': "The day it goes out, YYYY-MM-DD, inside the campaign's window and not in the past."}, 'time': {'type': 'string', 'description': "The time it goes out, HH:MM 24-hour, in the artist's own time zone."}, 'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'caption': {'type': 'string', 'description': "The words of the post, as they will be published. The lane's limit and Audora's text rules apply (no placeholders, nothing that points back at another post)."}, 'dry_run': {'type': 'boolean', 'description': 'True to check the call and see what it would do, without writing anything.'}, 'post_id': {'type': 'string', 'description': "The post's id (post_id from get_campaign or promo_this_week)."}, 'hashtags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 12 hashtags, with or without #. Replaces the list.'}, 'link_url': {'type': ['string', 'null'], 'description': 'A web address the post links to, or null to remove it.'}, 'media_asset_id': {'type': 'string', 'description': "A picture (for a picture post) or a video (for a video post) already in the artist's Library, by its media asset id. Audora does not make pictures or videos through this connection."}, 'idempotency_key': {'type': 'string', 'description': 'Send the same key if you retry, and the change happens once.'}}, 'additionalProperties': False}
update_profile
Fill in the artist's profile
Set artist details: name, country, genre, tone, description, the three bios and links. Send only the fields you are changing. Call get_requirements first for the exact limits. An over-long value is refused with the number it got.
Esquema de entrada
{'type': 'object', 'required': ['fields'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'fields': {'type': 'object', 'description': 'The fields to set, by the `name` get_requirements gives each one.', 'additionalProperties': True}, 'dry_run': {'type': 'boolean', 'description': 'True to see what would change, and what it would replace, without writing anything. Use it before overwriting words the artist wrote.'}}, 'additionalProperties': False}
update_track
Change a track
Amend a track's metadata. Refused once its release has been submitted: a submitted release carries a frozen copy, and changing the catalog underneath it is the artist's own decision, because it costs credits.
Esquema de entrada
{'type': 'object', 'required': ['track_id', 'fields'], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}, 'fields': {'type': 'object', 'description': 'The fields to set, by the `name` get_requirements gives each one.', 'additionalProperties': True}, 'dry_run': {'type': 'boolean', 'description': 'True to see what would change, and what it would replace, without writing anything. Use it before overwriting words the artist wrote.'}, 'track_id': {'type': 'string'}}, 'additionalProperties': False}
whoami
Who this connection belongs to
Returns the account this connection acts in (an artist's, or a label's with its roster), what this connection is allowed to do, where the result is reviewed, and next_steps: what to offer the artist next, worked out from the account. Call this first, and again whenever you are unsure whose catalog you are working in. On a label connection, pass `artist` to see one roster artist's account.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'artist': {'type': 'string', 'description': "Only when you are connected as a label: the roster artist this call is for — their artist_user_id from list_roster, or their exact artist name. Required for every artist tool on a label connection. Leave it out on an artist's own connection."}}, 'additionalProperties': False}
Añadido
catalog_import_status
5 de October de 2026 a las 02:40
Añadido
import_catalog
5 de October de 2026 a las 02:40
Añadido
preview_catalog_import
5 de October de 2026 a las 02:40
Añadido
confirm_my_music
5 de October de 2026 a las 02:40
Añadido
find_my_music
5 de October de 2026 a las 02:40
Añadido
cancel_event
5 de October de 2026 a las 02:40
Añadido
save_event
5 de October de 2026 a las 02:40
Añadido
list_events
5 de October de 2026 a las 02:40
Añadido
set_first_listen
5 de October de 2026 a las 02:40
Añadido
list_media
5 de October de 2026 a las 02:40
Añadido
set_todo_done
5 de October de 2026 a las 02:40
Añadido
list_release_todos
5 de October de 2026 a las 02:40
Añadido
close_todo
5 de October de 2026 a las 02:40
Añadido
list_todos
5 de October de 2026 a las 02:40
Añadido
add_post
5 de October de 2026 a las 02:40
Añadido
skip_post
5 de October de 2026 a las 02:40
Añadido
keep_post
5 de October de 2026 a las 02:40
Añadido
update_post
5 de October de 2026 a las 02:40
Añadido
start_campaign
5 de October de 2026 a las 02:40
Añadido
promo_results
5 de October de 2026 a las 02:40
Añadido
promo_this_week
5 de October de 2026 a las 02:40
Añadido
get_campaign
5 de October de 2026 a las 02:40
Añadido
list_campaigns
5 de October de 2026 a las 02:40
Añadido
list_releases
5 de October de 2026 a las 02:40
Añadido
answer_release_question
5 de October de 2026 a las 02:40
Añadido
get_release_questions
5 de October de 2026 a las 02:40
Añadido
save_release_draft
5 de October de 2026 a las 02:40
Añadido
finalize_upload
5 de October de 2026 a las 02:40
Añadido
request_upload
5 de October de 2026 a las 02:40
Añadido
set_album_tracks
5 de October de 2026 a las 02:40