> 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/overview.md).

# Overview

Let your AI assistant or your own code work in Ava Studio for you. Everything you do in the app is available as a tool:

* **Brands:** set up the brand Ava writes for, its products and its media.
* **Research:** what is working in short-form video right now, for your niche.
* **Your ads:** connect Meta and learn from your own ads.
* **Drafts:** briefs, shot lists and prompts grounded in research.
* **Campaigns:** run Ava's planner, review concepts, produce and export videos.
* **Studio:** generate images, video and audio with any Studio model, and edit projects.
* **Ask Ava:** talk to the campaign copilot.

Choose how to use the same hosted tools:

|                                 | Use it for                                                    | Address                                                                                              |
| ------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **MCP**                         | ChatGPT, Claude, Claude Code, Cursor and any other MCP client | `https://mcp.avastudio.com/mcp`                                                                      |
| **REST**                        | Your own code and scripts                                     | `https://mcp.avastudio.com/v1/<tool>`                                                                |
| **JavaScript / TypeScript SDK** | Typed calls, job polling and uploads from Node.js             | [`@hologramlabs/ava-sdk`](https://docs.avastudio.com/api-and-mcp/sdk.md)                             |
| **CLI**                         | Terminal commands, shell scripts and MCP setup                | [`avastudio`](https://docs.avastudio.com/api-and-mcp/cli.md), installed with `@hologramlabs/ava-cli` |

The SDK and CLI are available on npm and need Node.js 22.14 or newer. They call Ava's hosted API; you do not need to run a server yourself.

{% hint style="info" %}
The API works on every Ava Studio plan, Free included. Creating an API key or connecting through MCP does not require a paid Ava plan. Paid operations spend credits from your account's balance, the same credits you use in the app.

Eligible free accounts receive a one-time **500-credit starter grant after their first brand is ready**, valid for **14 days**. These credits work across Studio, MCP, REST, SDK and CLI; they are not restricted to one campaign. See [Starter credits and free-plan limits](https://docs.avastudio.com/api-and-mcp/credits-and-pricing.md#free-accounts-and-starter-credits).
{% endhint %}

#### Get started

* [REST quickstart](https://docs.avastudio.com/api-and-mcp/quickstart.md): make your first HTTP call in two minutes.
* [JavaScript and TypeScript SDK](https://docs.avastudio.com/api-and-mcp/sdk.md): install the package and call Ava from application code.
* [Ava Studio CLI](https://docs.avastudio.com/api-and-mcp/cli.md): install `avastudio` and use Ava from your terminal.
* [Clone and plan inside a project](https://docs.avastudio.com/api-and-mcp/project-agent.md): give Studio's content planner reference links, images and videos.
* [Connect your AI app](https://docs.avastudio.com/api-and-mcp/connect.md): ChatGPT, Claude, Claude Code and Cursor over MCP.
* [Tool reference](https://docs.avastudio.com/api-and-mcp/tools.md): every tool, what it costs and what it needs.

#### How it works

* **Sign-in.** ChatGPT and Claude connect with [Sign in with Ava](https://docs.avastudio.com/api-and-mcp/sign-in-with-ava.md): no key needed. Everything else uses an [API key](https://docs.avastudio.com/api-and-mcp/api-keys.md) you create in Ava Studio under **Settings > Developers**.
* **Permissions and budgets.** Each key or connected app has its own permissions and an optional monthly credit limit, and you can revoke it at any time.
* **Long tasks run as jobs.** Drafting, planning and producing media take from seconds to minutes. Those tools return a `job_id` right away; follow it with `jobs_get`. See [Jobs, retries and errors](https://docs.avastudio.com/api-and-mcp/jobs-retries-and-errors.md).
* **Your work shows up in the app.** Brands, drafts, campaigns, concepts and projects made through the API are the same ones you see in Ava Studio, so you can pick up where your agent left off.
