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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
ava_ask
Message Ava about a campaign; she can approve concepts and edit drafts.
Ask Ava
40 credits per message + tokens