Adrio

Get one product by productId, including benefits, archetypes, and image assets.

get_product

List products for the selected brand with generation-relevant details and image assets.

list_products

Accept once, save the displayed allow scope for this user and brand, or decline Spark's pending internal tool approval and continue the run. Continuing Spark is metered and may consume user credits; only set confirm=true after explicit user approval.

resolve_spark_approval

Retry the most recent failed Spark turn. This is metered and may consume user credits; only set confirm=true after explicit user approval.

retry_spark_run

List ads saved to the selected brand's swipe file, optionally filtered by boards, media type, platform, or active status.

list_saved_ads

Find brand media library assets (images, videos, audio) by text and type, for example to reuse an already uploaded soundtrack instead of uploading it again. Returns up to 24 assets with ids usable as mediaAssetIds.

search_media_library

Get current Spark run state, recent messages, pending approval, generation progress, available controls, and the Adrio chat link. Poll this after starting or controlling a run. Phases: "working" (Spark is thinking), "input_required" (resolve the pending approval), "dispatching"/"generating" (approved creatives are rendering; generation.counts and generation.creatives show progress), "completed" (every creative settled), "ready" (Spark replied and waits for you). generation.creatives lists what the chat made (newest first) with status, url, and ids you can pass back as contextRefs of type "creative", for example to turn finished statics into videos.

get_spark_run

Step 1 of uploading a local image, video, or audio file (for example a soundtrack) to the brand media library. Returns a presigned uploadUrl: PUT the raw file bytes to it yourself with exactly the returned headers (see example), then call complete_media_upload with the uploadId. Upload each file once; identical bytes are deduplicated. Supported: png, jpg, webp, gif, avif, svg, mp4, mov, webm, mp3, wav, m4a, aac, ogg, flac. Caps: images 20MB, audio 50MB, video 150MB.

create_media_upload

Send another instruction or brief to a Spark run that is ready, completed, generating, or failed. When a PDF brief is attached, the message should contain only useful new direction not already present in the PDF; do not repeat or summarize it. If there is nothing to add, use a simple message such as "Generate ads from the brief." This starts a new metered Spark turn and may consume user credits; only set confirm=true after explicit user approval.

send_spark_message

List the selected brand's swipe-file boards with saved-ad counts and preview images.

list_swipe_file_boards

Create a reusable communication angle for the selected brand. A matching title returns the existing angle instead of creating a duplicate.

Create a reusable audience for the selected brand. A matching title returns the existing audience instead of creating a duplicate.

Create a named swipe-file board for the selected brand. Use this before save_ad_to_board when the user requests a board that does not exist.

Permanently delete one reusable communication angle. Set confirm=true only after the user explicitly confirms deletion.

Permanently delete one reusable audience. Set confirm=true only after the user explicitly confirms deletion.

Find competitor ads that genuinely match a described format/style/angle. A curation sub-agent runs several searches, uses a vision model to LOOK at each candidate ad image and score how well it matches your description, then returns only the strong visual matches (each with fitScore, strategyFit, formatFit, styleFit, and fitReason). This is a slow, multi-round tool by design. Image URLs are returned as plain link strings, not inlined images. Prefer this over search_ads for open-ended 'find ads like this / in this format' requests where visual fit matters.

Fetch the full analysis for a single competitor ad by adId: angle, audience, hook, copy, controlled tags, evidence, and all image URLs. Image URLs are returned as plain link strings, not inlined images. Use after search_ads or when the user references a specific ad.

Read analyzed ads for one company already in the selected brand's watchlist (angle research and funnel analysis). Only advertisers on the selected brand's watchlist are allowed. Image URLs are returned as plain link strings, not inlined images. Use list_watchlist_companies first to get an allowed advertiserId.

List active creative generation, editing, analysis, and Spark session jobs for the selected brand.

List or search companies in the selected brand's competitor watchlist. Use this before company-specific competitor research so you can pass an advertiserId to get_watchlisted_company_ads.

Remove a saved ad from every swipe-file board. Set confirm=true only after the user explicitly confirms removal.

Save a competitor ad to one swipe-file board by adArchiveId. Omit boardId to use the default board, or call create_swipe_file_board first when the user requests a new named board. This operation is idempotent.

Select which organisation and brand subsequent MCP requests operate on. Use list_organisations to find both slugs. brandSlug is required when the organisation has multiple brands and optional when it has exactly one.

Update one reusable communication angle. Only supplied fields are changed.

Update one reusable audience. Only supplied fields are changed.