For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tool reference

Every tool works the same over MCP and REST. Over MCP your app calls it by name; over REST, send its input as JSON to POST https://mcp.avastudio.com/v1/<tool> with your key. GET /v1/tools lists the tools your key can call, with their full input schemas.

Each tool needs one permission (see API keys and permissions) and lists its price (see Credits and pricing).

Account

Check the key and follow long-running jobs.

Tool
What it does
Permission
Price

whoami

Check the key and see your credits and brands.

Account

Free

jobs_get

Check on a long-running job and get its result.

Any key

Free

Brands

Set up and edit the brand Ava writes for, and its media.

Tool
What it does
Permission
Price

brand_list

See your brands.

Read brands

Free

brand_get

Read a brand’s voice, audience, and products.

Read brands

Free

brand_export

Export a brand as Markdown or JSON.

Read brands

Free

brand_create

Save supplied brand details or research a website.

Edit brands

Free for a supplied profile; 40 credits for website research

brand_update

Change brand details.

Edit brands

Free

brand_media_upload_url

Get a link to upload a photo or video file for a brand.

Edit brands

Free

brand_media_add

Import photos or clips into a brand and analyze them for Ava.

Edit brands

2 credits per item

brand_media_update

Relabel a brand media item or say when to use it.

Edit brands

Free

brand_media_remove

Remove media from a brand. The files themselves are kept.

Edit brands

Free

brand_set_primary

Make a brand your default.

Edit brands

Free

brand_delete

Delete a brand. Another brand becomes your default.

Edit brands

Free

Research

Learn what is working in short-form video right now.

Tool
What it does
Permission
Price

research_trends

What is rising in your niche lately.

Research

1 credit

research_formats

Video formats that work in your niche.

Research

1 credit

research_hooks

Opening lines that keep people watching.

Research

1 credit

research_search

Find videos by topic, views, region, or date.

Research

1 credit

research_breakouts

Videos doing far better than their creator’s usual.

Research

1 credit

research_similar

Find videos with a similar hook or style.

Research

2 credits

Your ads

Connect Meta and learn from your own ads.

Tool
What it does
Permission
Price

meta_status

Check whether a brand’s Meta ad account is connected.

Read ad results

Free

meta_connect

Get the Studio link to connect a Meta ad account.

Connect and sync ads

Free

meta_sync

Pull the latest ads and results from Meta.

Connect and sync ads

10 credits

research_my_ads

Your Meta ad results, scored, with why each one worked.

Read ad results

Free

Drafts

Turn research into briefs you can approve in Studio.

Tool
What it does
Permission
Price

draft_briefs

Write 1 to 5 video, carousel, or static ad briefs.

Write drafts

10 credits per brief + tokens

draft_clone

Turn one short-form video into an on-brand brief.

Write drafts

10 credits per brief + tokens

draft_iterate

Rework a brief from your feedback.

Write drafts

8 credits + tokens

draft_check

Score a brief and flag what could go wrong.

Write drafts

3 credits + tokens

draft_list

List your briefs.

Read drafts

Free

draft_get

Read one brief in full.

Read drafts

Free

draft_spec

Get the shot list for a brief.

Read drafts

Free

draft_prompts

Get prompts for Seedance, Veo, Kling, Sora, and more.

Read drafts

Free

draft_open

Get a Studio link to review and approve a brief.

Read drafts

Free

Campaigns

Start Ava Studio campaigns and change their settings.

Tool
What it does
Permission
Price

campaign_list

List your campaigns, optionally for one brand.

Read campaigns

Free

campaign_get

Read a campaign’s brief, settings, and latest plan run.

Read campaigns

Free

campaign_create

Start an organic or paid campaign for a brand, with automation off.

Manage campaigns

Free

campaign_update

Edit details or schedule, or pause automation. Turn it on in Studio.

Manage campaigns

Free

campaign_evidence

Read saved sources, linked concepts and reference-post public counters.

Read campaigns

Free

Planner

Let Ava research and draft concepts for a campaign.

Tool
What it does
Permission
Price

plan_run

Draft concepts to review, no media. Charged only when it starts a run.

Manage campaigns

200 credits

plan_get

Follow a plan run: status, steps, concepts, and Ava’s strategy.

Read campaigns

Free

plan_list

Browse saved runs by Studio week, with cursors for older history.

Read campaigns

Free

Concepts

Review Ava’s ideas before anything is made.

Tool
What it does
Permission
Price

concept_list

See the concepts Ava drafted, by plan run or status.

Read campaigns

Free

concept_approve

Approve up to 20 concepts. Nothing is produced yet.

Manage campaigns

Free

concept_reject

Reject a concept, with a reason Ava learns from.

Manage campaigns

Free

concepts_draft_more

Draft 1 to 5 more concepts from the current plan’s research.

Manage campaigns

10 credits per concept

concept_draft_get

Read the editable draft and submitted version history.

Read campaigns

Free

concept_draft_update

Start editing, save copy or direction, and submit a new version without generating media.

Manage campaigns

Free

Production

Make the media in Studio, then edit and export it.

Tool
What it does
Permission
Price

creative_produce

Make a concept’s video, carousel, or image with Studio’s pipeline.

Produce media

50 credits + media

creative_get

Read a creative’s status, files, and post caption.

Read campaigns

Free

creative_list

List a campaign’s approved and produced creatives.

Read campaigns

Free

project_list

List your Studio projects, optionally for one campaign.

Read campaigns

Free

project_get

Read a project’s scenes, captions, and latest export.

Read campaigns

Free

project_history

Read saved project chat history with pagination.

Read campaigns

Free

project_edit

Make one plain-language edit, like retiming scenes or moving a caption.

Produce media

10 credits + tokens

export_render

Render a project to an MP4 or images with an explicit watermark option.

Produce media

10 credits

broll_create

Make a 5s vertical B-roll clip from brand photos; it joins the brand.

Produce media

Studio price

Studio

Generate images, video, and audio with any Studio model, and edit projects.

Tool
What it does
Permission
Price

project_ask

Use the project content planner to clone references, attach media, and optionally generate.

Produce media

10 + AI tokens + Studio media

models_list

List Studio’s models, their options, and their prices.

Any key

Free

generation_estimate

Price up to 20 generations before running them.

Any key

Free

image_generate

Make 1 to 4 images from a prompt and reference images.

Produce media

Studio price

video_generate

Make a video clip from a prompt, frames, or references.

Produce media

Studio price

audio_generate

Make a voiceover, music, or a sound effect.

Produce media

Studio price

voices_list

List Studio’s voices, or search the community library.

Read campaigns

Free

video_upscale

Upscale a video. The result goes to your library.

Produce media

Studio price

video_remove_background

Remove a video’s background. The result goes to your library.

Produce media

Studio price

image_reframe

Extend an image to a new aspect ratio.

Produce media

Studio price

image_layerize

Split an image into separate layers.

Produce media

Studio price

project_create

Start a blank Studio project in 9:16, 16:9, 1:1, or 4:5.

Produce media

Free

template_list

Browse Studio templates, optionally by use case.

Read campaigns

Free

template_get

Read a template’s variables, scenes, fixed parts, and price.

Read campaigns

Free

project_from_template

Make a project from a template; only what your variables touch changes.

Produce media

Studio price

scene_generate

Generate 1 to 4 variants for a scene; an empty scene gets the first.

Produce media

Studio price

scene_select_variant

Choose which generated variant a scene uses.

Produce media

Free

timeline_add

Add clips, images, audio, or text; clips stay silent unless you ask.

Produce media

Free

timeline_update

Move, retime, trim, mute, reposition, or restyle up to 20 elements.

Produce media

Free

timeline_remove

Remove elements from a project’s timeline.

Produce media

Free

captions_generate

Add timed captions to a project from its voiceover.

Produce media

Studio price

library_list

List the images, videos, and audio in your Studio library.

Read campaigns

Free

library_add

Import up to 10 files into your Studio library by URL.

Produce media

Free

library_upload_url

Get a link to upload a file to your Studio library.

Produce media

Free

slides_update

Edit saved carousel text, styles, positions or slide order without regenerating images.

Produce media

Free

Ask Ava

Talk to Studio’s campaign copilot. Each message uses credits; she starts nothing else that spends them.

Tool
What it does
Permission
Price

ava_ask

Message Ava about a campaign; she can approve concepts and edit drafts.

Ask Ava

40 credits per message + tokens