Connect Koast to your AI assistant
Connect Claude, ChatGPT or any MCP client to Koast, sign in, and pick what it's allowed to do.
Koast runs an MCP server. Connect it to Claude, ChatGPT or any assistant that speaks MCP, and that assistant can read your campaign numbers, build a launch with you and publish it, using the same operations the Koast app uses.
Model Context Protocol is an open standard for connecting an assistant to a real system. You connect Koast once, sign in as yourself, and choose what the assistant is allowed to do. There's no key to paste for most clients and nothing to self host.
The server address is:
https://mcp.koast.ai/mcpThat's the only value you need for a client that supports remote MCP servers and OAuth. Everything else is discovered.
MCP works on every paid Koast plan with an active subscription.
One click install
Add to Claude
Koast is listed in Claude's connector directory. Open the listing, add it from there, then sign in.
Add to ChatGPT
Turn on Developer mode first (Settings, then Security and login). Then select the plus button and paste the server address under Connection.
Add to Cursor
Cursor asks you to confirm, then adds Koast to its MCP servers.
Add to VS Code
VS Code opens its MCP install prompt with Koast filled in.
Terminal agents take one command. Each one asks you to sign in to Koast the first time it connects. In Claude Code, run /mcp to start the sign in.
# Claude Code
claude mcp add --transport http koast https://mcp.koast.ai/mcp
# Codex
codex mcp add koast --url https://mcp.koast.ai/mcp
codex mcp login koast
# Gemini CLI
gemini mcp add --transport http koast https://mcp.koast.ai/mcpAdd it to your assistant
Open your assistant's connector settings
In Claude, find Koast in the connector directory and add it from the listing. There is nothing to paste. In ChatGPT, add a connector in settings. Other clients call it an MCP server or a remote server, and take the address below.
Paste the server address
Use
https://mcp.koast.ai/mcp. Don't add a key. The client registers itself with Koast automatically.Sign in to Koast
Your browser opens a Koast sign in screen. Sign in with the account you already use.
Choose what it can do
The approval screen lists What it will be able to do. Grant the least the client needs. Publish is Off unless you turn it on and marked Spends money.
Set a publish limit, if you granted Publish
Publish limit is the most this client may ever put live, in total. Publishing is refused without one.
Pick a brand
Back in the assistant, ask it to list your brands and choose one. Nothing brand specific runs until a brand is active.
A good first question: "Which ad sets are over target CPA this week?"
If your client can't do OAuth
Some clients only accept a static token. For those, an organization owner or admin creates an API key with MCP turned on, and you paste it as a bearer token. See Create and manage API keys.
Check or remove a connection
Every app you've connected by signing in appears in Koast under API & Webhooks, in the Authorized apps list, with its Access, when it was Authorized and when it was Last used. Revoking one takes effect on its next request.
The command line and the REST API
The koast command line and the Koast REST API are for your own code and scripts, not for assistants. They need an Agency plan, and they use an API key with API turned on, or a browser sign in for the command line.
npm install -g @koast.ai/cli
koast login
koast commandsEvery command, every endpoint and every error code is on the Koast developer docs.
What it can do
More than seventy tools, generated from the same declarations the Koast app runs on. The MCP tool reference lists every one. By job:
| Area | What your assistant can do |
|---|---|
| Reporting | Spend, results, cost per result and delivery status at campaign, ad set or ad level. Account wide rollups, per day series for trends, creative fatigue scores, review and disapproval status, and the team activity log. |
| Building a launch | Create a batch, add the campaign, add ad sets, add up to 100 ads in one call. Rename, remove, duplicate, or duplicate while varying one setting. Spread one creative across many ad sets. Pull existing campaigns in from the ad platform. |
| Settings | Read the valid settings for a section, read current values across many nodes at once, and write them. Budget, targeting, schedule, placements, optimization, links, assets, conversion, enhancements, naming and ad category. |
| Copy and creative | Generate ad copy, read existing copy, swap creatives, and attach or list lead forms. |
| Structure templates | Rule based blueprints. List them, read their rules, author a new one, edit or validate rules, get suggestions, or turn an existing launch into a template. |
| Campaign snapshots | Capture a campaign tree and apply it somewhere else. A different thing from structure templates. |
| Pipeline board | List columns, create a card, move a card between columns, and configure what a column does. |
| Automations | The rules that watch your account and act on their own. List, read, save, pause, resume or delete them. |
| Workflows | List, read, save, run, pause or delete a workflow, and read the result of a past execution. |
| Live campaigns | Budgets, schedules, statuses and targeting on campaigns already running, through the same validation the app uses. |
| Publishing | Validate a launch, then publish it. Fenced behind the Publish access and a publish limit you set, or Unlimited on an API key. |
| Notifications | Put a sign off request or a to do in your Koast inbox. |
It works on Meta brands and on Koast ad accounts. Each brand offers only what its ad provider supports.
What it can't do
The list of tools your assistant sees is filtered every time, by four things: the access you granted, your role on the team, your plan, and what the active brand's ad provider supports. A read only connection sees 33 tools. A connection with Read, Write and Publish on a Meta brand sees 71.
A missing tool is an answer, not an obstacle
If a tool isn't on the list, the server refuses the call and says which access would have carried it. It doesn't find a different tool with the same side effect.
One brand per conversation
A conversation works on one brand at a time. Your assistant lists the brands you can reach, you pick one, and everything after that is scoped to it. Switching brands mid conversation changes which tools are available, because providers differ.