AudiencePlayer

Reposition an Article within its hierarchy (before/after a sibling, or as the last child of another Article), automatically adjusting its type to match its new position (e.g. an Article moved under a "season" becomes an "episode"). Moving under another Article requires that Article to be a "series" or a "season", otherwise it fails with a conflict. MCP guidance: The moved Article's type is silently changed to fit its new position, its season/episode numbers are renumbered across the tree, and the url slugs of the Article and all its descendants are rebuilt, which changes their public URLs.

article_node_update

Update an existing Article's metadata.

article_update

Fetch a single Asset's full Admin details by id. MCP guidance: An Asset whose status is "deleted" (soft-deleted) is reported as not found, the same as a nonexistent id. There is no separate error to distinguish the two cases. Some response fields (e.g. download URLs, admin-only fields) are only populated when the caller holds the corresponding permission; their absence does not mean the Asset lacks that data.

asset

Replace the master video/audio content (optionally including images/subtitles) of Asset id with the content of replacement_asset_id. Both Assets must use the same media provider and be of the same non-live type. Runs asynchronously; once the replacement completes, replacement_asset_id is soft-deleted (it keeps its record with status "deleted", while its remote content and Files are cleared). MCP guidance: The existing content of id is deleted first, and the Asset given as replacement_asset_id is consumed: its content moves into id and it ends up with status "deleted". Confirm with the user that the replacement Asset is meant to be consumed/discarded, especially if it was not created solely to feed this call. Both Assets must be in a compatible status or the call fails synchronously before any async work starts; poll Asset/AssetState on id afterward to track completion.

asset_content_replace

Permanently delete a secondary File (e.g. screenshot, subtitle) attached to a given Asset, including its underlying stored object. MCP guidance: This deletes the File from remote storage, not just its database record. It is irreversible. Confirm with the user before calling this.

asset_file_delete

Update the duration or locale of an existing secondary File (e.g. subtitle) attached to a given Asset. MCP guidance: Only duration and locale are actually applied by this mutation; type is accepted as an argument but silently ignored, and the File's type cannot be changed this way. Use AssetFileDelete plus a new upload if the File's type itself needs to change.

asset_file_update

Fetch a paginated, filterable/searchable list of Assets for a Project.

asset_list

Create a new Asset of type "live_video" and prepare its live event on the media provider. This step itself does not start the stream or incur live-streaming costs, but a later AssetLiveStart does; see the AudiencePlayer support portal at https://support.audienceplayer.com/portal/en/kb for details. MCP guidance: This only creates and prepares the live Asset; it does not start the live stream or incur costs by itself. Call AssetLiveStart with the returned id to actually start the channel. Warn the user that AssetLiveStart typically incurs real, immediate consumption/streaming costs for as long as the channel stays active, and confirm with the user before proceeding to it.

asset_live_create

Fetch a recording belonging to a live-video Asset: a specific one by id, or the Asset's current active recording if id is omitted. MCP guidance: A recording id belonging to a different Asset than asset_id returns not-found rather than fetching it; the recording is always scoped to the given Asset.

asset_live_recording

Permanently delete a completed or failed live Asset recording. MCP guidance: Only recordings in a completed or failed state can be deleted; a still-in-progress recording must be stopped first with AssetLiveRecordingStop, and a recording that is active, finished or still post-processing is rejected with a conflict until it reaches completed or failed (wait and retry). This permanently removes the recording from the media provider. Confirm with the user before calling this.

asset_live_recording_delete

Start a recording of the Asset's currently running live-video channel. MCP guidance: Only works while the Asset's live-video channel is already running (started via AssetLiveStart); it cannot pre-schedule a recording for a channel that has not started yet.

asset_live_recording_start

Stop the Asset's currently active recording of its live-video channel.

asset_live_recording_stop

Start the live-video channel for an existing live-video Asset (created via AssetLiveCreate), making it active and playable. The start is queued and completes asynchronously, so the Asset is not yet live when this returns: poll its status. Starting a live channel typically incurs real, immediate consumption/streaming costs for as long as it remains active; see the AudiencePlayer support portal at https://support.audienceplayer.com/portal/en/kb for details. MCP guidance: Explicitly warn the user before calling this: starting a live channel typically incurs real, immediate consumption/streaming costs billed by the media provider for as long as the channel stays active, separate from any premium live-event support fees. Confirm with the user before proceeding. Requires live-streaming to be enabled for the Project, and enforces concurrent-live-stream and session-duration limits: the call fails if a limit is exceeded. Roles above admin bypass both the live-streaming privilege check and these limits. Calling this again while a start is already in progress returns a conflict rather than restarting.

asset_live_start

Stop the live-video channel for a live-video Asset that is currently active. MCP guidance: Stopping does not delete the Asset or any recordings already made from it. If a recording is in progress, stop it separately with AssetLiveRecordingStop first if the user wants the recording preserved cleanly rather than cut off by the channel stopping.

asset_live_stop

Create a play-out configuration directly for an Asset, without any Article context. Only basic Asset-viewing access is required, not full Article authorization. On this Admin schema, playback is not gated by any particular User's actual purchase/entitlement status; that enforcement only happens on the User schema's equivalents. MCP guidance: Use ArticleAssetPlay instead when previewing playback in the context of a specific Article (e.g. to get Article-specific pivot data such as playback position or upsell products).

asset_play

Fetch an Asset's current media-provider processing/publication state (e.g. encoding progress, publish status), queried live from the configured media provider. Not available for mock-type Assets. MCP guidance: Despite being a query, this can update the Asset record as a side effect: a live Asset whose start or stop request is confirmed by the provider is moved to its new live status, and an empty source_blob_name, source_asset_id or encoded_asset_id is filled in from the provider state. Calls are throttled.

asset_state

Report the result of a direct provider upload for an Asset created by AssetUploadTokenFetch. A successful report allows server-side Asset post-processing to continue. MCP guidance: Use this after AssetUploadTokenFetch only. Pass upload_status true after the raw file upload completed successfully. For small resource files, use FileUploadTokenFetch instead.

asset_upload_status_report

Create a CMS-upload Asset and return the provider-specific upload contract for its large source media file. After the provider upload completes, report completion with AssetUploadStatusReport so server-side processing can continue. MCP guidance: Use this for large video or audio Asset uploads, not for small resource images or documents. Agents with local filesystem access and raw HTTP capability may upload directly using the returned provider upload contract. Large-file upload behavior is provider-specific; follow the returned token_type, token, credential_string, and related fields exactly. For human/browser fallback, direct the user to the AudiencePlayer CMS, which provides the supported large-file uploader. Use FileUploadTokenFetch instead for small files attached directly to resources such as Article images.

asset_upload_token_fetch

Query authentication status

authentication_status

Fetch a single Category.

category

Reposition an Article within a Category's articles list.

category_article_sort

Create a Category: a generic tag for categorising content in many different ways, for example simple content genre labels, assigning Subscription entitlement scoping, etc. Articles, Products, Subscriptions and Notifications can be attached to a Category, and a Category can be nested under a parent Category through parent_id. The Category is published unless a status is given, and its url slug defaults to a sanitised form of its name.

category_create

Delete a Category and its Files. Fails if the Category still has children, Articles, Products, Subscriptions, or Notifications attached.

category_delete

Reposition an Article within a Category's featured_articles list.

category_featured_article_sort

Delete a File attached to a Category. MCP guidance: This deletes the File, not just the relation. It is irreversible. Confirm with the user before calling this.

category_file_delete

Fetch a paginated list of Categories.

category_list

Delete a metadata property from a Category, by key. MCP guidance: This is irreversible. Confirm with the user before calling this.

category_meta_delete

Reposition a Category within the Category tree, relative to another node, and rebuild its url slug (and its descendants') afterward.

category_node_update

Reposition a Product within a Category's products list.

category_product_sort

Update an existing Category's name, type, parent, visibility, status, metadata, Files or url slugs; only the arguments that are passed are changed. Giving a new parent_id together with a url_slug rebuilds the Category's url slug, and a name that violates a uniqueness restriction is rejected with a conflict error.

category_update

List configurable OAuth clients for a Project. MCP guidance: Returns only configurable external OAuth client service types, even if other clients exist for the Project.

client_list

Query admin Project configuration MCP guidance: Admin Config assembles only requested sections. Request project when Project settings are needed; resource_map also hydrates Project settings because metadata maps depend on ProjectConfig.

config

Fetch a single File by id: a file such as an image or document that is attached to a resource like an Article, Category or Page. Pass locale to resolve its translated fields.

file

Update File metadata such as its display title, type, duration, and locale. This does not upload new bytes, replace the stored object, or reattach the File to another resource. MCP guidance: Title translations touch the File for search indexing, and a successful update flushes page cache.

file_update

Create a short-lived AudiencePlayer upload capability for attaching a small file to a resource. The response includes a direct multipart POST endpoint and a browser upload URL. MCP guidance: Use this for small resource files such as images or documents attached to an Article, Category, Page, MailTemplate, MenuComponent, Notification, MetricAction, or similar resource. Inspect compatibility_status before uploading: CMS_MANAGED means the file type is exposed by AudiencePlayer CMS/template apps for this concrete target; API_ONLY means the file can be attached through the API but may be hidden from CMS management and unused by standard template apps, so ask the user before uploading unless they explicitly want an API/custom-frontend attachment; UNKNOWN means compatibility could not be determined. If local filesystem access and raw HTTP capability are available, POST the local file as multipart form data to post_url using method and form_file_field exactly. Do not send file bytes or base64 through GraphQL or MCP. Browser fallback: if the file is only available through the chat GUI or the agent cannot perform raw HTTP upload, present upload_url to the user so their browser can upload the file directly.

file_upload_token_fetch

List GeoRegions available for publication and filtering.

geo_region_list

Returns diagnostic metadata for the MCP tool registry currently served by this API instance, including app_version_tag, source, generated_at, tool_count, and registry_hash. Use this to verify whether a connector is seeing the expected server-side tool registry version.

get_mcp_registry_info

Returns the project ID and name of the currently authenticated session. Call this first to identify which project you are working on.

get_my_project_id

Returns key project configuration: website URL, domain, internal URL, locale, active platform contexts, and feature flags. Call this to get context for generating locale-aware, platform-correct content.

get_project_config

List LanguageTags for a Project and platform context.

language_tag_list