> For the complete documentation index, see [llms.txt](https://docs.avastudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avastudio.com/api-and-mcp/tools.md).

# 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](https://docs.avastudio.com/api-and-mcp/api-keys.md)) and lists its price (see [Credits and pricing](https://docs.avastudio.com/api-and-mcp/credits-and-pricing.md)).

### [Account](https://docs.avastudio.com/api-and-mcp/tools/account.md)

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](https://docs.avastudio.com/api-and-mcp/tools/brands.md)

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](https://docs.avastudio.com/api-and-mcp/tools/research.md)

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](https://docs.avastudio.com/api-and-mcp/tools/your-ads.md)

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](https://docs.avastudio.com/api-and-mcp/tools/drafts.md)

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](https://docs.avastudio.com/api-and-mcp/tools/campaigns.md)

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](https://docs.avastudio.com/api-and-mcp/tools/planner.md)

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](https://docs.avastudio.com/api-and-mcp/tools/concepts.md)

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](https://docs.avastudio.com/api-and-mcp/tools/production.md)

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](https://docs.avastudio.com/api-and-mcp/tools/studio.md)

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](https://docs.avastudio.com/api-and-mcp/tools/ask-ava.md)

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 |
