MCP tools
MCP tools
The 74 tools the Koast MCP server exposes, with their input, scope and REST equivalent.
Generated from the tool catalog (version 1, surface mcp). To connect a client, see the MCP guide.
Activity
| Tool | Scope | Description |
|---|---|---|
| Get team activity log | read | Fetch the team activity log, who changed what and when, for an account or brand. |
Ad Accounts
| Tool | Scope | Description |
|---|---|---|
| Get account naming convention | read | Configured naming convention templates for an account (campaign/adset/ad). |
| Get account overview | read | Roll up spend and results across the Koast batches on an ad account, NOT the whole ad account: campaigns that were never launched through Koast are not counted, and at most 10 batches are sampled (the payload reports batchesSampled). |
| Get asset and targeting options | read | Look up available options for any asset or targeting type. |
| List ad account campaigns | read | Lists ALL campaigns in the brand's ad account on its ad platform, including those NOT imported to Koast. |
| List lead forms | read | List the instant lead forms that already exist on a Page, so you can attach one to a lead-generation ad set. |
Automations
| Tool | Scope | Description |
|---|---|---|
| Delete automation | write | Permanently delete a monitoring automation by automationId. |
| Get automation | read | Get one monitoring automation (rules + actions + frequency + scope) by automationId. |
| List automations | read | List monitoring automations (rule-based per-brand watchers that run actions like pause/notify on live campaigns). |
| Save automation | write | Create or update a monitoring automation for a brand. |
| Set automation status | write | Set a monitoring automation's status: ACTIVE or PAUSED. |
Brands
| Tool | Scope | Description |
|---|---|---|
| List my ad accounts | read | Real list of ad accounts the current user can access (one per brand). |
Copies
| Tool | Scope | Description |
|---|---|---|
| Generate ad copy | write | Generate ad copy (headlines, primary text, descriptions) and store it as a copyGenerationId. |
| Get generated ad copy | read | Get a previously generated copy by its ID. |
Creatives
| Tool | Scope | Description |
|---|---|---|
| List creatives | read | Browse the active brand's creative library, the images and videos available to put in ads. |
| Upload creative | write | Store an image in the active brand's creative library and return its creativeId, ready to put in an ad with addAds, distributeCreative or swapCreatives. |
Launches
| Tool | Scope | Description |
|---|---|---|
| Add ads | write | Create one or many ads under ad sets. |
| Add ad set | write | Add a new ad set to a campaign, and optionally apply targeting/budget/schedule/goal settings AT CREATE time via the settings map (dot-notation paths, same shape as updateSettings). |
| Add campaign | write | Add a new campaign node to the campaign tree. |
| Apply campaign snapshot template | write | Apply a saved CAMPAIGN-SNAPSHOT template to the current campaign launch. |
| Apply structure template | write | Apply a structure template to a pipeline card, POPULATES the card (an existing PENDING draft batch) with the template's campaign/ad set/ad structure. |
| Attach lead form | write | Attach a Meta instant lead form to a lead-generation ad set so the campaign can launch. |
| Clone live campaign | write | Clone a live campaign into one or more fresh Koast batches as editable DRAFTS, a full deep-copy of the campaign tree (ad sets, ads, copy, re-imported creatives) with all ad-platform IDs stripped, so each clone is a brand-new launchable draft. |
| Compute creative fatigue | read | Canonical deterministic creative fatigue score for a single ad (or aggregated set) on a campaign launch. |
| Create campaign launch | write | Create an empty campaign launch (batch) under a specific brand/ad account. |
| Delete batch or pipeline card | write | Permanently delete a Koast batch (campaign launch) or pipeline card, together with the campaigns, ad sets and ads it holds in the Koast tree. |
| Distribute creative | write | Distribute a single creative across multiple ad sets or campaigns. |
| Duplicate and vary | write | Duplicate a campaign/ad set/ad N times, varying ONE specific settings path across the copies. |
| Duplicate ad set or ad | write | Duplicate an ad set or ad, including all its settings and children. |
| Edit live campaign budget | publish | Change the budget of a campaign or ad set that is ALREADY LIVE on the ad platform. |
| Get ad delivery status | read | Check ad review and delivery status on the ad platform for the current campaign launch. |
| Get ad details | read | Full ad details: creative, copy, links, CTA, tracking. |
| Get ad set details | read | Full adset details: settings, targeting, budget, schedule, placements, optimization, assets, links. |
| Get campaign tree | read | Returns the Koast-tracked campaign STRUCTURE (campaign → adset → ad tree with IDs and names only) for a given campaign launch. |
| Get daily insights | read | Fetch daily-breakdown insights (time_increment=1) for the current campaign launch at campaign/adset/ad level. |
| Get metrics | read | Get performance metrics at campaign / adset / ad level for the current launch. |
| Get settings | read | Get current settings (budget, targeting, schedule, placements, optimization) for one or MANY nodes. |
| Get targeting options | read | Get available targeting options including audiences, locations, demographics, interests, and behaviors. |
| Import campaigns | write | Import existing campaigns from the ad platform into the current campaign launch. |
| Import live campaign | write | Import a live campaign (one that exists in the ad account on the ad platform but NOT yet in Koast) into a Koast batch, so it becomes both reportable AND extendable. |
| Launch campaign | publish | Publish the current campaign launch to the ad platform. |
| List Koast batches | read | List Koast batches (campaign launches), these are the user's drafts and in-progress launches stored in the Koast DB, separate from live campaigns on the ad platform. |
| Remove items from campaign tree | write | Remove one or many campaign/adset/ad nodes from the KOAST TREE only, this does NOT pause or delete the entity on the ad platform and does NOT stop spend on already-published ads. |
| Rename campaign, ad set or ad | write | Rename a campaign, ad set, or ad node. |
| Save campaign snapshot template | write | Save the current campaign's SETTINGS as a reusable CAMPAIGN-SNAPSHOT template. |
| Swap creatives | write | Replace the creatives on an existing ad set's ads while PRESERVING each ad's copy (primary text + headline). |
| Turn launch into structure template | write | Reverse a single specified launch (batch) into a saved structure template. |
| Update campaign, ad set or ad | write | Update properties on a campaign, ad set, or ad node. |
| Update settings | write | Apply one or more settings to one or more nodes in a single call. |
| Validate launch | read | Read-only check whether the campaign launch is publishable to the ad platform. |
Pipeline
| Tool | Scope | Description |
|---|---|---|
| Configure pipeline column | write | Configure a fixed system column's SETTINGS: rename it, hide/show it, and/or bind a structure template to auto-apply on card entry. |
| Create pipeline card | write | Create a new pipeline card (ticket/batch) on the board. |
| List pipeline columns | read | List the pipeline board columns (the 6 fixed system stages) for the org, with their ids, names, hidden flag, and bound settings. |
| Move pipeline card | write | Move a pipeline card (batch) between the columns you can set by hand: REQUESTED, ASSETS_UPLOADED, IN_REVIEW, APPROVED and FAILED. |
Snapshot Templates
| Tool | Scope | Description |
|---|---|---|
| Delete campaign snapshot template | write | Delete a saved CAMPAIGN-SNAPSHOT template. |
| List campaign snapshot templates | read | List the user's saved CAMPAIGN-SNAPSHOT templates (full campaign-tree snapshots of an existing launch). |
Structure Templates
| Tool | Scope | Description |
|---|---|---|
| Create structure template | write | Create a new structure template from an engine StructureState you constructed for the user. |
| Delete structure template | write | Permanently delete a saved STRUCTURE template by templateId. |
| Edit structure template rules | write | Update an existing structure template's rules/audiences/settings. |
| Get structure template | read | Get one structure template (config + settings + audiences + accounts) by templateId. |
| List structure templates | read | List the user's saved STRUCTURE templates (rule-based campaign blueprints applied to pipeline cards). |
Workflows
| Tool | Scope | Description |
|---|---|---|
| Delete workflow | write | Permanently delete a workflow by workflowId. |
| Get workflow | read | Get one workflow (spec + nodes + trigger + status) by workflowId. |
| Get workflow execution | read | Get the status and per-node results of a single workflow execution. |
| List workflows | read | List the org's saved Workflows (multi-step automations that chain nodes like apply_template, launch, attach_monitor, slack_notify, review_gate, agent_prompt). |
| Run workflow | write | Trigger a workflow to run now, starting a new execution. |
| Save workflow | write | Create or update a Workflow. |
| Set workflow status | write | Set a workflow's status: DRAFT, ACTIVE (armed), or PAUSED. |
MCP only
| Tool | Scope | Description |
|---|---|---|
| Create notification | write | Create a notification in the user's Home inbox, a sign-off request, a to-do, or a deferred-work item. |
| Get settings schema | read | Get the configurable settings for a given section and node type. |
| Get structure template rules | read | Return a human-readable summary of a structure template's engine rules (creative count, ad sets, placement/split, custom-rule flags, ops) and the distribution it will produce (sets x creatives). |
| Preview ads | read | Preview a campaign launch's ads as they appear in feed: primary text, headline, call to action and the creative image for every ad in the launch, in structure order. |
| Suggest structure templates | write | Suggest structure templates by reverse-engineering the user's last few launches and AI-naming them. |
| Validate structure rules | read | Validate an engine StructureState against the rules engine WITHOUT saving. |