ADS Beast is an MCP server published by io.github.notformal, hosted at adsbeast.pro. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 206 tools, including whoami, get_new_leads, get_lead, list_lead_forms, lead_pipeline_stats.
Ad account audits, analytics, leads and campaign changes that run only from an approved preview.
4 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The API key in use: name, organization, scopes, and whether it can propose changes. A 403 from any tool means a missing scope listed here.
No parameters.
{
"name": "whoami",
"description": "The API key in use: name, organization, scopes, and whether it can propose changes. A 403 from any tool means a missing scope listed here.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "Describe the current API key",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Leads with contacts, form answers and attribution (UTM, click ids, form, campaign). updated_since (ISO-8601) gives only new or changed ones; page with next_offset while has_more.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size. Clamped into 1..5000 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset. |
| since | string | ISO-8601 timestamp. Returns leads created at or after it, ignoring later edits to older leads. |
| stage | string | Restrict to one pipeline stage. One of: new, contacted, qualified, proposal_sent, negotiation, won, lost. |
| offset | integer | Pagination offset. Use next_offset from the previous page. |
| source | string | Where the lead came from, for example 'meta_lead_form' for Meta instant forms or 'public_form' for a website form. |
| client_id | integer | Restrict to one client. A client of another organization answers 404. |
| updated_since | string | ISO-8601 timestamp, for example 2026-06-13T18:00:00Z. Returns leads updated at or after it, which is the last-sync value for incremental pulls. |
{
"name": "get_new_leads",
"description": "Leads with contacts, form answers and attribution (UTM, click ids, form, campaign). updated_since (ISO-8601) gives only new or changed ones; page with next_offset while has_more.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 5000,
"minimum": 1,
"description": "Page size. Clamped into 1..5000 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset."
},
"since": {
"type": "string",
"description": "ISO-8601 timestamp. Returns leads created at or after it, ignoring later edits to older leads."
},
"stage": {
"enum": [
"new",
"contacted",
"qualified",
"proposal_sent",
"negotiation",
"won",
"lost"
],
"type": "string",
"description": "Restrict to one pipeline stage. One of: new, contacted, qualified, proposal_sent, negotiation, won, lost."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Pagination offset. Use next_offset from the previous page."
},
"source": {
"type": "string",
"description": "Where the lead came from, for example 'meta_lead_form' for Meta instant forms or 'public_form' for a website form."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client. A client of another organization answers 404."
},
"updated_since": {
"type": "string",
"description": "ISO-8601 timestamp, for example 2026-06-13T18:00:00Z. Returns leads updated at or after it, which is the last-sync value for incremental pulls."
}
}
},
"annotations": {
"title": "Pull leads, including newly created ones",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return a single lead by its ADS Beast id with every field the record holds, including email, phone, qualification answers, attribution and its current pipeline stage.
| Parameter | Type | Description |
|---|---|---|
| lead_id * | integer | ADS Beast id of the lead, as returned by get_new_leads. |
{
"name": "get_lead",
"description": "Return a single lead by its ADS Beast id with every field the record holds, including email, phone, qualification answers, attribution and its current pipeline stage.",
"inputSchema": {
"type": "object",
"required": [
"lead_id"
],
"properties": {
"lead_id": {
"type": "integer",
"description": "ADS Beast id of the lead, as returned by get_new_leads."
}
}
},
"annotations": {
"title": "Get one lead",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the lead forms recorded for this organization, which maps the form ids and source keys that appear on a lead to readable form names.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Forms per page, newest first. Each form carries its questions, so keep pages small. |
| offset | integer | Forms to skip; use next_offset from the previous page. |
| platform | string | Restrict to one platform, for example meta. |
| client_id | integer | Restrict to one client. |
{
"name": "list_lead_forms",
"description": "Return the lead forms recorded for this organization, which maps the form ids and source keys that appear on a lead to readable form names.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 500,
"minimum": 1,
"description": "Forms per page, newest first. Each form carries its questions, so keep pages small."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Forms to skip; use next_offset from the previous page."
},
"platform": {
"type": "string",
"description": "Restrict to one platform, for example meta."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
}
}
},
"annotations": {
"title": "List known lead forms",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return aggregate lead counts by pipeline stage over a recent window, for the whole organization or for one client.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Length of the window in days, counted back from now. At most one year. |
| client_id | integer | Restrict to one client. |
{
"name": "lead_pipeline_stats",
"description": "Return aggregate lead counts by pipeline stage over a recent window, for the whole organization or for one client.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"days": {
"type": "integer",
"default": 30,
"maximum": 365,
"minimum": 1,
"description": "Length of the window in days, counted back from now. At most one year."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
}
}
},
"annotations": {
"title": "Summarise the lead pipeline",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the field names and outcome values that push_lead_outcomes accepts, as the server currently defines them.
No parameters.
{
"name": "lead_outcome_contract",
"description": "Return the field names and outcome values that push_lead_outcomes accepts, as the server currently defines them.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "Get the accepted outcome fields",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Change fields of one lead (notes, assignee, contacts, stage). Only supplied keys are written; an unwritable key is refused with the list of writable ones.
| Parameter | Type | Description |
|---|---|---|
| fields * | object | Object of field name to new value, for example {"stage": "qualified", "notes": "Called back"}. Fields not listed keep their current value. Writable fields: assigned_to, company_name, contact_email, contact_name, contact_phone, estimated_monthly_budget, estimated_monthly_fee, expected_close_date, las… |
| lead_id * | integer | ADS Beast id of the lead to change. |
{
"name": "update_lead",
"description": "Change fields of one lead (notes, assignee, contacts, stage). Only supplied keys are written; an unwritable key is refused with the list of writable ones.",
"inputSchema": {
"type": "object",
"required": [
"lead_id",
"fields"
],
"properties": {
"fields": {
"type": "object",
"description": "Object of field name to new value, for example {\"stage\": \"qualified\", \"notes\": \"Called back\"}. Fields not listed keep their current value. Writable fields: assigned_to, company_name, contact_email, contact_name, contact_phone, estimated_monthly_budget, estimated_monthly_fee, expected_close_date, last_contact_at, lost_reason, notes, probability_pct, proposal_id, source, stage, tags, website.",
"additionalProperties": true
},
"lead_id": {
"type": "integer",
"description": "ADS Beast id of the lead to change."
}
}
},
"annotations": {
"title": "Update a lead",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Move one lead to a different pipeline stage. Unlike setting the stage through update_lead, this also remaps the lead's close probability to the value configured for the new stage.
| Parameter | Type | Description |
|---|---|---|
| stage * | string | Stage to move the lead into. |
| lead_id * | integer | ADS Beast id of the lead to move. |
{
"name": "move_lead_stage",
"description": "Move one lead to a different pipeline stage. Unlike setting the stage through update_lead, this also remaps the lead's close probability to the value configured for the new stage.",
"inputSchema": {
"type": "object",
"required": [
"lead_id",
"stage"
],
"properties": {
"stage": {
"enum": [
"new",
"contacted",
"qualified",
"proposal_sent",
"negotiation",
"won",
"lost"
],
"type": "string",
"description": "Stage to move the lead into."
},
"lead_id": {
"type": "integer",
"description": "ADS Beast id of the lead to move."
}
}
},
"annotations": {
"title": "Move a lead to another stage",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Write lead outcomes back so ad platforms learn which leads sold. A row names a lead (lead_id, email or phone) and its outcome. dry_run (default true) writes nothing; run it first. Unmatched rows are skipped unless create_missing; the stage follows unless update_stage is false.
| Parameter | Type | Description |
|---|---|---|
| rows * | array | Outcome rows, for example [{"lead_id": 812, "outcome": "won", "reason": "signed"}]. For outcome paid add value (amount), currency (ISO 4217) and plan, e.g. {"external_lead_id": "u-1", "outcome": "paid", "value": 690, "currency": "UAH", "plan": "Pro"}. Accepted field names and outcome values come fro… |
| dry_run | boolean | True reports what would change and writes nothing. False applies the rows. |
| client_id | integer | Client the rows belong to. Optional with a key bound to one client - that client is used. |
| update_stage | boolean | Move a matched lead's pipeline stage to match the outcome, for example to won or lost. |
| source_system | string | Name of the system the outcomes came from, recorded on each row. |
| create_missing | boolean | Create a new lead for a row that matches none. Off by default: a typo in an email must not insert a record. |
Return campaigns from every connected advertising platform in one list, with their status, budget and platform ids. Archived campaigns are left out unless include_archived is true.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size. Clamped into 1..2000 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset. |
| offset | integer | Pagination offset. The reply carries total. |
| platform | string | Restrict to one platform. Omit for all platforms. |
| client_id | integer | Restrict to one client. |
| include_archived | boolean | True also returns archived campaigns. |
{
"name": "list_campaigns",
"description": "Return campaigns from every connected advertising platform in one list, with their status, budget and platform ids. Archived campaigns are left out unless include_archived is true.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 2000,
"minimum": 1,
"description": "Page size. Clamped into 1..2000 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Pagination offset. The reply carries total."
},
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin",
"microsoft",
"apple",
"chatgpt",
"telegram",
"reddit"
],
"type": "string",
"description": "Restrict to one platform. Omit for all platforms."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
},
"include_archived": {
"type": "boolean",
"default": false,
"description": "True also returns archived campaigns."
}
}
},
"annotations": {
"title": "List campaigns",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return a single campaign by its ADS Beast id with its settings, budget, status and the native id it has on its platform.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | integer | ADS Beast id of the campaign, as returned by list_campaigns. |
{
"name": "get_campaign",
"description": "Return a single campaign by its ADS Beast id with its settings, budget, status and the native id it has on its platform.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "integer",
"description": "ADS Beast id of the campaign, as returned by list_campaigns."
}
}
},
"annotations": {
"title": "Get one campaign",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return spend, conversions and delivery health aggregated across the whole organization. The endpoint takes no filter and always covers every client; per-client figures come from list_campaigns with a client_id.
No parameters.
{
"name": "campaign_dashboard_summary",
"description": "Return spend, conversions and delivery health aggregated across the whole organization. The endpoint takes no filter and always covers every client; per-client figures come from list_campaigns with a client_id.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "Summarise spend and delivery",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the clients of this organization with their budgets, status and connected advertising accounts. A long list comes back as a page {result, total, has_more, next_offset}.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Clients per page. |
| offset | integer | Clients to skip; use next_offset from the previous page. |
{
"name": "list_clients",
"description": "Return the clients of this organization with their budgets, status and connected advertising accounts. A long list comes back as a page {result, total, has_more, next_offset}.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Clients per page."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Clients to skip; use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return a single client by its ADS Beast id: profile, budget, goals and connected advertising accounts.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | ADS Beast id of the client, as returned by list_clients. |
{
"name": "get_client",
"description": "Return a single client by its ADS Beast id: profile, budget, goals and connected advertising accounts.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer",
"description": "ADS Beast id of the client, as returned by list_clients."
}
}
},
"annotations": {
"title": "Get one client",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the client reports already generated in ADS Beast, newest first, with their type, period and client.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Reports per page, newest first. Each report carries its sections, so keep pages small. |
| offset | integer | Reports to skip; use next_offset from the previous page. |
| client_id | integer | Restrict to one client. |
| report_type | string | Restrict to one kind of report, for example monthly or audit. |
{
"name": "list_reports",
"description": "Return the client reports already generated in ADS Beast, newest first, with their type, period and client.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Reports per page, newest first. Each report carries its sections, so keep pages small."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Reports to skip; use next_offset from the previous page."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
},
"report_type": {
"type": "string",
"description": "Restrict to one kind of report, for example monthly or audit."
}
}
},
"annotations": {
"title": "List generated reports",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the performance and delivery alerts raised by the ADS Beast monitoring agents, with their severity, the client or campaign they concern and whether they have been read or resolved.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size, newest first. Clamped into 1..5000 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset. |
| offset | integer | Alerts to skip; use next_offset from the previous page. |
| is_read | boolean | False returns only alerts nobody has read yet. |
| severity | string | Restrict to one severity. |
| client_id | integer | Restrict to one client. |
| alert_type | string | Restrict to one kind of alert. |
| campaign_id | integer | Restrict to one campaign. |
| is_resolved | boolean | False returns only alerts that are still open. |
{
"name": "list_alerts",
"description": "Return the performance and delivery alerts raised by the ADS Beast monitoring agents, with their severity, the client or campaign they concern and whether they have been read or resolved.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 30,
"maximum": 5000,
"minimum": 1,
"description": "Page size, newest first. Clamped into 1..5000 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Alerts to skip; use next_offset from the previous page."
},
"is_read": {
"type": "boolean",
"description": "False returns only alerts nobody has read yet."
},
"severity": {
"enum": [
"critical",
"warning",
"info"
],
"type": "string",
"description": "Restrict to one severity."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
},
"alert_type": {
"type": "string",
"description": "Restrict to one kind of alert."
},
"campaign_id": {
"type": "integer",
"description": "Restrict to one campaign."
},
"is_resolved": {
"type": "boolean",
"description": "False returns only alerts that are still open."
}
}
},
"annotations": {
"title": "List monitoring alerts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}How many live alerts are unread, as one number; an alert whose condition cleared is not counted. Cheaper than list_alerts for the count.
No parameters.
{
"name": "alerts_unread_count",
"description": "How many live alerts are unread, as one number; an alert whose condition cleared is not counted. Cheaper than list_alerts for the count.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "Count unread alerts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the team tasks recorded in ADS Beast with their status, priority, assignee and the client they belong to.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Page size. Clamped into 1..500 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset. |
| offset | integer | Pagination offset. The reply carries total. |
| status | string | Restrict to one status. |
| priority | string | Restrict to one priority. |
| client_id | integer | Restrict to one client. |
| assigned_to | string | Username of the assignee. |
{
"name": "list_tasks",
"description": "Return the team tasks recorded in ADS Beast with their status, priority, assignee and the client they belong to.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 500,
"minimum": 1,
"description": "Page size. Clamped into 1..500 before the request. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Pagination offset. The reply carries total."
},
"status": {
"enum": [
"todo",
"in_progress",
"blocked",
"done"
],
"type": "string",
"description": "Restrict to one status."
},
"priority": {
"enum": [
"low",
"medium",
"high",
"urgent"
],
"type": "string",
"description": "Restrict to one priority."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
},
"assigned_to": {
"type": "string",
"description": "Username of the assignee."
}
}
},
"annotations": {
"title": "List team tasks",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Page of email outreach campaigns, newest first: status, sender, offer pack, legal basis, daily limit. Walk pages with offset = next_offset. The letter is body_preview and body_chars; include_body = true gives the full text.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Campaigns per page. Clamped into 1..50. |
| offset | integer | Campaigns to skip; use next_offset from the previous page. |
| client_id | integer | Restrict to one client. |
| include_body | boolean | True returns each campaign's full letter (body_template); the page is then cut to fit the response size limit. |
{
"name": "list_outreach_campaigns",
"description": "Page of email outreach campaigns, newest first: status, sender, offer pack, legal basis, daily limit. Walk pages with offset = next_offset. The letter is body_preview and body_chars; include_body = true gives the full text.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Campaigns per page. Clamped into 1..50."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Campaigns to skip; use next_offset from the previous page."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
},
"include_body": {
"type": "boolean",
"default": false,
"description": "True returns each campaign's full letter (body_template); the page is then cut to fit the response size limit."
}
}
},
"annotations": {
"title": "List email outreach campaigns",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Run the pre-launch check of one email outreach campaign: who may be emailed under its legal basis, why the others are blocked (consent, personal mailbox, country, unsubscribed), and sender problems. Blocker issues stop the campaign from being activated.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | integer | Email campaign id. |
{
"name": "outreach_campaign_check",
"description": "Run the pre-launch check of one email outreach campaign: who may be emailed under its legal basis, why the others are blocked (consent, personal mailbox, country, unsubscribed), and sender problems. Blocker issues stop the campaign from being activated.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "integer",
"description": "Email campaign id."
}
}
},
"annotations": {
"title": "Check an email campaign before launch",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the offer packs outreach copy is built from: built-in samples and this organization's own client packs, with brand, languages, niches, the facts the copy relies on and how many errors or warnings the last check found.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Packs per page. |
| offset | integer | Packs to skip; use next_offset from the previous page. |
{
"name": "list_offer_packs",
"description": "Return the offer packs outreach copy is built from: built-in samples and this organization's own client packs, with brand, languages, niches, the facts the copy relies on and how many errors or warnings the last check found.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Packs per page."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Packs to skip; use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List offer packs",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the Instagram/TikTok/Facebook prospecting campaigns: offer, platforms, cities with message language, daily manual-send cap.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Campaigns per page. |
| offset | integer | Campaigns to skip; use next_offset from the previous page. |
| client_id | integer | Restrict to one client. |
{
"name": "list_social_campaigns",
"description": "Return the Instagram/TikTok/Facebook prospecting campaigns: offer, platforms, cities with message language, daily manual-send cap.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Campaigns per page."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Campaigns to skip; use next_offset from the previous page."
},
"client_id": {
"type": "integer",
"description": "Restrict to one client."
}
}
},
"annotations": {
"title": "List social prospecting campaigns",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Next profiles to message by hand, best first, within today's cap: link, signals, the drafted first message (no link) and the follow-up with a tracked link. Sends nothing.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | How many profiles. Clamped into 1..100. |
| platform | string | Only this platform. |
| campaign_id * | integer | Social campaign id. |
{
"name": "get_social_queue",
"description": "Next profiles to message by hand, best first, within today's cap: link, signals, the drafted first message (no link) and the follow-up with a tracked link. Sends nothing.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 30,
"maximum": 100,
"minimum": 1,
"description": "How many profiles. Clamped into 1..100."
},
"platform": {
"enum": [
"instagram",
"tiktok",
"facebook"
],
"type": "string",
"description": "Only this platform."
},
"campaign_id": {
"type": "integer",
"description": "Social campaign id."
}
}
},
"annotations": {
"title": "Get the social outreach queue",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Record what happened after a hand-sent message (sent, replied, registered, declined, do_not_contact, skipped, new to undo). 'sent' is refused past today's cap. Messages no one.
| Parameter | Type | Description |
|---|---|---|
| note | string | Free note, e.g. what they answered. |
| status | string | New status. |
| prospect_id * | integer | Social prospect id from get_social_queue. |
{
"name": "update_social_prospect",
"description": "Record what happened after a hand-sent message (sent, replied, registered, declined, do_not_contact, skipped, new to undo). 'sent' is refused past today's cap. Messages no one.",
"inputSchema": {
"type": "object",
"required": [
"prospect_id"
],
"properties": {
"note": {
"type": "string",
"description": "Free note, e.g. what they answered."
},
"status": {
"enum": [
"sent",
"replied",
"registered",
"declined",
"do_not_contact",
"skipped",
"new"
],
"type": "string",
"description": "New status."
},
"prospect_id": {
"type": "integer",
"description": "Social prospect id from get_social_queue."
}
}
},
"annotations": {
"title": "Record what happened with a social prospect",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Return the event names an outbound webhook can subscribe to, for example lead.created, with what each one carries.
No parameters.
{
"name": "list_webhook_events",
"description": "Return the event names an outbound webhook can subscribe to, for example lead.created, with what each one carries.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "List subscribable events",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Return the outbound webhook endpoints registered for this organization, the events each one receives and its current delivery state.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Webhooks per page. |
| offset | integer | Webhooks to skip; use next_offset from the previous page. |
{
"name": "list_webhooks",
"description": "Return the outbound webhook endpoints registered for this organization, the events each one receives and its current delivery state.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Webhooks per page."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Webhooks to skip; use next_offset from the previous page."
}
}
},
"annotations": {
"title": "List registered webhooks",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Register a URL ADS Beast calls on a chosen event until it is removed; without client_id it covers every client. Deliveries carry an HMAC in X-ADS-Beast-Signature and are retried; the generated secret is not returned, so pass secret_key if the receiver verifies signatures.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Absolute http or https address of the receiving endpoint. Every matching event is sent to it. |
| name * | string | Label for the webhook in the ADS Beast interface. |
| events * | array | Event names to subscribe to, for example ["lead.created"]. The available names come from list_webhook_events. |
| client_id | integer | Limit deliveries to one client's events. Omitted, the webhook receives every client's events in the organization. |
| secret_key | string | Signing secret for X-ADS-Beast-Signature, chosen by you. Omit to let ADS Beast generate one that this tool will not echo back. |
{
"name": "create_webhook",
"description": "Register a URL ADS Beast calls on a chosen event until it is removed; without client_id it covers every client. Deliveries carry an HMAC in X-ADS-Beast-Signature and are retried; the generated secret is not returned, so pass secret_key if the receiver verifies signatures.",
"inputSchema": {
"type": "object",
"required": [
"name",
"url",
"events"
],
"properties": {
"url": {
"type": "string",
"description": "Absolute http or https address of the receiving endpoint. Every matching event is sent to it."
},
"name": {
"type": "string",
"description": "Label for the webhook in the ADS Beast interface."
},
"events": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Event names to subscribe to, for example [\"lead.created\"]. The available names come from list_webhook_events."
},
"client_id": {
"type": "integer",
"description": "Limit deliveries to one client's events. Omitted, the webhook receives every client's events in the organization."
},
"secret_key": {
"type": "string",
"minLength": 16,
"description": "Signing secret for X-ADS-Beast-Signature, chosen by you. Omit to let ADS Beast generate one that this tool will not echo back."
}
}
},
"annotations": {
"title": "Register an outbound webhook",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Ask before publishing or scheduling an article: articles allowed today and published, whether publishing is paused and why, indexed vs kept-out articles. Start at 2 a day, +1 a week up to 6; one language version of a topic a day. Never plan around the limits.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer | The site's client id; omit for the organization overview. |
{
"name": "seo_publish_safety",
"description": "Ask before publishing or scheduling an article: articles allowed today and published, whether publishing is paused and why, indexed vs kept-out articles. Start at 2 a day, +1 a week up to 6; one language version of a topic a day. Never plan around the limits.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"client_id": {
"type": "integer",
"description": "The site's client id; omit for the organization overview."
}
}
},
"annotations": {
"title": "Check whether a site may publish now",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Change proposals waiting for a person (status pending by default), or their history. Each proposal shows what would change, why, and who proposed it.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Proposals per page. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset. |
| offset | integer | Proposals to skip; use next_offset from the previous page. |
| status | string | pending, approved, rejected, executed, expired or failed. |
| client_id | integer | Only proposals for this client. |
{
"name": "list_proposals",
"description": "Change proposals waiting for a person (status pending by default), or their history. Each proposal shows what would change, why, and who proposed it.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Proposals per page. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Proposals to skip; use next_offset from the previous page."
},
"status": {
"type": "string",
"default": "pending",
"description": "pending, approved, rejected, executed, expired or failed."
},
"client_id": {
"type": "integer",
"description": "Only proposals for this client."
}
}
},
"annotations": {
"title": "List change proposals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Create a change proposal for a campaign. Nothing changes in the ad account until a person approves the proposal in ADS Beast or in Telegram; the proposal expires on its own if nobody decides. State the reason with the numbers behind it.
| Parameter | Type | Description |
|---|---|---|
| change * | string | one of ["pause_campaign","enable_campaign","change_budget"] |
| reason * | string | Why - with the figures the person should check. |
| client_id | integer | |
| new_budget | number | New monthly budget in the account currency; change_budget only. |
| campaign_id * | integer | ADS Beast campaign id (from list_campaigns). |
{
"name": "propose_campaign_change",
"title": "Propose a campaign change (pause, enable, budget)",
"description": "Create a change proposal for a campaign. Nothing changes in the ad account until a person approves the proposal in ADS Beast or in Telegram; the proposal expires on its own if nobody decides. State the reason with the numbers behind it.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"change",
"reason"
],
"properties": {
"change": {
"enum": [
"pause_campaign",
"enable_campaign",
"change_budget"
],
"type": "string"
},
"reason": {
"type": "string",
"description": "Why - with the figures the person should check."
},
"client_id": {
"type": "integer"
},
"new_budget": {
"type": "number",
"description": "New monthly budget in the account currency; change_budget only."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast campaign id (from list_campaigns)."
}
}
},
"annotations": {
"title": "Propose a campaign change",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Reject a pending proposal with a short reason. Returns the proposal id and its new status.
| Parameter | Type | Description |
|---|---|---|
| reason | string | |
| proposal_id * | integer |
{
"name": "reject_proposal",
"description": "Reject a pending proposal with a short reason. Returns the proposal id and its new status.",
"inputSchema": {
"type": "object",
"required": [
"proposal_id"
],
"properties": {
"reason": {
"type": "string"
},
"proposal_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Reject a change proposal",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Campaign types an assistant may draft per platform: the campaign_type key, objective, tracking, bid strategies and under 'fields' what a draft needs with character limits. structure_check 'full' (Google Search, Meta) is the builder's own pre-publish check; 'basic' only common checks.
| Parameter | Type | Description |
|---|---|---|
| platform | string | Only this platform's types. Without it every type is listed. |
{
"name": "list_campaign_types",
"description": "Campaign types an assistant may draft per platform: the campaign_type key, objective, tracking, bid strategies and under 'fields' what a draft needs with character limits. structure_check 'full' (Google Search, Meta) is the builder's own pre-publish check; 'basic' only common checks.",
"inputSchema": {
"type": "object",
"properties": {
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin",
"microsoft"
],
"type": "string",
"description": "Only this platform's types. Without it every type is listed."
}
}
},
"annotations": {
"title": "Campaign types that can be drafted",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Builder drafts, newest first: name, platform, type, status, budget, counts, whether an assistant made it or it was published, and the link. A client-bound key sees its client only.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Builds per page. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset. |
| offset | integer | Builds to skip; use next_offset from the previous page. |
| status | string | one of ["draft","ready","paused","launched"] |
| client_id | integer | Only this client's builds (id from list_clients). |
{
"name": "list_campaign_drafts",
"description": "Builder drafts, newest first: name, platform, type, status, budget, counts, whether an assistant made it or it was published, and the link. A client-bound key sees its client only.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Builds per page. A page is also cut to fit the response size limit; when the reply has has_more = true, call again with offset = next_offset."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Builds to skip; use next_offset from the previous page."
},
"status": {
"enum": [
"draft",
"ready",
"paused",
"launched"
],
"type": "string"
},
"client_id": {
"type": "integer",
"description": "Only this client's builds (id from list_clients)."
}
}
},
"annotations": {
"title": "List campaign builds and drafts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One build and a fresh validation: 'problems' block publishing, 'warnings' do not, 'launch_blockers' say why a person could not publish now, 'not_checked_here' what only publishing checks.
| Parameter | Type | Description |
|---|---|---|
| draft_id * | integer | Build id from list_campaign_drafts or create_campaign_draft. |
{
"name": "get_campaign_draft",
"description": "One build and a fresh validation: 'problems' block publishing, 'warnings' do not, 'launch_blockers' say why a person could not publish now, 'not_checked_here' what only publishing checks.",
"inputSchema": {
"type": "object",
"required": [
"draft_id"
],
"properties": {
"draft_id": {
"type": "integer",
"description": "Build id from list_campaign_drafts or create_campaign_draft."
}
}
},
"annotations": {
"title": "One campaign draft with its validation",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Create a campaign DRAFT in the builder: type, geo, languages, budget, ad groups with keywords or audiences, ads, landing. Nothing reaches the platform. Returns draft id, builder_url and what blocks publishing; the draft is saved anyway. Call list_campaign_types first.
| Parameter | Type | Description |
|---|---|---|
| geo | array | Country codes; Google also 'City, CC'. |
| name * | string | Campaign name a person will see in the builder. |
| extra | object | page_id, instagram_actor_id, dsa_beneficiary, dsa_payor, structured_snippets, search_partners, display_network, geo_target_type, vertical, devices, job_titles, industries, cities, regions. |
| notes | string | Note for the reviewer. |
| audience | object | Social types: age_min, age_max, genders, interests, placements, custom_audiences, allow_broad_audience + broad_audience_reason. |
| platform * | string | one of ["google","meta","tiktok","linkedin","microsoft"] |
| ad_groups | array | Fields and limits per type: list_campaign_types. |
| client_id * | integer | Client id from list_clients. |
| languages | array | Audience language codes. |
Replace fields of an unpublished draft made by create_campaign_draft; each field replaces the stored one whole. Returns a fresh validation. A person's draft or a published build is refused.
| Parameter | Type | Description |
|---|---|---|
| geo | array | Country codes; Google also 'City, CC'. |
| name | string | |
| extra | object | page_id, instagram_actor_id, dsa_beneficiary, dsa_payor, structured_snippets, search_partners, display_network, geo_target_type, vertical, devices, job_titles, industries, cities, regions. |
| notes | string | Note for the reviewer. |
| audience | object | Social types: age_min, age_max, genders, interests, placements, custom_audiences, allow_broad_audience + broad_audience_reason. |
| draft_id * | integer | Draft id returned by create_campaign_draft. |
| ad_groups | array | Fields and limits per type: list_campaign_types. |
| languages | array | Audience language codes. |
| conversion | object | Meta leads/sales: {type: 'website', pixel_id, event} or {type: 'lead_form', lead_form_id}. |
| target_cpa | number |
One call: builder draft, its checks (limits, policy, niche gate, account, write policy), a live-account rehearsal and a key-bound publish request. After a person approves, it is created PAUSED; only a person switches it on (how_to_launch). Google video is refused: its API cannot create it.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| draft | object | Fields of create_campaign_draft: geo, languages, daily_budget, ad_groups, ... |
| reason * | string | Why, with numbers (shown to the approver). |
| platform * | string | one of ["google","meta"] |
| client_id * | integer | |
| campaign_type * | string | Key from list_campaign_types. |
{
"name": "create_campaign_paused",
"description": "One call: builder draft, its checks (limits, policy, niche gate, account, write policy), a live-account rehearsal and a key-bound publish request. After a person approves, it is created PAUSED; only a person switches it on (how_to_launch). Google video is refused: its API cannot create it.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform",
"campaign_type",
"name",
"reason"
],
"properties": {
"name": {
"type": "string"
},
"draft": {
"type": "object",
"description": "Fields of create_campaign_draft: geo, languages, daily_budget, ad_groups, ..."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"platform": {
"enum": [
"google",
"meta"
],
"type": "string"
},
"client_id": {
"type": "integer"
},
"campaign_type": {
"type": "string",
"description": "Key from list_campaign_types."
}
}
},
"annotations": {
"title": "Create a paused Google or Meta campaign",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Tiles per ad account for N days, each in its own currency; null = not measured. share_url: a live /d/ link to show in full.
| Parameter | Type | Description |
|---|---|---|
| days | integer | |
| client_id | integer | |
| share_url | string |
{
"name": "dashboard_tiles",
"description": "Tiles per ad account for N days, each in its own currency; null = not measured. share_url: a live /d/ link to show in full.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"days": {
"type": "integer",
"maximum": 90,
"minimum": 1
},
"client_id": {
"type": "integer"
},
"share_url": {
"type": "string"
}
}
},
"annotations": {
"title": "Show dashboard tiles",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A signed link to this workspace's Google or Meta sign-in: 15 min, any signed-in member, not single-use. The person signs in on the platform's page; the link connects nothing itself.
| Parameter | Type | Description |
|---|---|---|
| platform * | string | one of ["google","meta"] |
| client_id | integer |
{
"name": "get_platform_connect_link",
"description": "A signed link to this workspace's Google or Meta sign-in: 15 min, any signed-in member, not single-use. The person signs in on the platform's page; the link connects nothing itself.",
"inputSchema": {
"type": "object",
"required": [
"platform"
],
"properties": {
"platform": {
"enum": [
"google",
"meta"
],
"type": "string"
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Connect link for Google or Meta",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Per platform: connected through the API and signed in, account names. Call it after get_platform_connect_link.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer |
{
"name": "list_connected_platforms",
"description": "Per platform: connected through the API and signed in, account names. Call it after get_platform_connect_link.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Which ad platforms are connected",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Each client's mode: watch (nothing is written), propose (a person approves every change) or auto (reversible changes apply inside the policy, with undo and the emergency stop). Only a person changes it.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer |
{
"name": "get_autonomy_mode",
"description": "Each client's mode: watch (nothing is written), propose (a person approves every change) or auto (reversible changes apply inside the policy, with undo and the emergency stop). Only a person changes it.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Autonomy mode of a client",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One client's knowledge pack: who they are, accounts and campaigns with 30 days of results, leads by stage, KPI goals, write policy, methodology, prompts. Read it first. No contacts or keys.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | Client id from list_clients. |
{
"name": "get_agency_kit",
"title": "Agency Kit: everything about one client in one document",
"description": "One client's knowledge pack: who they are, accounts and campaigns with 30 days of results, leads by stage, KPI goals, write policy, methodology, prompts. Read it first. No contacts or keys.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer",
"description": "Client id from list_clients."
}
}
},
"annotations": {
"title": "Agency Kit for one client",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One client with its campaigns, key metrics and goals.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "client_overview",
"description": "One client with its campaigns, key metrics and goals.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Client overview",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The action plan from the client's latest weekly deep-dive audit: findings labelled confirmed, inferred or hypothesis, open change proposals and open tasks.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "client_action_plan",
"description": "The action plan from the client's latest weekly deep-dive audit: findings labelled confirmed, inferred or hypothesis, open change proposals and open tasks.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Client action plan",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}KPI goals (ROAS, CPA, CTR, CPC) with target, current value, progress and status. Without client_id: goals of every client.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer |
{
"name": "client_goals",
"description": "KPI goals (ROAS, CPA, CTR, CPC) with target, current value, progress and status. Without client_id: goals of every client.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Client KPI goals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}When each client and platform was last synced. Call it before a deep analysis so stale data is named as stale.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer |
{
"name": "client_data_freshness",
"description": "When each client and platform was last synced. Call it before a deep analysis so stale data is named as stale.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Data freshness",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Search the facts, decisions, preferences and brand notes ADS Beast has stored about clients.
| Parameter | Type | Description |
|---|---|---|
| query * | string | What to look for, in plain words. |
| client_id | integer |
{
"name": "client_memory_search",
"description": "Search the facts, decisions, preferences and brand notes ADS Beast has stored about clients.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "What to look for, in plain words."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Search client memory",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Full-text search over a client's earlier reports, audits and analyses.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| query * | string | Search text. |
| client_id | integer | |
| report_type | string | audit, monthly, jarvis_chat or all. |
{
"name": "client_history_search",
"description": "Full-text search over a client's earlier reports, audits and analyses.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"description": "Max records."
},
"query": {
"type": "string",
"description": "Search text."
},
"client_id": {
"type": "integer"
},
"report_type": {
"enum": [
"audit",
"monthly",
"jarvis_chat",
"all"
],
"type": "string",
"default": "all",
"description": "audit, monthly, jarvis_chat or all."
}
}
},
"annotations": {
"title": "Search past reports and audits",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Read a landing page and extract its headline, offer, selling points, calls to action, keywords and tone. Without url, the client's own site is used. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| url | string | https:// page URL. |
| client_id | integer |
{
"name": "client_landing_scan",
"description": "Read a landing page and extract its headline, offer, selling points, calls to action, keywords and tone. Without url, the client's own site is used. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Scan a client's landing page",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The stored market analysis of a client: summary, competitor matrix, audience signals and the draft campaign strategy.
| Parameter | Type | Description |
|---|---|---|
| section | string | all, summary, competitors, audience, strategy or insights. |
| client_id * | integer |
{
"name": "client_market_analysis",
"description": "The stored market analysis of a client: summary, competitor matrix, audience signals and the draft campaign strategy.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"section": {
"enum": [
"all",
"summary",
"competitors",
"audience",
"strategy",
"insights"
],
"type": "string",
"description": "all, summary, competitors, audience, strategy or insights."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Get market analysis",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Crawl the client's site, find and analyse competitors and build a market intelligence report. Takes minutes; read the result with client_market_analysis. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| force | boolean | true re-runs even when a fresh report exists. |
| client_id * | integer |
{
"name": "client_market_analysis_run",
"description": "Crawl the client's site, find and analyse competitors and build a market intelligence report. Takes minutes; read the result with client_market_analysis. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"force": {
"type": "boolean",
"description": "true re-runs even when a fresh report exists."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Run market analysis",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Semantic search over a client's indexed market data: its site, competitor profiles and the market report.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Search text. |
| top_k | integer | Number of results, 5 by default. |
| client_id * | integer |
{
"name": "client_market_intel_search",
"description": "Semantic search over a client's indexed market data: its site, competitor profiles and the market report.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search text."
},
"top_k": {
"type": "integer",
"description": "Number of results, 5 by default."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Search market intelligence",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Status and report of the multi-agent market simulations requested for a client.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "client_market_simulation",
"description": "Status and report of the multi-agent market simulations requested for a client.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Get market simulation",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Spend, CTR, CPA and ROAS of one client over a period. Money is reported in the account currency and never summed across currencies.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id * | integer |
{
"name": "analytics_summary",
"description": "Spend, CTR, CPA and ROAS of one client over a period. Money is reported in the account currency and never summed across currencies.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Performance summary",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Percentage change of every KPI between the current period and the one before it, by platform, with what got worse and what improved.
| Parameter | Type | Description |
|---|---|---|
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id * | integer | |
| current_days | integer | Length of the current period in days. |
| previous_days | integer | Length of the preceding period in days. |
{
"name": "analytics_compare_periods",
"description": "Percentage change of every KPI between the current period and the one before it, by platform, with what got worse and what improved.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
},
"current_days": {
"type": "integer",
"default": 30,
"description": "Length of the current period in days."
},
"previous_days": {
"type": "integer",
"default": 30,
"description": "Length of the preceding period in days."
}
}
},
"annotations": {
"title": "Compare two periods",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Projection of CPA, ROAS and spend 7 and 30 days ahead from the current trend. A projection, not a promise: it extrapolates the last 14-30 days.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| campaign_id | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "analytics_forecast",
"description": "Projection of CPA, ROAS and spend 7 and 30 days ahead from the current trend. A projection, not a promise: it extrapolates the last 14-30 days.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "Forecast KPIs",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Campaigns expected to break a KPI target within days, from a linear trend.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "analytics_forecast_warnings",
"description": "Campaigns expected to break a KPI target within days, from a linear trend.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Forecast warnings",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Time-decay multi-touch attribution for a client's campaigns: attributed conversions, attributed CPA and the lift against last click.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| client_id * | integer |
{
"name": "analytics_attribution",
"description": "Time-decay multi-touch attribution for a client's campaigns: attributed conversions, attributed CPA and the lift against last click.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Attribution breakdown",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Cross-client analysis of the whole portfolio: best and worst performers, platform trends, total spend. Takes up to a minute. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
{
"name": "analytics_portfolio",
"description": "Cross-client analysis of the whole portfolio: best and worst performers, platform trends, total spend. Takes up to a minute. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
}
}
},
"annotations": {
"title": "Portfolio analysis",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Patterns and anomalies across clients: platforms that sag for most of them, shared niche problems, who outperforms.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
{
"name": "analytics_cross_client_insights",
"description": "Patterns and anomalies across clients: platforms that sag for most of them, shared niche problems, who outperforms.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
}
}
},
"annotations": {
"title": "Cross-client insights",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Quick status of all active campaigns: how many are on target and how many need attention.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer |
{
"name": "analytics_kpi_health",
"description": "Quick status of all active campaigns: how many are on target and how many need attention.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "KPI health check",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Campaigns ready to scale: ROAS well above target, CPA well below target, or budget left unused.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer | |
| min_roas_multiplier | number | ROAS-to-target ratio that counts as ready to scale, for example 1.5. |
{
"name": "analytics_growth_opportunities",
"description": "Campaigns ready to scale: ROAS well above target, CPA well below target, or budget left unused.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
},
"min_roas_multiplier": {
"type": "number",
"default": 1.5,
"description": "ROAS-to-target ratio that counts as ready to scale, for example 1.5."
}
}
},
"annotations": {
"title": "Growth opportunities",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reference CTR, CPC, CPA and ROAS ranges for a platform and niche. Benchmarks are orientation, not a verdict on one account.
| Parameter | Type | Description |
|---|---|---|
| niche | string | Business niche or industry, in plain words. |
| platform * | string | one of ["google","meta","tiktok","linkedin","microsoft"] |
{
"name": "analytics_benchmarks",
"description": "Reference CTR, CPC, CPA and ROAS ranges for a platform and niche. Benchmarks are orientation, not a verdict on one account.",
"inputSchema": {
"type": "object",
"required": [
"platform"
],
"properties": {
"niche": {
"type": "string",
"description": "Business niche or industry, in plain words."
},
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin",
"microsoft"
],
"type": "string"
}
}
},
"annotations": {
"title": "Industry benchmarks",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Morning briefing for the workspace: critical alerts, today's tasks and what needs attention now.
No parameters.
{
"name": "analytics_agency_briefing",
"description": "Morning briefing for the workspace: critical alerts, today's tasks and what needs attention now.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Daily briefing",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A sourced chain of planning numbers for a campaign type: CPM, reach, clicks, CPC, conversion rate, conversions, CPA, break-even and three scenarios. Every figure is labelled with where it comes from.
| Parameter | Type | Description |
|---|---|---|
| niche | string | Business niche or industry, in plain words. |
| currency | string | ISO currency code of the budget. |
| platform * | string | google, meta, tiktok, linkedin or microsoft. |
| client_id | integer | |
| num_objects | integer | How many ad sets or ad groups share the budget. |
| monthly_budget * | number | Monthly budget in the stated currency, whole units. |
| avg_order_value | number | Average order value, for revenue and break-even. |
| gross_margin_pct | number | Gross margin in percent, for break-even. |
| objective_or_type * | string | Goal or campaign type: leads, sales, traffic, or a key from campaign_type_coverage. |
A/B tests with their status and interim results.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| status | string | Only records in this status. |
| client_id | integer | |
| campaign_id | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "analytics_ab_tests",
"description": "A/B tests with their status and interim results.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"description": "Max records."
},
"status": {
"enum": [
"running",
"complete",
"paused",
"cancelled"
],
"type": "string",
"description": "Only records in this status."
},
"client_id": {
"type": "integer"
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "List A/B tests",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}AI audit of a client's ad account on one platform or all of them. Takes 10-30 seconds. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id * | integer |
{
"name": "audit_account",
"description": "AI audit of a client's ad account on one platform or all of them. Takes 10-30 seconds. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"platform": {
"type": "string",
"default": "all",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Audit an ad account",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Full Google Ads audit for a client: structure, keywords, responsive search ads, extensions, bidding, conversions and Quality Score problems, with a 0-100 score and recommendations. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| depth | string | quick or full. |
| client_id * | integer |
{
"name": "audit_google_ads",
"description": "Full Google Ads audit for a client: structure, keywords, responsive search ads, extensions, bidding, conversions and Quality Score problems, with a 0-100 score and recommendations. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"depth": {
"enum": [
"quick",
"full"
],
"type": "string",
"default": "full",
"description": "quick or full."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Audit Google Ads",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Full Meta Ads audit for a client: funnel structure, audiences, creatives, pixel health, conversion events, audience fatigue and Advantage+ setup. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "audit_meta_ads",
"description": "Full Meta Ads audit for a client: funnel structure, audiences, creatives, pixel health, conversion events, audience fatigue and Advantage+ setup. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Audit Meta Ads",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Check that a client's ads learn from real leads: which Google Ads conversions are primary, whether calls and forms are counted, and campaigns optimising for the wrong goal.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "audit_conversion_goals",
"description": "Check that a client's ads learn from real leads: which Google Ads conversions are primary, whether calls and forms are counted, and campaigns optimising for the wrong goal.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Audit conversion goals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Tracking diagnostics for a client: pixel, GA4 and GTM mismatches on the landing page, conversion actions and the other tracking guards in one report.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "audit_tracking",
"description": "Tracking diagnostics for a client: pixel, GA4 and GTM mismatches on the landing page, conversion actions and the other tracking guards in one report.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Audit tracking setup",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reads every running Google and Meta campaign of a client from the platform and checks geo, conversions against the bid strategy, moderation, landing pages and search assets.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "audit_campaign_quality",
"description": "Reads every running Google and Meta campaign of a client from the platform and checks geo, conversions against the bid strategy, moderation, landing pages and search assets.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Live campaign quality check",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Campaigns that burn budget: spend with zero conversions, CPA above target, no clicks. Returns the amounts lost, in the account currency.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| client_id | integer |
{
"name": "audit_wasted_spend",
"description": "Campaigns that burn budget: spend with zero conversions, CPA above target, no clicks. Returns the amounts lost, in the account currency.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Find wasted spend",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Health score of every campaign, the ones in a critical state, without conversions, without goals or with stale data. A good first call before a deeper audit.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer | |
| only_active | boolean | Only running campaigns. |
{
"name": "audit_campaign_portfolio",
"description": "Health score of every campaign, the ones in a critical state, without conversions, without goals or with stale data. A good first call before a deeper audit.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
},
"only_active": {
"type": "boolean",
"default": true,
"description": "Only running campaigns."
}
}
},
"annotations": {
"title": "Scan campaign portfolio",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A 1-10 health score for each campaign of a client with the problems behind it.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "audit_campaign_health",
"description": "A 1-10 health score for each campaign of a client with the problems behind it.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Campaign health summary",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A prioritised optimisation plan for a client's last 7 days from four specialist reviews (media buying, budget, audience, creative), with a confidence level per item. Recommendations only. Takes up to a minute. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "audit_performance_coach",
"description": "A prioritised optimisation plan for a client's last 7 days from four specialist reviews (media buying, budget, audience, creative), with a confidence level per item. Recommendations only. Takes up to a minute. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Performance coaching review",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Ads the platforms rejected, with the reason and the policy code.
| Parameter | Type | Description |
|---|---|---|
| status | string | open (default), acknowledged, fixed, wontfix or all. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id | integer |
{
"name": "audit_ad_disapprovals",
"description": "Ads the platforms rejected, with the reason and the policy code.",
"inputSchema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "open (default), acknowledged, fixed, wontfix or all."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "List disapproved ads",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Open recommendation cards: agent advice and Meta's own cabinet advice, judged against the client's goal.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | 10 by default, 30 at most. |
| source | string | meta_native for Meta's cabinet advice. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id | integer |
{
"name": "recommendation_list",
"description": "Open recommendation cards: agent advice and Meta's own cabinet advice, judged against the client's goal.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"description": "10 by default, 30 at most."
},
"source": {
"type": "string",
"description": "meta_native for Meta's cabinet advice."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "List open recommendations",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Campaigns filtered by client, platform, status or a substring of the name.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | 50 by default, 200 at most. |
| status | string | Only records in this status. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id | integer | |
| name_filter | string | Case-insensitive substring of the campaign name. |
{
"name": "campaign_search",
"description": "Campaigns filtered by client, platform, status or a substring of the name.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"description": "50 by default, 200 at most."
},
"status": {
"type": "string",
"description": "Only records in this status."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
},
"name_filter": {
"type": "string",
"description": "Case-insensitive substring of the campaign name."
}
}
},
"annotations": {
"title": "Search campaigns by name",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Deep analysis of one campaign: metrics, trends and recommendations. Takes up to a minute. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "campaign_analyze",
"description": "Deep analysis of one campaign: metrics, trends and recommendations. Takes up to a minute. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "Analyse a campaign",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Works through the possible causes of one KPI problem in a campaign: audience saturation, creative fatigue, landing page, bid strategy, seasonality, tracking.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| problem * | string | The symptom to explain. |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "campaign_diagnose",
"description": "Works through the possible causes of one KPI problem in a campaign: audience saturation, creative fatigue, landing page, bid strategy, seasonality, tracking.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"problem"
],
"properties": {
"days": {
"type": "integer",
"default": 14,
"description": "Look-back days."
},
"problem": {
"enum": [
"high_cpa",
"low_ctr",
"zero_conversions",
"low_roas",
"high_cpc",
"budget_underuse"
],
"type": "string",
"description": "The symptom to explain."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "Diagnose a campaign problem",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}What worked for a client before: average CPA and CTR, best campaigns and best audiences.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "campaign_history_analysis",
"description": "What worked for a client before: average CPA and CTR, best campaigns and best audiences.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Analyse campaign history",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Which campaign types ADS Beast supports on each platform and how far: creation through the API, generation, validation.
| Parameter | Type | Description |
|---|---|---|
| platform | string | google, meta, tiktok, linkedin or microsoft. |
{
"name": "campaign_type_coverage",
"description": "Which campaign types ADS Beast supports on each platform and how far: creation through the API, generation, validation.",
"inputSchema": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
}
}
},
"annotations": {
"title": "Campaign type coverage",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A strategic plan for a client over a horizon: channels, budget split, KPI targets and launch phases. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| focus | string | growth, efficiency or brand. |
| client_id * | integer | |
| horizon_months | integer | Planning horizon, 1-12 months. |
{
"name": "campaign_strategy_generate",
"description": "A strategic plan for a client over a horizon: channels, budget split, KPI targets and launch phases. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"focus": {
"type": "string",
"description": "growth, efficiency or brand."
},
"client_id": {
"type": "integer"
},
"horizon_months": {
"type": "integer",
"default": 3,
"description": "Planning horizon, 1-12 months."
}
}
},
"annotations": {
"title": "Generate a strategy",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Six specialist viewpoints (media buyer, copywriter, audience, competitors, conversion, data) on a planned campaign. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| platform | string | one of ["google","meta","both","tiktok","linkedin","all"] |
| client_id * | integer | |
| objective | string | leads, sales, traffic or awareness. |
| extra_context | string | Anything the reviewers should know. |
| budget_monthly | number | Planned monthly budget in the account currency, whole units. |
{
"name": "campaign_strategy_expert_review",
"description": "Six specialist viewpoints (media buyer, copywriter, audience, competitors, conversion, data) on a planned campaign. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"geo": {
"type": "string",
"default": "UA",
"description": "Country code, e.g. us or de."
},
"platform": {
"enum": [
"google",
"meta",
"both",
"tiktok",
"linkedin",
"all"
],
"type": "string",
"default": "both"
},
"client_id": {
"type": "integer"
},
"objective": {
"enum": [
"leads",
"sales",
"traffic",
"awareness"
],
"type": "string",
"default": "leads",
"description": "leads, sales, traffic or awareness."
},
"extra_context": {
"type": "string",
"description": "Anything the reviewers should know."
},
"budget_monthly": {
"type": "number",
"default": 1000,
"description": "Planned monthly budget in the account currency, whole units."
}
}
},
"annotations": {
"title": "Expert strategy review",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Recent multi-agent campaign generation runs with status, platform and budget.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| client_id | integer |
{
"name": "campaign_swarm_runs",
"description": "Recent multi-agent campaign generation runs with status, platform and budget.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"description": "Max records."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "List campaign generation runs",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A campaign draft in full: platform, type, goal, budget, UTM, targeting, ad groups with keywords and ads, and the platform campaign id once it was published.
| Parameter | Type | Description |
|---|---|---|
| build_id * | integer | Draft id from list_campaign_drafts. |
| client_id * | integer |
{
"name": "campaign_draft_details",
"description": "A campaign draft in full: platform, type, goal, budget, UTM, targeting, ad groups with keywords and ads, and the platform campaign id once it was published.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"build_id"
],
"properties": {
"build_id": {
"type": "integer",
"description": "Draft id from list_campaign_drafts."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Full campaign draft",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Validates a campaign draft against the live ad account and reports exactly what publishing would create or change. Read-only rehearsal: nothing is written.
| Parameter | Type | Description |
|---|---|---|
| build_id * | integer | Draft id from list_campaign_drafts. |
| client_id * | integer | |
| platform_campaign_id | string | Existing platform campaign to complete instead of creating a new one. |
{
"name": "campaign_draft_publish_check",
"description": "Validates a campaign draft against the live ad account and reports exactly what publishing would create or change. Read-only rehearsal: nothing is written.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"build_id"
],
"properties": {
"build_id": {
"type": "integer",
"description": "Draft id from list_campaign_drafts."
},
"client_id": {
"type": "integer"
},
"platform_campaign_id": {
"type": "string",
"description": "Existing platform campaign to complete instead of creating a new one."
}
}
},
"annotations": {
"title": "Rehearse publishing a draft",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Ad Strength of a client's responsive search ads: counts by level and the weak ads with Google's own action items.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| force_refresh | boolean | true queries Google live instead of using the stored snapshot. |
{
"name": "google_ads_ad_strength",
"description": "Ad Strength of a client's responsive search ads: counts by level and the weak ads with Google's own action items.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"force_refresh": {
"type": "boolean",
"default": false,
"description": "true queries Google live instead of using the stored snapshot."
}
}
},
"annotations": {
"title": "Google ad strength",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Finds the same keyword and match type enabled in two or more active Google campaigns of one account. Detection only.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "google_ads_keyword_overlap",
"description": "Finds the same keyword and match type enabled in two or more active Google campaigns of one account. Detection only.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Find duplicate keywords",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Returns a ready Google Ads Script (JavaScript) for one campaign that a person pastes into Google Ads themselves. The tool only produces text. Amounts are in the ad account's own currency, in whole units (not cents or micros).
| Parameter | Type | Description |
|---|---|---|
| action * | string | What the script does. |
| new_value | number | New value for the update actions: monthly budget, target CPA or target ROAS. |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "google_ads_script_generate",
"description": "Returns a ready Google Ads Script (JavaScript) for one campaign that a person pastes into Google Ads themselves. The tool only produces text. Amounts are in the ad account's own currency, in whole units (not cents or micros).",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"action"
],
"properties": {
"action": {
"enum": [
"pause",
"enable",
"update_budget",
"update_cpa",
"update_roas"
],
"type": "string",
"description": "What the script does."
},
"new_value": {
"type": "number",
"description": "New value for the update actions: monthly budget, target CPA or target ROAS."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "Generate a Google Ads script",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reads a client's Google Ads conversion actions and tag and reports which action fits the named conversion, or what would be created. Read-only.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Conversion name, for example 'CRM signup'. |
| category | string | Conversion category. |
| client_id * | integer | |
| account_id | string | Google account id; needed only when the client has several. |
{
"name": "google_ads_conversion_tracking_check",
"description": "Reads a client's Google Ads conversion actions and tag and reports which action fits the named conversion, or what would be created. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Conversion name, for example 'CRM signup'."
},
"category": {
"enum": [
"SIGNUP",
"LEAD",
"SUBMIT_LEAD_FORM",
"PURCHASE",
"CONTACT",
"REQUEST_QUOTE"
],
"type": "string",
"default": "SIGNUP",
"description": "Conversion category."
},
"client_id": {
"type": "integer"
},
"account_id": {
"type": "string",
"description": "Google account id; needed only when the client has several."
}
}
},
"annotations": {
"title": "Check Google conversion tracking",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reads a Google App campaign and validates the videos proposed for it. Read-only.
| Parameter | Type | Description |
|---|---|---|
| title | string | Short title. |
| client_id * | integer | |
| account_id | string | Google account id; needed only when the client has several. |
| video_urls | array | https links to mp4 files. |
| campaign_id * | string | Google Ads id of the App campaign (digits). |
| youtube_videos | array | Ids or links of videos already on YouTube. |
{
"name": "google_ads_app_videos_check",
"description": "Reads a Google App campaign and validates the videos proposed for it. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"campaign_id"
],
"properties": {
"title": {
"type": "string",
"description": "Short title."
},
"client_id": {
"type": "integer"
},
"account_id": {
"type": "string",
"description": "Google account id; needed only when the client has several."
},
"video_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "https links to mp4 files."
},
"campaign_id": {
"type": "string",
"description": "Google Ads id of the App campaign (digits)."
},
"youtube_videos": {
"type": "array",
"items": {
"type": "string"
},
"description": "Ids or links of videos already on YouTube."
}
}
},
"annotations": {
"title": "Check videos for an App campaign",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Pixels, pages, lead forms and conversion events of a client's Meta ad account.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "meta_ads_account_setup",
"description": "Pixels, pages, lead forms and conversion events of a client's Meta ad account.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Meta account setup",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Targeting interests matching a keyword, with id, name, audience size and topic.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| query * | string | Keyword, for example fitness or real estate. |
| client_id * | integer |
{
"name": "meta_ads_interest_search",
"description": "Targeting interests matching a keyword, with id, name, audience size and topic.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 15,
"description": "Max records."
},
"query": {
"type": "string",
"description": "Keyword, for example fitness or real estate."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Search Meta interests",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Learning status of every active ad set of a client, with what holds learning back.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| campaign_id | string | Meta's own campaign id, to check one campaign only. |
| target_cpa_usd | number | Target CPA, used to judge whether budgets are sufficient. |
{
"name": "meta_ads_learning_phase",
"description": "Learning status of every active ad set of a client, with what holds learning back.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"campaign_id": {
"type": "string",
"description": "Meta's own campaign id, to check one campaign only."
},
"target_cpa_usd": {
"type": "number",
"description": "Target CPA, used to judge whether budgets are sufficient."
}
}
},
"annotations": {
"title": "Meta learning phase",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Shows which ad sets of a client's active Meta campaigns still run on fraud-prone placements and what the safe targeting would be. Read-only.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| objective | string | Meta objective, OUTCOME_LEADS by default. |
| include_bot_audience | boolean | Also plan the bot exclusion audience. |
{
"name": "meta_ads_placement_safety_check",
"description": "Shows which ad sets of a client's active Meta campaigns still run on fraud-prone placements and what the safe targeting would be. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"objective": {
"type": "string",
"description": "Meta objective, OUTCOME_LEADS by default."
},
"include_bot_audience": {
"type": "boolean",
"description": "Also plan the bot exclusion audience."
}
}
},
"annotations": {
"title": "Check risky Meta placements",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Pixels, identities and account details of a client's TikTok ad account.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "tiktok_ads_account_setup",
"description": "Pixels, identities and account details of a client's TikTok ad account.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "TikTok account setup",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Conversions, campaign groups and account details of a client's LinkedIn ad account.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "linkedin_ads_account_setup",
"description": "Conversions, campaign groups and account details of a client's LinkedIn ad account.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "LinkedIn account setup",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Status, currency and write switch of a client's accounts.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "linkedin_ads_accounts",
"description": "Status, currency and write switch of a client's accounts.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "LinkedIn ad accounts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Campaign groups with budget and schedule.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "linkedin_ads_campaign_groups",
"description": "Campaign groups with budget and schedule.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "LinkedIn campaign groups",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Status, budget, bid, schedule and ADS Beast id per campaign.
| Parameter | Type | Description |
|---|---|---|
| status | string | Only records in this status. |
| client_id * | integer |
{
"name": "linkedin_ads_campaigns",
"description": "Status, budget, bid, schedule and ADS Beast id per campaign.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"status": {
"type": "string",
"description": "Only records in this status."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "LinkedIn campaigns",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Creatives and their review status.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| platform_campaign_id | string | LinkedIn id. |
{
"name": "linkedin_ads_creatives",
"description": "Creatives and their review status.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"platform_campaign_id": {
"type": "string",
"description": "LinkedIn id."
}
}
},
"annotations": {
"title": "LinkedIn creatives",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Per-campaign impressions, clicks, spend and conversions. Amounts are in the ad account's own currency, in whole units (not cents or micros).
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| client_id * | integer |
{
"name": "linkedin_ads_performance",
"description": "Per-campaign impressions, clicks, spend and conversions. Amounts are in the ad account's own currency, in whole units (not cents or micros).",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"days": {
"type": "integer",
"description": "Look-back days."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "LinkedIn performance",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One campaign's included and excluded audience facets.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| platform_campaign_id * | string | LinkedIn id. |
{
"name": "linkedin_ads_targeting",
"description": "One campaign's included and excluded audience facets.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform_campaign_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"platform_campaign_id": {
"type": "string",
"description": "LinkedIn id."
}
}
},
"annotations": {
"title": "LinkedIn targeting",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Spend without conversions or with CPA 2x the account, labelled confirmed or insufficient_data.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform * | string | linkedin, tiktok or amazon. |
| client_id * | integer |
{
"name": "platform_wasted_spend",
"description": "Spend without conversions or with CPA 2x the account, labelled confirmed or insufficient_data.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform"
],
"properties": {
"days": {
"type": "integer",
"description": "Look-back days."
},
"platform": {
"enum": [
"linkedin",
"tiktok",
"amazon"
],
"type": "string",
"description": "linkedin, tiktok or amazon."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "LinkedIn/TikTok/Amazon wasted spend",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Capped bid step per campaign towards a target CPA.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform * | string | linkedin, tiktok or amazon. |
| client_id * | integer | |
| target_cpa | number | In the account currency. |
{
"name": "platform_bid_suggestions",
"description": "Capped bid step per campaign towards a target CPA.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform"
],
"properties": {
"days": {
"type": "integer",
"description": "Look-back days."
},
"platform": {
"enum": [
"linkedin",
"tiktok",
"amazon"
],
"type": "string",
"description": "linkedin, tiktok or amazon."
},
"client_id": {
"type": "integer"
},
"target_cpa": {
"type": "number",
"description": "In the account currency."
}
}
},
"annotations": {
"title": "LinkedIn/TikTok/Amazon bid suggestions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}UET tags, conversion goals and account details of a client's Microsoft Ads account.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "microsoft_ads_account_setup",
"description": "UET tags, conversion goals and account details of a client's Microsoft Ads account.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Microsoft Ads account setup",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Connected Telegram Ads accounts, their goal and currency, and what is automated versus done by hand.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer |
{
"name": "telegram_ads_status",
"description": "Connected Telegram Ads accounts, their goal and currency, and what is automated versus done by hand.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Telegram Ads status",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Checks a sponsored message against Telegram's prohibited categories, the 160-character text limit, the title limit and the link format.
| Parameter | Type | Description |
|---|---|---|
| cpm | number | CPM bid in the account currency. |
| text * | string | Sponsored message text. |
| title | string | Internal ad name, up to 128 bytes. |
| currency | string | Account currency: EUR, TON or XTR. |
| client_id | integer | |
| promote_url | string | What is promoted: @username, t.me link, bot or website. |
| website_name | string | Site name, required when an external site is promoted. |
{
"name": "telegram_ads_policy_check",
"description": "Checks a sponsored message against Telegram's prohibited categories, the 160-character text limit, the title limit and the link format.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"cpm": {
"type": "number",
"description": "CPM bid in the account currency."
},
"text": {
"type": "string",
"description": "Sponsored message text."
},
"title": {
"type": "string",
"description": "Internal ad name, up to 128 bytes."
},
"currency": {
"type": "string",
"description": "Account currency: EUR, TON or XTR."
},
"client_id": {
"type": "integer"
},
"promote_url": {
"type": "string",
"description": "What is promoted: @username, t.me link, bot or website."
},
"website_name": {
"type": "string",
"description": "Site name, required when an external site is promoted."
}
}
},
"annotations": {
"title": "Check a Telegram ad",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Whether a channel exists, is public and how many subscribers it has.
| Parameter | Type | Description |
|---|---|---|
| username * | string | @username or t.me/username of the channel. |
{
"name": "telegram_ads_verify_channel",
"description": "Whether a channel exists, is public and how many subscribers it has.",
"inputSchema": {
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"description": "@username or t.me/username of the channel."
}
}
},
"annotations": {
"title": "Verify a Telegram channel",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Languages, topics with their ids and countries, read from Telegram Ads itself for one connected account.
| Parameter | Type | Description |
|---|---|---|
| account_id * | integer | ADS Beast ad account id. |
{
"name": "telegram_ads_targeting",
"description": "Languages, topics with their ids and countries, read from Telegram Ads itself for one connected account.",
"inputSchema": {
"type": "object",
"required": [
"account_id"
],
"properties": {
"account_id": {
"type": "integer",
"description": "ADS Beast ad account id."
}
}
},
"annotations": {
"title": "Telegram targeting options",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Connected ChatGPT Ads accounts, campaigns, ad review statuses and what blocks delivery.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer |
{
"name": "chatgpt_ads_status",
"description": "Connected ChatGPT Ads accounts, campaigns, ad review statuses and what blocks delivery.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "ChatGPT Ads status",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Whether ChatGPT Ads policy admits this business and whether the texts fit the limits (title 50, body 100).
| Parameter | Type | Description |
|---|---|---|
| url | string | Landing page. |
| body | string | Ad text. |
| text | string | The business, offer or campaign theme. |
| title | string | Ad title. |
| client_id | integer | |
| context_hints | array | Conversation themes, not keywords. |
{
"name": "chatgpt_ads_policy_check",
"description": "Whether ChatGPT Ads policy admits this business and whether the texts fit the limits (title 50, body 100).",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Landing page."
},
"body": {
"type": "string",
"description": "Ad text."
},
"text": {
"type": "string",
"description": "The business, offer or campaign theme."
},
"title": {
"type": "string",
"description": "Ad title."
},
"client_id": {
"type": "integer"
},
"context_hints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Conversation themes, not keywords."
}
}
},
"annotations": {
"title": "Check a ChatGPT ad",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Campaigns of a client with high frequency and falling CTR, ranked by how tired the creative is.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| threshold_frequency | number | Minimum frequency that counts as fatigue. |
{
"name": "creative_fatigue_report",
"description": "Campaigns of a client with high frequency and falling CTR, ranked by how tired the creative is.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"threshold_frequency": {
"type": "number",
"default": 3.5,
"description": "Minimum frequency that counts as fatigue."
}
}
},
"annotations": {
"title": "Creative fatigue report",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reviews an ad image for platform fit, visual hierarchy, call-to-action legibility and brand fit. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| context | string | Brand, audience or goal. |
| platform | string | one of ["google","meta","tiktok","linkedin"] |
| image_url * | string | Public https URL of the image. |
{
"name": "creative_image_analyze",
"description": "Reviews an ad image for platform fit, visual hierarchy, call-to-action legibility and brand fit. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"image_url"
],
"properties": {
"context": {
"type": "string",
"description": "Brand, audience or goal."
},
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin"
],
"type": "string"
},
"image_url": {
"type": "string",
"description": "Public https URL of the image."
}
}
},
"annotations": {
"title": "Analyse an ad image",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reviews a generated banner of ADS Beast for garbled text, legibility, platform spec fit and visual quality, with a score and fixes. Takes up to a minute. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| platform | string | one of ["meta","google","tiktok","linkedin"] |
| creative_id * | integer | ADS Beast creative id, as returned by prepare_banner_generate once it ran. |
| format_label | string | Format label, for example 'Feed 1:1' or 'Story 9:16'. |
{
"name": "creative_banner_quality_check",
"description": "Reviews a generated banner of ADS Beast for garbled text, legibility, platform spec fit and visual quality, with a score and fixes. Takes up to a minute. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"creative_id"
],
"properties": {
"platform": {
"enum": [
"meta",
"google",
"tiktok",
"linkedin"
],
"type": "string",
"default": "meta"
},
"creative_id": {
"type": "integer",
"description": "ADS Beast creative id, as returned by prepare_banner_generate once it ran."
},
"format_label": {
"type": "string",
"description": "Format label, for example 'Feed 1:1' or 'Story 9:16'."
}
}
},
"annotations": {
"title": "Check a banner's quality",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A library of prompts for generating ad banners, filtered by business vertical and visual style.
| Parameter | Type | Description |
|---|---|---|
| style | string | Visual style. |
| vertical | string | Business vertical. |
{
"name": "creative_prompt_templates",
"description": "A library of prompts for generating ad banners, filtered by business vertical and visual style.",
"inputSchema": {
"type": "object",
"properties": {
"style": {
"enum": [
"photorealistic",
"lifestyle",
"minimalist",
"bold",
"corporate"
],
"type": "string",
"description": "Visual style."
},
"vertical": {
"enum": [
"real_estate",
"beauty_fashion",
"finance",
"ecommerce_retail",
"food_beverage",
"automotive",
"fitness",
"tech_saas",
"travel",
"education"
],
"type": "string",
"description": "Business vertical."
}
}
},
"annotations": {
"title": "Banner prompt templates",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Scores a text 0-100 for signs of machine writing, lists the markers found and returns a cleaned version. It never invents facts.
| Parameter | Type | Description |
|---|---|---|
| text * | string | The text to check or use. |
| surface | string | ad_copy, prose, report or raw. |
{
"name": "creative_copy_humanize",
"description": "Scores a text 0-100 for signs of machine writing, lists the markers found and returns a cleaned version. It never invents facts.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "The text to check or use."
},
"surface": {
"enum": [
"ad_copy",
"prose",
"report",
"raw"
],
"type": "string",
"description": "ad_copy, prose, report or raw."
}
}
},
"annotations": {
"title": "Check copy for AI tells",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Competitors on record with site, niche, collected ads and keywords.
| Parameter | Type | Description |
|---|---|---|
| with_ads | boolean | Include the collected ads (larger response). |
| client_id | integer |
{
"name": "competitor_list",
"description": "Competitors on record with site, niche, collected ads and keywords.",
"inputSchema": {
"type": "object",
"properties": {
"with_ads": {
"type": "boolean",
"default": false,
"description": "Include the collected ads (larger response)."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "List competitors",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Searches the web for a competitor's ads, positioning, pricing, selling points and reviews.
| Parameter | Type | Description |
|---|---|---|
| niche | string | Business niche or industry, in plain words. |
| aspect | string | ads, pricing, reviews, positioning or all. |
| client_id | integer | |
| competitor_domain | string | Competitor's domain. |
{
"name": "competitor_search_intel",
"description": "Searches the web for a competitor's ads, positioning, pricing, selling points and reviews.",
"inputSchema": {
"type": "object",
"properties": {
"niche": {
"type": "string",
"description": "Business niche or industry, in plain words."
},
"aspect": {
"enum": [
"ads",
"pricing",
"reviews",
"positioning",
"all"
],
"type": "string",
"default": "all",
"description": "ads, pricing, reviews, positioning or all."
},
"client_id": {
"type": "integer"
},
"competitor_domain": {
"type": "string",
"description": "Competitor's domain."
}
}
},
"annotations": {
"title": "Research competitors",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Competitors in a niche and country with their headlines, angles and calls to action. The response says whether an item was observed in an ad library or inferred. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| niche | string | Business niche or industry, in plain words. |
| client_id | integer |
{
"name": "competitor_ads_research",
"description": "Competitors in a niche and country with their headlines, angles and calls to action. The response says whether an item was observed in an ad library or inferred. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"geo": {
"type": "string",
"default": "UA",
"description": "Country code, e.g. us or de."
},
"niche": {
"type": "string",
"description": "Business niche or industry, in plain words."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Research competitor ads",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reads one competitor site: selling points, prices, technology, pixels, call-to-action patterns and audience signals.
| Parameter | Type | Description |
|---|---|---|
| url * | string | https:// page URL. |
| client_id * | integer |
{
"name": "competitor_site_analyze",
"description": "Reads one competitor site: selling points, prices, technology, pixels, call-to-action patterns and audience signals.",
"inputSchema": {
"type": "object",
"required": [
"url",
"client_id"
],
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Analyse a competitor site",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A competitor's recent activity outside its site: YouTube, blog feed, public posts and community mentions.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| competitor_url * | string | Competitor's site. |
{
"name": "competitor_social_signals",
"description": "A competitor's recent activity outside its site: YouTube, blog feed, public posts and community mentions.",
"inputSchema": {
"type": "object",
"required": [
"competitor_url",
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"competitor_url": {
"type": "string",
"description": "Competitor's site."
}
}
},
"annotations": {
"title": "Competitor social signals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Compares how often AI models mention the client versus competitors for the same prompts. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| competitors | array | Competitor names or domains. |
{
"name": "competitor_aeo_benchmark",
"description": "Compares how often AI models mention the client versus competitors for the same prompts. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"competitors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Competitor names or domains."
}
}
},
"annotations": {
"title": "AI visibility benchmark",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Works out where a campaign loses lead quality and what to change, from the numbers and complaints supplied. Takes up to a minute. Amounts are in the ad account's own currency, in whole units (not cents or micros). AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| cpa | number | Actual cost per lead. |
| ctr | number | CTR in percent. |
| spend | number | Spend over the period. |
| clicks | integer | Clicks over the period. |
| platform * | string | one of ["google","meta","tiktok","linkedin","microsoft"] |
| client_id | integer | Client id; when given, the result is saved as a report. |
| target_cpa | number | Target cost per lead. |
| conversions | integer | Conversions over the period. |
| campaign_name * | string | Campaign name. |
| lead_complaints | string | What is wrong with the leads, in the client's words. |
Shows which Meta instant-form leads of a client would be imported. Read-only.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| lookback_hours | integer | How far back to look. |
{
"name": "leads_meta_ingest_check",
"description": "Shows which Meta instant-form leads of a client would be imported. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"lookback_hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1,
"description": "How far back to look."
}
}
},
"annotations": {
"title": "Check Meta leads waiting",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Scheduled and published social posts of a client.
| Parameter | Type | Description |
|---|---|---|
| status | string | Only records in this status. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id * | integer |
{
"name": "social_calendar",
"description": "Scheduled and published social posts of a client.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"status": {
"enum": [
"draft",
"scheduled",
"published",
"failed"
],
"type": "string",
"description": "Only records in this status."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Social content calendar",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Keyword clusters, audience pain points, pre-purchase questions and competitor analysis for a client's site. Takes minutes. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| max_parallel | integer | Sites read in parallel, 1-8. |
| competitor_urls | array | Competitor domains without scheme. |
{
"name": "seo_research",
"description": "Keyword clusters, audience pain points, pre-purchase questions and competitor analysis for a client's site. Takes minutes. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"max_parallel": {
"type": "integer",
"default": 4,
"description": "Sites read in parallel, 1-8."
},
"competitor_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Competitor domains without scheme."
}
}
},
"annotations": {
"title": "SEO research",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Position changes over 7-30 days: winners, drops and keywords in positions 11-30.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| client_id * | integer |
{
"name": "seo_rank_changes",
"description": "Position changes over 7-30 days: winners, drops and keywords in positions 11-30.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"days": {
"type": "integer",
"default": 7,
"description": "Look-back days."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Keyword rank changes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A content brief for one keyword: headings, meta tags, structure, related terms, length. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country: SK. |
| url | string | https:// page URL. |
| keyword * | string | Target search query. |
| language | string | en, sk |
| client_id | integer |
{
"name": "seo_brief_generate",
"description": "A content brief for one keyword: headings, meta tags, structure, related terms, length. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"keyword"
],
"properties": {
"geo": {
"type": "string",
"description": "Country: SK."
},
"url": {
"type": "string",
"description": "https:// page URL."
},
"keyword": {
"type": "string",
"description": "Target search query."
},
"language": {
"type": "string",
"description": "en, sk"
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Generate an SEO brief",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A site's Google position for one keyword with the matched URL, SERP features and the top ten.
| Parameter | Type | Description |
|---|---|---|
| gl | string | Country code of the search. |
| hl | string | Interface language of the search. |
| domain * | string | Domain without scheme. |
| keyword * | string | Target search query. |
{
"name": "seo_keyword_rank_check",
"description": "A site's Google position for one keyword with the matched URL, SERP features and the top ten.",
"inputSchema": {
"type": "object",
"required": [
"keyword",
"domain"
],
"properties": {
"gl": {
"type": "string",
"description": "Country code of the search."
},
"hl": {
"type": "string",
"description": "Interface language of the search."
},
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"keyword": {
"type": "string",
"description": "Target search query."
}
}
},
"annotations": {
"title": "Check a keyword position",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Keyword clusters with intent, priority and AI-citation potential for a topic. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| topic * | string | Topic, product or service. |
| language | string | Language code, e.g. en. |
| client_id | integer | |
| seed_keywords | string | Seed keywords, comma-separated. |
{
"name": "seo_keyword_research",
"description": "Keyword clusters with intent, priority and AI-citation potential for a topic. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"topic"
],
"properties": {
"geo": {
"type": "string",
"description": "Country code, e.g. us or de."
},
"topic": {
"type": "string",
"description": "Topic, product or service."
},
"language": {
"type": "string",
"description": "Language code, e.g. en."
},
"client_id": {
"type": "integer"
},
"seed_keywords": {
"type": "string",
"description": "Seed keywords, comma-separated."
}
}
},
"annotations": {
"title": "Keyword research",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Topics competitors cover and this site does not, with an action plan. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country: SK. |
| niche | string | Business niche or industry, in plain words. |
| domain | string | Domain without scheme. |
| client_id | integer | |
| competitors | string | Competitor domains, comma-separated. |
{
"name": "seo_content_gap",
"description": "Topics competitors cover and this site does not, with an action plan. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"properties": {
"geo": {
"type": "string",
"description": "Country: SK."
},
"niche": {
"type": "string",
"description": "Business niche or industry, in plain words."
},
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"client_id": {
"type": "integer"
},
"competitors": {
"type": "string",
"description": "Competitor domains, comma-separated."
}
}
},
"annotations": {
"title": "Content gap analysis",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}An SEO and AI-visibility report for a client or domain. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| domain | string | Domain without scheme. |
| period | string | weekly, monthly or quarterly. |
| client_id | integer | |
| report_type | string | executive, marketing, technical or client. |
{
"name": "seo_performance_report",
"description": "An SEO and AI-visibility report for a client or domain. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"period": {
"enum": [
"weekly",
"monthly",
"quarterly"
],
"type": "string",
"default": "monthly",
"description": "weekly, monthly or quarterly."
},
"client_id": {
"type": "integer"
},
"report_type": {
"enum": [
"executive",
"marketing",
"technical",
"client"
],
"type": "string",
"default": "marketing",
"description": "executive, marketing, technical or client."
}
}
},
"annotations": {
"title": "SEO performance report",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Backlink profile quality, toxic links and link-building opportunities. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain without scheme. |
| client_id | integer | |
| competitors | string | Competitor domains, comma-separated. |
{
"name": "seo_backlink_analysis",
"description": "Backlink profile quality, toxic links and link-building opportunities. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"client_id": {
"type": "integer"
},
"competitors": {
"type": "string",
"description": "Competitor domains, comma-separated."
}
}
},
"annotations": {
"title": "Backlink analysis",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Competitors' search presence, content strategy, links and AI visibility, with gaps and opportunities. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country: SK. |
| niche | string | Business niche or industry, in plain words. |
| domain | string | Domain without scheme. |
| client_id | integer | |
| competitors * | string | Up to three competitor domains, comma-separated. |
{
"name": "seo_competitor_analysis",
"description": "Competitors' search presence, content strategy, links and AI visibility, with gaps and opportunities. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"competitors"
],
"properties": {
"geo": {
"type": "string",
"description": "Country: SK."
},
"niche": {
"type": "string",
"description": "Business niche or industry, in plain words."
},
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"client_id": {
"type": "integer"
},
"competitors": {
"type": "string",
"description": "Up to three competitor domains, comma-separated."
}
}
},
"annotations": {
"title": "SEO competitor analysis",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}What ranks for a query and why: content types, featured snippets, AI overviews, People Also Ask. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| keyword * | string | Target search query. |
| language | string | Language code, e.g. en. |
| client_id | integer |
{
"name": "seo_serp_analysis",
"description": "What ranks for a query and why: content types, featured snippets, AI overviews, People Also Ask. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"keyword"
],
"properties": {
"geo": {
"type": "string",
"default": "ua",
"description": "Country code, e.g. us or de."
},
"keyword": {
"type": "string",
"description": "Target search query."
},
"language": {
"type": "string",
"default": "ru",
"description": "Language code, e.g. en."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "SERP analysis",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Core Web Vitals, crawlability, indexability, structured data, redirects, canonicals, mobile, HTTPS, robots.txt and sitemap. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| url * | string | https:// page URL. |
| depth | string | quick, standard or deep. |
| client_id | integer |
{
"name": "seo_technical_audit",
"description": "Core Web Vitals, crawlability, indexability, structured data, redirects, canonicals, mobile, HTTPS, robots.txt and sitemap. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"depth": {
"enum": [
"quick",
"standard",
"deep"
],
"type": "string",
"default": "standard",
"description": "quick, standard or deep."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Technical SEO audit",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One page audited across title, meta description, headings, content, keywords, internal links, images and technical basics. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| url * | string | https:// page URL. |
| keyword | string | Target search query. |
| client_id | integer |
{
"name": "seo_on_page_audit",
"description": "One page audited across title, meta description, headings, content, keywords, internal links, images and technical basics. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"keyword": {
"type": "string",
"description": "Target search query."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "On-page SEO audit",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Orphan and weakly linked pages with the internal links to add. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain without scheme. |
| client_id | integer | |
| key_pages | string | Key pages, comma-separated. |
{
"name": "seo_internal_links_audit",
"description": "Orphan and weakly linked pages with the internal links to add. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"client_id": {
"type": "integer"
},
"key_pages": {
"type": "string",
"description": "Key pages, comma-separated."
}
}
},
"annotations": {
"title": "Internal links audit",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}An 80-criteria content quality audit (clarity, organisation, referenceability, experience, expertise, authority, trust) for a URL or a text. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| url | string | https:// page URL. |
| content | string | The text, when there is no URL. |
| client_id | integer | |
| content_type | string | Type of content, for weighting. |
{
"name": "seo_content_quality_audit",
"description": "An 80-criteria content quality audit (clarity, organisation, referenceability, experience, expertise, authority, trust) for a URL or a text. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"content": {
"type": "string",
"description": "The text, when there is no URL."
},
"client_id": {
"type": "integer"
},
"content_type": {
"enum": [
"blog_post",
"landing_page",
"product_page",
"faq",
"guide"
],
"type": "string",
"default": "blog_post",
"description": "Type of content, for weighting."
}
}
},
"annotations": {
"title": "Content quality audit",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}A 40-criteria audit of domain authority: citation, identity, trust and eminence. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain without scheme. |
| client_id | integer | |
| site_type | string | Type of site, for weighting. |
{
"name": "seo_domain_authority_audit",
"description": "A 40-criteria audit of domain authority: citation, identity, trust and eminence. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"client_id": {
"type": "integer"
},
"site_type": {
"enum": [
"ecommerce",
"content_publisher",
"saas",
"authority",
"local_business"
],
"type": "string",
"default": "saas",
"description": "Type of site, for weighting."
}
}
},
"annotations": {
"title": "Domain authority audit",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}How well a brand is established as an entity for Google's Knowledge Graph and AI systems, with a plan to build it. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| domain | string | Domain without scheme. |
| industry | string | Industry or niche. |
| client_id | integer | |
| brand_name * | string | Brand or company name. |
{
"name": "seo_entity_audit",
"description": "How well a brand is established as an entity for Google's Knowledge Graph and AI systems, with a plan to build it. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"brand_name"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"industry": {
"type": "string",
"description": "Industry or niche."
},
"client_id": {
"type": "integer"
},
"brand_name": {
"type": "string",
"description": "Brand or company name."
}
}
},
"annotations": {
"title": "Brand entity audit",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Rewrites guidance for a page or text so AI answers can quote it: definition blocks, quotable statements, FAQ. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| url | string | https:// page URL. |
| content | string | The text, when there is no URL. |
| keyword | string | Target search query. |
| client_id | integer |
{
"name": "seo_ai_citation_optimize",
"description": "Rewrites guidance for a page or text so AI answers can quote it: definition blocks, quotable statements, FAQ. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"content": {
"type": "string",
"description": "The text, when there is no URL."
},
"keyword": {
"type": "string",
"description": "Target search query."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Optimise for AI citation",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}How often AI models mention a client's brand for the queries of its niche: a 0-100 score, a per-model breakdown and the quotes. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| competitors | array | Competitor names or domains. |
{
"name": "aeo_visibility_scan",
"description": "How often AI models mention a client's brand for the queries of its niche: a 0-100 score, a per-model breakdown and the quotes. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"competitors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Competitor names or domains."
}
}
},
"annotations": {
"title": "AI visibility scan",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Fresh discussions where people ask for recommendations in a client's niche, with a suggested reply. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| client_id * | integer |
{
"name": "aeo_mention_opportunities",
"description": "Fresh discussions where people ask for recommendations in a client's niche, with a suggested reply. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"description": "Max records."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Find mention opportunities",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}New Reddit threads mentioning a client's brand, keywords or competitors, with sentiment and a draft reply. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "reddit_mentions_monitor",
"description": "New Reddit threads mentioning a client's brand, keywords or competitors, with sentiment and a draft reply. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Monitor Reddit mentions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Buyer-intent Reddit threads in a client's niche, ranked.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer |
{
"name": "reddit_opportunities",
"description": "Buyer-intent Reddit threads in a client's niche, ranked.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Find Reddit opportunities",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}For one page: relevant subreddits, two post drafts and the best time to post. A plan only; nothing is posted. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| content_url * | string | The page to promote. |
{
"name": "reddit_amplification_plan",
"description": "For one page: relevant subreddits, two post drafts and the best time to post. A plan only; nothing is posted. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"content_url"
],
"properties": {
"client_id": {
"type": "integer"
},
"content_url": {
"type": "string",
"description": "The page to promote."
}
}
},
"annotations": {
"title": "Plan Reddit promotion",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Warn N days before an ad account runs out of money, for one client or all clients. Use it for requests like 'warn me two days before the balance runs out'. Without client and scope it returns a question listing the clients; ask the user which one.
| Parameter | Type | Description |
|---|---|---|
| days | number | Days of balance left when the warning fires, 0.5 to 30. |
| reset | boolean | true removes the setting and restores the default thresholds. |
| scope | string | client (one client) or all (every client of the workspace). |
| client_id | integer | |
| client_name | string | Client name or part of it, when scope is client. |
{
"name": "balance_alert_lead_time_set",
"description": "Warn N days before an ad account runs out of money, for one client or all clients. Use it for requests like 'warn me two days before the balance runs out'. Without client and scope it returns a question listing the clients; ask the user which one.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "Days of balance left when the warning fires, 0.5 to 30."
},
"reset": {
"type": "boolean",
"description": "true removes the setting and restores the default thresholds."
},
"scope": {
"enum": [
"client",
"all"
],
"type": "string",
"description": "client (one client) or all (every client of the workspace)."
},
"client_id": {
"type": "integer"
},
"client_name": {
"type": "string",
"description": "Client name or part of it, when scope is client."
}
}
},
"annotations": {
"title": "Set low-balance alert lead time",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}The key owner's own alert delivery: only critical alerts, a daily or weekly digest instead of every signal, mute one alert type, turn a channel off. Pass only what the user asked for. Quiet hours by clock time do not exist: set quiet_hours_requested and relay the question it returns. Called with nothing, it returns a question listing the options.
| Parameter | Type | Description |
|---|---|---|
| mute_types | array | Alert types to turn off: budget, cpa, ctr, roas, zero_conversions, overdue_reports, stale_campaigns. |
| digest_hour | integer | Hour of the daily digest, 0 to 23 UTC. |
| digest_mode | string | realtime, daily or weekly. |
| unmute_types | array | Alert types to turn back on. |
| channel_email | boolean | |
| critical_only | boolean | true to receive only critical alerts. |
| channel_browser | boolean | |
| channel_telegram | boolean | |
| quiet_hours_requested | boolean | true when the user asks for quiet hours or do-not-disturb by time of day. |
| confirm_all_channels_off | boolean |
Which alerts reach the key owner now: severity filter, digest mode, muted types and channels.
No parameters.
{
"name": "notification_preferences_get",
"description": "Which alerts reach the key owner now: severity filter, digest mode, muted types and channels.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "My notification preferences",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}How many days before the money runs out the low-balance warning fires, per client, and where the value comes from (client, workspace or default).
| Parameter | Type | Description |
|---|---|---|
| client_id | integer | |
| client_name | string | Client name or part of it. |
{
"name": "balance_alert_lead_time_get",
"description": "How many days before the money runs out the low-balance warning fires, per client, and where the value comes from (client, workspace or default).",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
},
"client_name": {
"type": "string",
"description": "Client name or part of it."
}
}
},
"annotations": {
"title": "Low-balance alert lead time",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Create a task for the team in ADS Beast.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Short title. |
| category | string | Free-form category. |
| due_date | string | Due date, YYYY-MM-DD. |
| priority * | string | low, medium, high or urgent. |
| client_id | integer | |
| description | string | What has to be done. |
{
"name": "task_create",
"description": "Create a task for the team in ADS Beast.",
"inputSchema": {
"type": "object",
"required": [
"title",
"priority"
],
"properties": {
"title": {
"type": "string",
"description": "Short title."
},
"category": {
"type": "string",
"description": "Free-form category."
},
"due_date": {
"type": "string",
"description": "Due date, YYYY-MM-DD."
},
"priority": {
"enum": [
"low",
"medium",
"high",
"urgent"
],
"type": "string",
"description": "low, medium, high or urgent."
},
"client_id": {
"type": "integer"
},
"description": {
"type": "string",
"description": "What has to be done."
}
}
},
"annotations": {
"title": "Create a task",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Scans clients for unanswered critical alerts, KPI goals at risk, campaigns without metrics and projected overspend, and creates tasks for the team. dry_run=true only lists what it found.
| Parameter | Type | Description |
|---|---|---|
| dry_run | boolean | true only validates; nothing is written. |
| client_id | integer |
{
"name": "task_suggest",
"description": "Scans clients for unanswered critical alerts, KPI goals at risk, campaigns without metrics and projected overspend, and creates tasks for the team. dry_run=true only lists what it found.",
"inputSchema": {
"type": "object",
"properties": {
"dry_run": {
"type": "boolean",
"default": false,
"description": "true only validates; nothing is written."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Suggest tasks from problems",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Save a report for a client. With content: stores that text (Markdown). Without content: generates a 30-day campaign summary. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| title | string | Short title. |
| content | string | Full report text in Markdown. |
| client_id * | integer |
{
"name": "report_create",
"description": "Save a report for a client. With content: stores that text (Markdown). Without content: generates a 30-day campaign summary. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"title": {
"type": "string",
"description": "Short title."
},
"content": {
"type": "string",
"description": "Full report text in Markdown."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Create a report",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Record a recommendation so ADS Beast checks in seven days whether it worked.
| Parameter | Type | Description |
|---|---|---|
| action * | string | What was recommended. |
| metric * | string | The metric expected to improve. |
| client_id | integer | |
| reasoning | string | Why it should work. |
| campaign_id | integer | ADS Beast id from list_campaigns, not the platform's. |
| target_value | number | Its expected value afterwards. |
| current_value | number | Its value now. |
{
"name": "recommendation_save",
"description": "Record a recommendation so ADS Beast checks in seven days whether it worked.",
"inputSchema": {
"type": "object",
"required": [
"action",
"metric"
],
"properties": {
"action": {
"type": "string",
"description": "What was recommended."
},
"metric": {
"enum": [
"cpa",
"ctr",
"roas",
"cpc",
"conversions",
"spend"
],
"type": "string",
"description": "The metric expected to improve."
},
"client_id": {
"type": "integer"
},
"reasoning": {
"type": "string",
"description": "Why it should work."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
},
"target_value": {
"type": "number",
"description": "Its expected value afterwards."
},
"current_value": {
"type": "number",
"description": "Its value now."
}
}
},
"annotations": {
"title": "Save a recommendation",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Register an A/B test in ADS Beast to track its hypothesis and variants. It records the test; it does not change ads.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Name shown in the interface. |
| client_id | integer | |
| hypothesis * | string | If X then Y changes by Z, because... |
| campaign_id | integer | ADS Beast id from list_campaigns, not the platform's. |
| what_tested * | string | What differs between the variants. |
| variant_a_name * | string | Control variant. |
| variant_b_name * | string | Test variant. |
| variant_a_description | string | Control variant in detail. |
| variant_b_description | string | Test variant in detail. |
Generate ad variants (headlines, texts, calls to action) for a client and save them as drafts. Takes up to a minute. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| tone | string | Tone of voice. |
| count | integer | Number of variants. |
| ad_type | string | search, display, video, stories or feed. |
| platform * | string | one of ["google","meta","tiktok","linkedin"] |
| client_id * | integer |
{
"name": "creative_copy_generate",
"description": "Generate ad variants (headlines, texts, calls to action) for a client and save them as drafts. Takes up to a minute. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform"
],
"properties": {
"tone": {
"type": "string",
"default": "professional",
"description": "Tone of voice."
},
"count": {
"type": "integer",
"default": 3,
"description": "Number of variants."
},
"ad_type": {
"enum": [
"search",
"display",
"video",
"stories",
"feed"
],
"type": "string",
"default": "feed",
"description": "search, display, video, stories or feed."
},
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin"
],
"type": "string"
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Generate ad copy",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Checks Meta and TikTok campaigns for tired creatives now and files an alert and a change proposal for each one found. Proposals wait for a person.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer | |
| campaign_id | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "creative_fatigue_check",
"description": "Checks Meta and TikTok campaigns for tired creatives now and files an alert and a change proposal for each one found. Proposals wait for a person.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "integer"
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "Run a creative fatigue check",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Writes an SEO article for a keyword and saves it as a draft. Nothing is published. Takes up to a minute. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| keyword * | string | Target search query. |
| client_id * | integer | |
| word_count | integer | Target length in words. |
{
"name": "seo_article_generate",
"description": "Writes an SEO article for a keyword and saves it as a draft. Nothing is published. Takes up to a minute. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"keyword",
"client_id"
],
"properties": {
"keyword": {
"type": "string",
"description": "Target search query."
},
"client_id": {
"type": "integer"
},
"word_count": {
"type": "integer",
"default": 800,
"description": "Target length in words."
}
}
},
"annotations": {
"title": "Generate an SEO article draft",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Writes search- and AI-citation-ready content on a topic and saves it as a draft. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| topic * | string | Topic, product or service. |
| client_id | integer | |
| word_count | integer | Target length in words. |
| content_type | string | blog_post, landing_page, guide, faq_page or case_study. |
{
"name": "seo_content_write",
"description": "Writes search- and AI-citation-ready content on a topic and saves it as a draft. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"topic"
],
"properties": {
"geo": {
"type": "string",
"description": "Country code, e.g. us or de."
},
"topic": {
"type": "string",
"description": "Topic, product or service."
},
"client_id": {
"type": "integer"
},
"word_count": {
"type": "integer",
"default": 1200,
"description": "Target length in words."
},
"content_type": {
"enum": [
"blog_post",
"landing_page",
"guide",
"faq_page",
"case_study"
],
"type": "string",
"default": "blog_post",
"description": "blog_post, landing_page, guide, faq_page or case_study."
}
}
},
"annotations": {
"title": "Write SEO content",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Returns improved title, meta description, Open Graph and Twitter Card tags for a page and stores the suggestion. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| url * | string | https:// page URL. |
| keyword | string | Target search query. |
| client_id | integer | |
| brand_name | string | Brand or company name. |
| content_summary | string | What the page is about. |
{
"name": "seo_meta_tags_optimize",
"description": "Returns improved title, meta description, Open Graph and Twitter Card tags for a page and stores the suggestion. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"keyword": {
"type": "string",
"description": "Target search query."
},
"client_id": {
"type": "integer"
},
"brand_name": {
"type": "string",
"description": "Brand or company name."
},
"content_summary": {
"type": "string",
"description": "What the page is about."
}
}
},
"annotations": {
"title": "Optimise meta tags",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Schema.org JSON-LD for a page (FAQ, HowTo, Article, Product, LocalBusiness, Organization), stored as a suggestion. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| url | string | https:// page URL. |
| content | string | What the page contains. |
| client_id | integer | |
| brand_name | string | Brand or company name. |
| schema_type | string | auto picks the type. |
{
"name": "seo_schema_generate",
"description": "Schema.org JSON-LD for a page (FAQ, HowTo, Article, Product, LocalBusiness, Organization), stored as a suggestion. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"content": {
"type": "string",
"description": "What the page contains."
},
"client_id": {
"type": "integer"
},
"brand_name": {
"type": "string",
"description": "Brand or company name."
},
"schema_type": {
"enum": [
"auto",
"FAQPage",
"HowTo",
"Article",
"Product",
"LocalBusiness",
"Organization"
],
"type": "string",
"default": "auto",
"description": "auto picks the type."
}
}
},
"annotations": {
"title": "Generate schema markup",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Positions, technical state and a prioritised task list for a client's site; the tasks are saved in ADS Beast.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| website_url | string | Site URL; the client's own site by default. |
{
"name": "seo_site_check",
"description": "Positions, technical state and a prioritised task list for a client's site; the tasks are saved in ADS Beast.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"website_url": {
"type": "string",
"description": "Site URL; the client's own site by default."
}
}
},
"annotations": {
"title": "Run a site SEO check",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Checks positions now, records them and reports changes and quick wins. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| domain | string | Domain without scheme. |
| keywords | string | Keywords, comma-separated; the stored list by default. |
| client_id | integer |
{
"name": "seo_keywords_track",
"description": "Checks positions now, records them and reports changes and quick wins. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"properties": {
"geo": {
"type": "string",
"default": "ua",
"description": "Country code, e.g. us or de."
},
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"keywords": {
"type": "string",
"description": "Keywords, comma-separated; the stored list by default."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Track keyword positions",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Set alert thresholds for traffic, positions, backlinks, Core Web Vitals and AI visibility of a domain. AI: 1 AI request. May return a job_id (get_job_result).
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain without scheme. |
| client_id | integer | |
| key_keywords | string | Keywords to watch, comma-separated. |
| baseline_traffic | integer | Current monthly traffic. |
| notification_channel | string | Where alerts go. |
{
"name": "seo_alerts_configure",
"description": "Set alert thresholds for traffic, positions, backlinks, Core Web Vitals and AI visibility of a domain. AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"client_id": {
"type": "integer"
},
"key_keywords": {
"type": "string",
"description": "Keywords to watch, comma-separated."
},
"baseline_traffic": {
"type": "integer",
"description": "Current monthly traffic."
},
"notification_channel": {
"enum": [
"email",
"telegram",
"slack",
"in_app"
],
"type": "string",
"default": "in_app",
"description": "Where alerts go."
}
}
},
"annotations": {
"title": "Configure SEO alerts",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Reformats a client's page for citation by AI models (Q&A version, FAQ blocks, JSON-LD) and saves the recommendations. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| page_url * | string | The page to optimise. |
| client_id * | integer | |
| focus_query | string | The AI query to win. |
{
"name": "aeo_content_optimize",
"description": "Reformats a client's page for citation by AI models (Q&A version, FAQ blocks, JSON-LD) and saves the recommendations. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"page_url",
"client_id"
],
"properties": {
"page_url": {
"type": "string",
"description": "The page to optimise."
},
"client_id": {
"type": "integer"
},
"focus_query": {
"type": "string",
"description": "The AI query to win."
}
}
},
"annotations": {
"title": "Optimise a page for AI answers",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Drafts a reply to a Reddit thread and saves it as a task for a person to review and post. Nothing is posted. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| client_id | integer | |
| thread_url * | string | Reddit thread URL. |
| brand_angle * | string | How the brand should be mentioned. |
{
"name": "reddit_reply_draft",
"description": "Drafts a reply to a Reddit thread and saves it as a task for a person to review and post. Nothing is posted. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"thread_url",
"brand_angle"
],
"properties": {
"client_id": {
"type": "integer"
},
"thread_url": {
"type": "string",
"description": "Reddit thread URL."
},
"brand_angle": {
"type": "string",
"description": "How the brand should be mentioned."
}
}
},
"annotations": {
"title": "Draft a Reddit reply",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Ask for a multi-agent market simulation for a client. It is queued as a request a person confirms, because it costs model usage.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| requirement * | string | What to simulate. |
{
"name": "client_market_simulation_request",
"description": "Ask for a multi-agent market simulation for a client. It is queued as a request a person confirms, because it costs model usage.",
"inputSchema": {
"type": "object",
"required": [
"requirement",
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"requirement": {
"type": "string",
"description": "What to simulate."
}
}
},
"annotations": {
"title": "Request a market simulation",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Builds a ready-to-submit Telegram ad within the 160-character limit with bid, budget and an impressions estimate, and reports whether it passes preflight. Amounts are in the Telegram account currency.
| Parameter | Type | Description |
|---|---|---|
| cpm | number | CPM bid in the account currency. |
| text * | string | Ad text. |
| title | string | Short title. |
| budget | number | Budget in the account currency. |
| button | string | Button for a website ad. |
| currency | string | EUR, TON or XTR. |
| client_id | integer | |
| placement | string | channel_post, bot_banner, search_result or video_banner. |
| autoshorten | boolean | Cut the text at a word boundary when it is too long. |
| promote_url | string | @username, t.me link, bot or website. |
| website_name | string | Site name for an external link. |
Creates a task for an operator to paste a checked ad into ads.telegram.org by hand. The path for accounts without an API token.
| Parameter | Type | Description |
|---|---|---|
| cpm | number | CPM bid in the account currency. |
| text * | string | Ad text. |
| title | string | Short title. |
| budget | number | Budget in the account currency. |
| currency | string | EUR, TON or XTR. |
| client_id | integer | |
| promote_url * | string | @username, t.me link, bot or website. |
| website_name | string | Site name for an external link. |
| campaign_name * | string | Campaign name. |
{
"name": "telegram_ads_publish_task",
"description": "Creates a task for an operator to paste a checked ad into ads.telegram.org by hand. The path for accounts without an API token.",
"inputSchema": {
"type": "object",
"required": [
"campaign_name",
"text",
"promote_url"
],
"properties": {
"cpm": {
"type": "number",
"description": "CPM bid in the account currency."
},
"text": {
"type": "string",
"description": "Ad text."
},
"title": {
"type": "string",
"description": "Short title."
},
"budget": {
"type": "number",
"description": "Budget in the account currency."
},
"currency": {
"type": "string",
"description": "EUR, TON or XTR."
},
"client_id": {
"type": "integer"
},
"promote_url": {
"type": "string",
"description": "@username, t.me link, bot or website."
},
"website_name": {
"type": "string",
"description": "Site name for an external link."
},
"campaign_name": {
"type": "string",
"description": "Campaign name."
}
}
},
"annotations": {
"title": "Queue a Telegram ad for manual publishing",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Builds intent clusters and ad texts within the platform limits from a business description and returns them for review. Nothing is published. Takes up to a minute. AI: 1 AI request.
| Parameter | Type | Description |
|---|---|---|
| geo | string | Where the ads should show. |
| url | string | Landing page. |
| business * | string | What the business does, its offer and for whom. |
| clusters | integer | Number of clusters, 1-8. |
| language | string | Language code, e.g. en. |
| client_id | integer | |
| ads_per_cluster | integer | Ads per cluster, 1-5. |
{
"name": "chatgpt_ads_draft_generate",
"description": "Builds intent clusters and ad texts within the platform limits from a business description and returns them for review. Nothing is published. Takes up to a minute. AI: 1 AI request.",
"inputSchema": {
"type": "object",
"required": [
"business"
],
"properties": {
"geo": {
"type": "string",
"description": "Where the ads should show."
},
"url": {
"type": "string",
"description": "Landing page."
},
"business": {
"type": "string",
"description": "What the business does, its offer and for whom."
},
"clusters": {
"type": "integer",
"description": "Number of clusters, 1-8."
},
"language": {
"type": "string",
"description": "Language code, e.g. en."
},
"client_id": {
"type": "integer"
},
"ads_per_cluster": {
"type": "integer",
"description": "Ads per cluster, 1-5."
}
}
},
"annotations": {
"title": "Draft a ChatGPT Ads campaign",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Low-level edit of a campaign draft before publishing: merge targeting keys, update ads, replace ad groups, rename, change goal, budget or UTM. Nothing is sent to the platform. Amounts are in the ad account's own currency, in whole units (not cents or micros).
| Parameter | Type | Description |
|---|---|---|
| name | string | Name shown in the interface. |
| build_id * | integer | Draft id from list_campaign_drafts. |
| ad_groups | array | Full replacement of the ad groups. |
| client_id * | integer | |
| objective | string | Campaign goal. |
| targeting | object | Targeting keys to merge; a null value removes the key. |
| ad_updates | array | Ad edits. |
| utm_params | object | UTM parameters. |
| budget_type | string | daily or monthly. |
| budget_amount | number | Budget in the account currency, whole units. |
Asks ChatGPT Ads for the review status of a campaign's ads and stores it in ADS Beast. Nothing is enabled: a campaign with no approved ad must stay off.
| Parameter | Type | Description |
|---|---|---|
| chatgpt_campaign_id * | integer | ADS Beast id of the ChatGPT Ads campaign, from chatgpt_ads_status. |
{
"name": "chatgpt_ads_review_sync",
"description": "Asks ChatGPT Ads for the review status of a campaign's ads and stores it in ADS Beast. Nothing is enabled: a campaign with no approved ad must stay off.",
"inputSchema": {
"type": "object",
"required": [
"chatgpt_campaign_id"
],
"properties": {
"chatgpt_campaign_id": {
"type": "integer",
"description": "ADS Beast id of the ChatGPT Ads campaign, from chatgpt_ads_status."
}
}
},
"annotations": {
"title": "Refresh ChatGPT Ads review status",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Pulls a client's Meta instant-form leads into ADS Beast now (scored, de-duplicated, forwarded to the client's webhooks). Idempotent.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | |
| lookback_hours | integer | How far back to look. |
{
"name": "leads_meta_ingest",
"description": "Pulls a client's Meta instant-form leads into ADS Beast now (scored, de-duplicated, forwarded to the client's webhooks). Idempotent.",
"inputSchema": {
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"lookback_hours": {
"type": "integer",
"default": 24,
"maximum": 168,
"minimum": 1,
"description": "How far back to look."
}
}
},
"annotations": {
"title": "Import Meta leads now",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare pausing one campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "prepare_campaign_pause",
"description": "Prepare pausing one campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "Prepare pausing a campaign",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare switching one paused campaign back on. Enabling always waits for a person, whatever the client's write policy. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"name": "prepare_campaign_enable",
"description": "Prepare switching one paused campaign back on. Enabling always waits for a person, whatever the client's write policy. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
},
"annotations": {
"title": "Prepare enabling a campaign",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare a new monthly budget for one campaign, in whole units of the account currency (3000 = 3000.00, never cents or micros); the preview shows the daily amount and the figure the platform receives. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| currency | string | ISO code of the currency you believe the account uses, for example EUR. Optional safety check: the call is refused when it differs from the account's currency. |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
| new_monthly_budget * | number | New monthly budget in the ad account's currency, whole units. 3000 means 3000.00 of that currency. |
{
"name": "prepare_campaign_budget_change",
"description": "Prepare a new monthly budget for one campaign, in whole units of the account currency (3000 = 3000.00, never cents or micros); the preview shows the daily amount and the figure the platform receives. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"new_monthly_budget",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"currency": {
"type": "string",
"description": "ISO code of the currency you believe the account uses, for example EUR. Optional safety check: the call is refused when it differs from the account's currency."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
},
"new_monthly_budget": {
"type": "number",
"description": "New monthly budget in the ad account's currency, whole units. 3000 means 3000.00 of that currency.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Prepare a budget change",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare negative keywords for a client's Google Ads: a shared list on the named campaigns, or on every enabled Search, Shopping and Display campaign. Nothing is left behind if it attaches nowhere. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| keywords * | array | Negative keywords to add, one phrase per item, at most 50 (the executor's cap). |
| client_id * | integer | |
| list_name | string | Name of the shared negative list; a dated name is used by default. |
| campaign_ids | array | ADS Beast ids of the Google campaigns to attach the list to; omit for every enabled Search, Shopping and Display campaign. |
{
"name": "prepare_negative_keywords_add",
"description": "Prepare negative keywords for a client's Google Ads: a shared list on the named campaigns, or on every enabled Search, Shopping and Display campaign. Nothing is left behind if it attaches nowhere. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"keywords",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"description": "Negative keywords to add, one phrase per item, at most 50 (the executor's cap)."
},
"client_id": {
"type": "integer"
},
"list_name": {
"type": "string",
"description": "Name of the shared negative list; a dated name is used by default."
},
"campaign_ids": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 50,
"description": "ADS Beast ids of the Google campaigns to attach the list to; omit for every enabled Search, Shopping and Display campaign."
}
}
},
"annotations": {
"title": "Prepare adding negative keywords",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare creating a full Google Ads or Meta campaign from a draft, PAUSED: it spends nothing until a person enables it. The preview carries the rehearsal against the live account. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| build_id * | integer | Draft id from list_campaign_drafts. |
| client_id * | integer | |
| platform_campaign_id | string | Existing platform campaign to complete instead of creating a new one. |
{
"name": "prepare_campaign_draft_publish",
"description": "Prepare creating a full Google Ads or Meta campaign from a draft, PAUSED: it spends nothing until a person enables it. The preview carries the rehearsal against the live account. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"build_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"build_id": {
"type": "integer",
"description": "Draft id from list_campaign_drafts."
},
"client_id": {
"type": "integer"
},
"platform_campaign_id": {
"type": "string",
"description": "Existing platform campaign to complete instead of creating a new one."
}
}
},
"annotations": {
"title": "Prepare publishing a campaign draft",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare a new ad inside an existing campaign: a responsive search ad on Google (headlines, descriptions, final_url) or a single-image ad on Meta (headline, body). Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| body | string | Meta: primary text, up to 125 characters. |
| name * | string | Name shown in the interface. |
| reason * | string | Why, with numbers (shown to the approver). |
| headline | string | Meta: headline, up to 40 characters. |
| final_url | string | Landing page URL. |
| headlines | array | Google: 3-15 headlines, 30 characters each. |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
| descriptions | array | Google: 2-4 descriptions, 90 characters each. |
{
"name": "prepare_ad_create",
"description": "Prepare a new ad inside an existing campaign: a responsive search ad on Google (headlines, descriptions, final_url) or a single-image ad on Meta (headline, body). Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"name",
"reason"
],
"properties": {
"body": {
"type": "string",
"description": "Meta: primary text, up to 125 characters."
},
"name": {
"type": "string",
"description": "Name shown in the interface."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"headline": {
"type": "string",
"description": "Meta: headline, up to 40 characters."
},
"final_url": {
"type": "string",
"description": "Landing page URL."
},
"headlines": {
"type": "array",
"items": {
"type": "string"
},
"description": "Google: 3-15 headlines, 30 characters each."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
},
"descriptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Google: 2-4 descriptions, 90 characters each."
}
}
},
"annotations": {
"title": "Prepare creating an ad",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare a PAUSED ad set in a Meta campaign. daily_budget in whole account-currency units (20 = 20.00); the preview shows what Meta gets. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Ad set name. |
| reason * | string | Why, with numbers (shown to the approver). |
| targeting * | object | Meta targeting spec: geo_locations, age_min, age_max, genders, locales, interests or flexible_spec, custom audiences, plus audience_rationale. |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
| daily_budget * | number | Daily budget in the ad account's currency, whole units. |
| optimization_goal | string | What Meta optimises the ad set for. |
{
"name": "prepare_meta_ad_set_create",
"description": "Prepare a PAUSED ad set in a Meta campaign. daily_budget in whole account-currency units (20 = 20.00); the preview shows what Meta gets. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"name",
"daily_budget",
"targeting",
"reason"
],
"properties": {
"name": {
"type": "string",
"description": "Ad set name."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"targeting": {
"type": "object",
"description": "Meta targeting spec: geo_locations, age_min, age_max, genders, locales, interests or flexible_spec, custom audiences, plus audience_rationale."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
},
"daily_budget": {
"type": "number",
"description": "Daily budget in the ad account's currency, whole units."
},
"optimization_goal": {
"enum": [
"LEAD_GENERATION",
"LINK_CLICKS",
"OFFSITE_CONVERSIONS",
"IMPRESSIONS"
],
"type": "string",
"description": "What Meta optimises the ad set for."
}
}
},
"annotations": {
"title": "Prepare creating a Meta ad set",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare a bid strategy for one campaign with its target CPA or ROAS. target_cpa in whole account-currency units; the preview shows what the platform receives. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| target_cpa | number | Target cost per conversion in the ad account's currency, whole units. For target_cpa only. |
| campaign_id * | integer | ADS Beast id from list_campaigns, not the platform's. |
| target_roas | number | Target ROAS as a ratio, for example 4.0 for 400%. For target_roas only. |
| bid_strategy * | string | The bid strategy to switch to. |
{
"name": "prepare_campaign_bid_strategy_change",
"description": "Prepare a bid strategy for one campaign with its target CPA or ROAS. target_cpa in whole account-currency units; the preview shows what the platform receives. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"bid_strategy",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"target_cpa": {
"type": "number",
"description": "Target cost per conversion in the ad account's currency, whole units. For target_cpa only."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
},
"target_roas": {
"type": "number",
"description": "Target ROAS as a ratio, for example 4.0 for 400%. For target_roas only."
},
"bid_strategy": {
"enum": [
"target_cpa",
"target_roas",
"maximize_conversions",
"maximize_conversion_value",
"lowest_cost",
"manual_cpc"
],
"type": "string",
"description": "The bid strategy to switch to."
}
}
},
"annotations": {
"title": "Prepare a bid strategy change",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Pause one LinkedIn campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| platform_campaign_id * | string | LinkedIn id. |
{
"name": "prepare_linkedin_campaign_pause",
"description": "Pause one LinkedIn campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform_campaign_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"platform_campaign_id": {
"type": "string",
"description": "LinkedIn id."
}
}
},
"annotations": {
"title": "Prepare pausing a LinkedIn campaign",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}New daily budget for one LinkedIn campaign. Amounts are in the ad account's own currency, in whole units (not cents or micros). Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| daily_budget * | number | |
| platform_campaign_id * | string | LinkedIn id. |
{
"name": "prepare_linkedin_budget_change",
"description": "New daily budget for one LinkedIn campaign. Amounts are in the ad account's own currency, in whole units (not cents or micros). Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform_campaign_id",
"daily_budget",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"daily_budget": {
"type": "number"
},
"platform_campaign_id": {
"type": "string",
"description": "LinkedIn id."
}
}
},
"annotations": {
"title": "Prepare a LinkedIn budget change",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}New bid (unitCost) for one LinkedIn campaign. Amounts are in the ad account's own currency, in whole units (not cents or micros). Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| bid_amount * | number | |
| platform_campaign_id * | string | LinkedIn id. |
{
"name": "prepare_linkedin_bid_change",
"description": "New bid (unitCost) for one LinkedIn campaign. Amounts are in the ad account's own currency, in whole units (not cents or micros). Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform_campaign_id",
"bid_amount",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"bid_amount": {
"type": "number"
},
"platform_campaign_id": {
"type": "string",
"description": "LinkedIn id."
}
}
},
"annotations": {
"title": "Prepare a LinkedIn bid change",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}New start and end dates for one LinkedIn campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| end_date | string | |
| client_id * | integer | |
| start_date * | string | |
| platform_campaign_id * | string | LinkedIn id. |
{
"name": "prepare_linkedin_schedule_change",
"description": "New start and end dates for one LinkedIn campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform_campaign_id",
"start_date",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"end_date": {
"type": "string"
},
"client_id": {
"type": "integer"
},
"start_date": {
"type": "string"
},
"platform_campaign_id": {
"type": "string",
"description": "LinkedIn id."
}
}
},
"annotations": {
"title": "Prepare a LinkedIn schedule change",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}LinkedIn: exclude audience URNs by facet. Amazon: campaign negative keywords. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| facet | string | one of ["audiences","company_sizes","employers","industries","job_functions","locations","seniorities","skills","titles"] |
| reason * | string | Why, with numbers (shown to the approver). |
| values * | array | LinkedIn URNs or Amazon keywords. |
| platform * | string | one of ["linkedin","amazon"] |
| client_id * | integer | |
| match_type | string | one of ["exact","phrase"] |
| platform_campaign_id * | string | Platform id. |
{
"name": "prepare_platform_exclusions_add",
"description": "LinkedIn: exclude audience URNs by facet. Amazon: campaign negative keywords. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform",
"platform_campaign_id",
"values",
"reason"
],
"properties": {
"facet": {
"enum": [
"audiences",
"company_sizes",
"employers",
"industries",
"job_functions",
"locations",
"seniorities",
"skills",
"titles"
],
"type": "string"
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"values": {
"type": "array",
"items": {
"type": "string"
},
"description": "LinkedIn URNs or Amazon keywords."
},
"platform": {
"enum": [
"linkedin",
"amazon"
],
"type": "string"
},
"client_id": {
"type": "integer"
},
"match_type": {
"enum": [
"exact",
"phrase"
],
"type": "string"
},
"platform_campaign_id": {
"type": "string",
"description": "Platform id."
}
}
},
"annotations": {
"title": "Prepare LinkedIn/Amazon exclusions",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare website custom audiences and lookalikes in a client's Meta account. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| audience_types | array | Audience types to create. |
{
"name": "prepare_meta_audiences_create",
"description": "Prepare website custom audiences and lookalikes in a client's Meta account. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"audience_types": {
"type": "array",
"items": {
"enum": [
"website_30d",
"website_60d",
"lal_1pct",
"lal_3pct",
"lal_5pct"
],
"type": "string"
},
"default": [
"website_30d",
"lal_1pct"
],
"description": "Audience types to create."
}
}
},
"annotations": {
"title": "Prepare creating Meta audiences",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare removing fraud-prone placements from every ad set of a client's active Meta campaigns. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| objective | string | Meta objective, OUTCOME_LEADS by default. |
| include_bot_audience | boolean | Also attach the bot exclusion audience. |
{
"name": "prepare_meta_placement_safety_apply",
"description": "Prepare removing fraud-prone placements from every ad set of a client's active Meta campaigns. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"objective": {
"type": "string",
"description": "Meta objective, OUTCOME_LEADS by default."
},
"include_bot_audience": {
"type": "boolean",
"description": "Also attach the bot exclusion audience."
}
}
},
"annotations": {
"title": "Prepare excluding risky Meta placements",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare creating a conversion action in a client's Google Ads account; the result carries the tag code for the site. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Conversion name, for example 'CRM signup'. |
| reason * | string | Why, with numbers (shown to the approver). |
| category | string | Conversion category. |
| client_id * | integer | |
| account_id | string | Google account id; needed only when the client has several. |
{
"name": "prepare_google_conversion_action_create",
"description": "Prepare creating a conversion action in a client's Google Ads account; the result carries the tag code for the site. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"name",
"reason"
],
"properties": {
"name": {
"type": "string",
"description": "Conversion name, for example 'CRM signup'."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"category": {
"enum": [
"SIGNUP",
"LEAD",
"SUBMIT_LEAD_FORM",
"PURCHASE",
"CONTACT",
"REQUEST_QUOTE"
],
"type": "string",
"default": "SIGNUP",
"description": "Conversion category."
},
"client_id": {
"type": "integer"
},
"account_id": {
"type": "string",
"description": "Google account id; needed only when the client has several."
}
}
},
"annotations": {
"title": "Prepare a Google conversion action",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare adding videos to a Google App campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| title | string | Short title. |
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| account_id | string | Google account id; needed only when the client has several. |
| video_urls | array | https links to mp4 files. |
| campaign_id * | string | Google Ads id of the App campaign (digits). |
| youtube_videos | array | Ids or links of videos already on YouTube. |
{
"name": "prepare_google_app_videos_add",
"description": "Prepare adding videos to a Google App campaign. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"campaign_id",
"reason"
],
"properties": {
"title": {
"type": "string",
"description": "Short title."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"account_id": {
"type": "string",
"description": "Google account id; needed only when the client has several."
},
"video_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "https links to mp4 files."
},
"campaign_id": {
"type": "string",
"description": "Google Ads id of the App campaign (digits)."
},
"youtube_videos": {
"type": "array",
"items": {
"type": "string"
},
"description": "Ids or links of videos already on YouTube."
}
}
},
"annotations": {
"title": "Prepare adding videos to an App campaign",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare additional responsive search ads for a client's Google campaigns. New ads are created paused. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| campaign_ids | array | ADS Beast ids from list_campaigns. |
| ad_variations * | array | Ad variations, each naming its campaign and ad group. |
| verify_ad_strength | boolean | Read Ad Strength back after upload. |
| require_full_assets | boolean | Require 15 headlines and 4 descriptions per ad. |
| create_missing_ad_groups | boolean | Allow creating ad groups that do not exist yet. |
| min_new_ads_per_campaign | integer | Minimum number of new ads per campaign. |
Prepare pausing the duplicate copies of keywords that are enabled in several active Google campaigns of one account. The newest campaign keeps the keyword. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer |
{
"name": "prepare_google_keyword_overlap_fix",
"description": "Prepare pausing the duplicate copies of keywords that are enabled in several active Google campaigns of one account. The newest campaign keeps the keyword. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
}
}
},
"annotations": {
"title": "Prepare pausing duplicate keywords",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare creating an ad in Telegram Ads through its API. The ad is created paused. cpm and daily_budget_limit are in the Telegram account's currency. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| cpm * | number | CPM bid in the account currency. |
| text | string | Ad text, up to 160 characters. |
| title * | string | Ad name in the account, up to 128 bytes. |
| button | string | Button for a website ad. |
| reason * | string | Why, with numbers (shown to the approver). |
| placement | string | channel_post, bot_banner, search_result or video_banner. |
| account_id * | integer | ADS Beast ad account id. |
| promote_url * | string | @username, t.me link, bot or website. |
| website_name | string | Site name for an external link. |
| language_codes | array |
Prepare uploading a ChatGPT Ads campaign, paused and policy-checked first; it spends nothing until its ads are approved and a person enables it. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| chatgpt_campaign_id * | integer | ADS Beast id of the ChatGPT Ads campaign, from chatgpt_ads_status. |
{
"name": "prepare_chatgpt_ads_publish",
"description": "Prepare uploading a ChatGPT Ads campaign, paused and policy-checked first; it spends nothing until its ads are approved and a person enables it. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"chatgpt_campaign_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"chatgpt_campaign_id": {
"type": "integer",
"description": "ADS Beast id of the ChatGPT Ads campaign, from chatgpt_ads_status."
}
}
},
"annotations": {
"title": "Prepare publishing a ChatGPT Ads campaign",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare one custom audience (customer list, website pixel, app or offline) or one lookalike in a client's Meta account. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Audience name in the Meta account. |
| ratio | number | For lookalike: size 0.01-0.20 (1-20% of the country). |
| reason * | string | Why, with numbers (shown to the approver). |
| country | string | For lookalike: country code, e.g. PL. |
| subtype | string | For custom: CUSTOM, WEBSITE, APP or OFFLINE_CONVERSION. |
| pixel_id | string | For WEBSITE: Meta pixel id. |
| client_id * | integer | |
| audience_type * | string | custom or lookalike. |
| retention_days | integer | For WEBSITE: days a visitor stays in the audience. |
| source_audience_id | string | For lookalike: Meta id of the source custom audience. |
Prepare drafting social posts that announce a blog article of a client on the chosen channels. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| channels * | array | Channels to draft posts for. |
| article_id * | integer | ADS Beast article id, as returned by seo_article_generate. |
{
"name": "prepare_article_distribution",
"description": "Prepare drafting social posts that announce a blog article of a client on the chosen channels. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"article_id",
"channels",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"channels": {
"type": "array",
"items": {
"enum": [
"telegram",
"linkedin",
"meta_page",
"instagram"
],
"type": "string"
},
"description": "Channels to draft posts for."
},
"article_id": {
"type": "integer",
"description": "ADS Beast article id, as returned by seo_article_generate."
}
}
},
"annotations": {
"title": "Prepare social posts for an article",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare generating the monthly report for a client and emailing it to the client's address on record. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | Why, with numbers (shown to the approver). |
| client_id * | integer | |
| send_email | boolean | Send by email (default true). |
{
"name": "prepare_client_report_send",
"description": "Prepare generating the monthly report for a client and emailing it to the client's address on record. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"send_email": {
"type": "boolean",
"description": "Send by email (default true)."
}
}
},
"annotations": {
"title": "Prepare sending a client report",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare publishing or scheduling a post on a client's connected social channel. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Post text. |
| reason * | string | Why, with numbers (shown to the approver). |
| platform * | string | meta_page, linkedin, telegram or instagram. |
| client_id * | integer | |
| image_url | string | Public https URL of an image. |
| scheduled_at | string | ISO date-time; without it the post goes out on approval. |
{
"name": "prepare_social_post_schedule",
"description": "Prepare publishing or scheduling a post on a client's connected social channel. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform",
"text",
"reason"
],
"properties": {
"text": {
"type": "string",
"description": "Post text."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"platform": {
"enum": [
"meta_page",
"linkedin",
"telegram",
"instagram"
],
"type": "string",
"description": "meta_page, linkedin, telegram or instagram."
},
"client_id": {
"type": "integer"
},
"image_url": {
"type": "string",
"description": "Public https URL of an image."
},
"scheduled_at": {
"type": "string",
"description": "ISO date-time; without it the post goes out on approval."
}
}
},
"annotations": {
"title": "Prepare scheduling a social post",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Prepare a refresh plan for an outdated page: what to rewrite, update or remove. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.
| Parameter | Type | Description |
|---|---|---|
| url * | string | https:// page URL. |
| reason * | string | Why, with numbers (shown to the approver). |
| content | string | The text, when the URL is unreachable. |
| client_id | integer | |
| publish_date | string | When the page was published, YYYY-MM-DD. |
{
"name": "prepare_content_refresh",
"description": "Prepare a refresh plan for an outdated page: what to rewrite, update or remove. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"url",
"reason"
],
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"content": {
"type": "string",
"description": "The text, when the URL is unreachable."
},
"client_id": {
"type": "integer"
},
"publish_date": {
"type": "string",
"description": "When the page was published, YYYY-MM-DD."
}
}
},
"annotations": {
"title": "Prepare a content refresh",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Step 2 of every change: submit one preview made by a prepare_* tool, exactly as stored. A preview works once, for 15 minutes, and is refused if the campaign changed meanwhile. The answer says whether it waits for a person (the default) or applies under the client's write policy. It cannot approve.
| Parameter | Type | Description |
|---|---|---|
| preview_id * | string | The preview_id returned by a prepare_* tool. |
{
"name": "execute_prepared_change",
"description": "Step 2 of every change: submit one preview made by a prepare_* tool, exactly as stored. A preview works once, for 15 minutes, and is refused if the campaign changed meanwhile. The answer says whether it waits for a person (the default) or applies under the client's write policy. It cannot approve.",
"inputSchema": {
"type": "object",
"required": [
"preview_id"
],
"properties": {
"preview_id": {
"type": "string",
"description": "The preview_id returned by a prepare_* tool."
}
}
},
"annotations": {
"title": "Request execution of a prepared change",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Result of a call that answered status running with a job_id: running (poll in 15 s), done with the result, failed with why, or expired (24 h). Same key only; not metered.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | The job_id from a tool answer with status 'running'. |
{
"name": "get_job_result",
"description": "Result of a call that answered status running with a job_id: running (poll in 15 s), done with the result, failed with why, or expired (24 h). Same key only; not metered.",
"inputSchema": {
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "The job_id from a tool answer with status 'running'."
}
}
},
"annotations": {
"title": "Result of a long tool call",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}What became of a preview: still ready, expired, or submitted - and then the proposal's status (pending, executed, rejected, failed) with the execution result.
| Parameter | Type | Description |
|---|---|---|
| preview_id * | string | The preview_id returned by a prepare_* tool. |
{
"name": "get_prepared_change",
"description": "What became of a preview: still ready, expired, or submitted - and then the proposal's status (pending, executed, rejected, failed) with the execution result.",
"inputSchema": {
"type": "object",
"required": [
"preview_id"
],
"properties": {
"preview_id": {
"type": "string",
"description": "The preview_id returned by a prepare_* tool."
}
}
},
"annotations": {
"title": "Status of a prepared change",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}This server exposes one ADS Beast organization: its leads, campaigns, clients, reports, alerts, tasks, webhooks and outreach (email campaigns and the social prospecting queue). Which organization is decided by the API key the connection authenticates with, and no tool takes an organization or a credential as a parameter. The key also carries scopes, and each family of tools needs its own: read:leads and write:leads for the lead tools, read:campaigns for the campaign tools, read:clients for the client tools, read:reports for reports, read:alerts for alerts, read:tasks for tasks, read:webhooks with write:webhooks for the webhook tools, and read:outreach with write:outreach for the outreach tools, read:seo for seo_publish_safety. read:proposals with write:proposals for change proposals and for campaign drafts. Before proposing any content publication schedule, call seo_publish_safety: sites publish gradually and a paused site must not be worked around. A missing scope answers 403 rather than returning less data, and whoami reports the scopes the key actually carries, which is the first thing to check when a 403 appears. Most tools only read. Of the lead, webhook and outreach tools five write: update_lead and move_lead_stage change a lead record, push_lead_outcomes writes conversion outcomes that the ad platforms then optimise delivery and budget on, and create_webhook starts sending this organization's data to an outside URL, update_social_prospect records what happened after a person messaged a profile by hand (no tool here sends a message). These act on live advertising operations data, not on a sandbox, and push_lead_outcomes defaults to a dry run that reports what would change without writing it. Building a campaign: list_campaign_types for the platform, then create_campaign_draft, then fix what the validation names with update_campaign_draft. A draft lives only in the ADS Beast builder, and drafting sends nothing to an ad platform. To get the campaign created in the ad account (always paused), rehearse with campaign_draft_publish_check and then use prepare_campaign_draft_publish as described below; otherwise a person opens the draft by its builder_url and decides. Never report a campaign as created or running on the strength of a draft or a request. Tool families by prefix: client_, analytics_, audit_, campaign_, google_ads_, meta_ads_, tiktok_ads_, linkedin_ads_, microsoft_ads_, telegram_ads_, chatgpt_ads_, creative_, competitor_, leads_, seo_, aeo_, reddit_ read and analyse; task_, report_, recommendation_ and the draft tools write only inside ADS Beast. Analysis tools read the organization's own synced data; money is reported in each ad account's own currency and is never converted or summed across currencies. Changing an ad account is always two steps. First a prepare_ tool: it changes nothing and returns a stored preview with the state before and after, the server-side write controls that apply, and a preview_id that works once for 15 minutes. Show that preview to the user. Then execute_prepared_change with the preview_id: it submits exactly the stored change. By default the change then waits for a person to approve it in ADS Beast; only where the workspace owner set a client's write policy to apply reversible changes automatically does it run without one. An emergency stop, a switched-off ad account or an observe-only client block the write on the server whatever this connector sends. No tool approves, launches or activates: campaigns are created paused. Budgets are monthly amounts in the ad account's currency in whole units, never cents or micros; the preview shows the exact figure the platform will receive. Report a change as requested, not as done, until get_prepared_change shows it executed. Long tools (AI visibility scans, SEO research, long AI analyses) may answer with status 'running' and a job_id instead of a result: the work goes on in ADS Beast. Call get_job_result with that job_id every 15 seconds or s
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "push_lead_outcomes",
"description": "Write lead outcomes back so ad platforms learn which leads sold. A row names a lead (lead_id, email or phone) and its outcome. dry_run (default true) writes nothing; run it first. Unmatched rows are skipped unless create_missing; the stage follows unless update_stage is false.",
"inputSchema": {
"type": "object",
"required": [
"rows"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object"
},
"minItems": 1,
"description": "Outcome rows, for example [{\"lead_id\": 812, \"outcome\": \"won\", \"reason\": \"signed\"}]. For outcome paid add value (amount), currency (ISO 4217) and plan, e.g. {\"external_lead_id\": \"u-1\", \"outcome\": \"paid\", \"value\": 690, \"currency\": \"UAH\", \"plan\": \"Pro\"}. Accepted field names and outcome values come from lead_outcome_contract."
},
"dry_run": {
"type": "boolean",
"default": true,
"description": "True reports what would change and writes nothing. False applies the rows."
},
"client_id": {
"type": "integer",
"description": "Client the rows belong to. Optional with a key bound to one client - that client is used."
},
"update_stage": {
"type": "boolean",
"default": true,
"description": "Move a matched lead's pipeline stage to match the outcome, for example to won or lost."
},
"source_system": {
"type": "string",
"default": "mcp",
"description": "Name of the system the outcomes came from, recorded on each row."
},
"create_missing": {
"type": "boolean",
"default": false,
"description": "Create a new lead for a row that matches none. Off by default: a typo in an email must not insert a record."
}
}
},
"annotations": {
"title": "Push CRM outcomes back into the pipeline",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}| conversion | object | Meta leads/sales: {type: 'website', pixel_id, event} or {type: 'lead_form', lead_form_id}. |
| target_cpa | number | Account currency. |
| landing_url | string | https landing for ads without final_url. |
| target_roas | number |
| bid_strategy | string | From list_campaign_types; empty = platform default. |
| daily_budget | number | Per day, ad account currency. |
| campaign_type * | string | Type key from list_campaign_types, for example google.search or meta.leads_website. |
| negative_keywords | array |
{
"name": "create_campaign_draft",
"description": "Create a campaign DRAFT in the builder: type, geo, languages, budget, ad groups with keywords or audiences, ads, landing. Nothing reaches the platform. Returns draft id, builder_url and what blocks publishing; the draft is saved anyway. Call list_campaign_types first.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"platform",
"campaign_type",
"name"
],
"properties": {
"geo": {
"type": "array",
"items": {
"type": "string"
},
"description": "Country codes; Google also 'City, CC'."
},
"name": {
"type": "string",
"description": "Campaign name a person will see in the builder."
},
"extra": {
"type": "object",
"description": "page_id, instagram_actor_id, dsa_beneficiary, dsa_payor, structured_snippets, search_partners, display_network, geo_target_type, vertical, devices, job_titles, industries, cities, regions."
},
"notes": {
"type": "string",
"description": "Note for the reviewer."
},
"audience": {
"type": "object",
"description": "Social types: age_min, age_max, genders, interests, placements, custom_audiences, allow_broad_audience + broad_audience_reason."
},
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin",
"microsoft"
],
"type": "string"
},
"ad_groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ads": {
"type": "array",
"items": {
"type": "object",
"description": "Search: headlines[], descriptions[], path1, path2, final_url, sitelinks[{text, description1, description2, url}], callouts[]. Social: primary_text, headline, description, cta, image_url, final_url."
},
"maxItems": 10
},
"name": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": [
"string",
"object"
]
},
"description": "text or {text, match_type}."
},
"match_type": {
"enum": [
"EXACT",
"PHRASE",
"BROAD"
],
"type": "string"
},
"negative_keywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"maxItems": 20,
"description": "Fields and limits per type: list_campaign_types."
},
"client_id": {
"type": "integer",
"description": "Client id from list_clients."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Audience language codes."
},
"conversion": {
"type": "object",
"description": "Meta leads/sales: {type: 'website', pixel_id, event} or {type: 'lead_form', lead_form_id}."
},
"target_cpa": {
"type": "number",
"description": "Account currency.",
"exclusiveMinimum": 0
},
"landing_url": {
"type": "string",
"description": "https landing for ads without final_url."
},
"target_roas": {
"type": "number",
"exclusiveMinimum": 0
},
"bid_strategy": {
"type": "string",
"description": "From list_campaign_types; empty = platform default."
},
"daily_budget": {
"type": "number",
"description": "Per day, ad account currency.",
"exclusiveMinimum": 0
},
"campaign_type": {
"type": "string",
"description": "Type key from list_campaign_types, for example google.search or meta.leads_website."
},
"negative_keywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"annotations": {
"title": "Create a campaign draft in the builder",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}| Account currency. |
| landing_url | string | https landing for ads without final_url. |
| target_roas | number |
| bid_strategy | string | From list_campaign_types; empty = platform default. |
| daily_budget | number | Per day, ad account currency. |
| negative_keywords | array |
{
"name": "update_campaign_draft",
"description": "Replace fields of an unpublished draft made by create_campaign_draft; each field replaces the stored one whole. Returns a fresh validation. A person's draft or a published build is refused.",
"inputSchema": {
"type": "object",
"required": [
"draft_id"
],
"properties": {
"geo": {
"type": "array",
"items": {
"type": "string"
},
"description": "Country codes; Google also 'City, CC'."
},
"name": {
"type": "string"
},
"extra": {
"type": "object",
"description": "page_id, instagram_actor_id, dsa_beneficiary, dsa_payor, structured_snippets, search_partners, display_network, geo_target_type, vertical, devices, job_titles, industries, cities, regions."
},
"notes": {
"type": "string",
"description": "Note for the reviewer."
},
"audience": {
"type": "object",
"description": "Social types: age_min, age_max, genders, interests, placements, custom_audiences, allow_broad_audience + broad_audience_reason."
},
"draft_id": {
"type": "integer",
"description": "Draft id returned by create_campaign_draft."
},
"ad_groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ads": {
"type": "array",
"items": {
"type": "object",
"description": "Search: headlines[], descriptions[], path1, path2, final_url, sitelinks[{text, description1, description2, url}], callouts[]. Social: primary_text, headline, description, cta, image_url, final_url."
},
"maxItems": 10
},
"name": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": [
"string",
"object"
]
},
"description": "text or {text, match_type}."
},
"match_type": {
"enum": [
"EXACT",
"PHRASE",
"BROAD"
],
"type": "string"
},
"negative_keywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"maxItems": 20,
"description": "Fields and limits per type: list_campaign_types."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Audience language codes."
},
"conversion": {
"type": "object",
"description": "Meta leads/sales: {type: 'website', pixel_id, event} or {type: 'lead_form', lead_form_id}."
},
"target_cpa": {
"type": "number",
"description": "Account currency.",
"exclusiveMinimum": 0
},
"landing_url": {
"type": "string",
"description": "https landing for ads without final_url."
},
"target_roas": {
"type": "number",
"exclusiveMinimum": 0
},
"bid_strategy": {
"type": "string",
"description": "From list_campaign_types; empty = platform default."
},
"daily_budget": {
"type": "number",
"description": "Per day, ad account currency.",
"exclusiveMinimum": 0
},
"negative_keywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"annotations": {
"title": "Change a campaign draft the assistant created",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "analytics_media_plan",
"description": "A sourced chain of planning numbers for a campaign type: CPM, reach, clicks, CPC, conversion rate, conversions, CPA, break-even and three scenarios. Every figure is labelled with where it comes from.",
"inputSchema": {
"type": "object",
"required": [
"platform",
"objective_or_type",
"monthly_budget"
],
"properties": {
"niche": {
"type": "string",
"description": "Business niche or industry, in plain words."
},
"currency": {
"type": "string",
"default": "USD",
"description": "ISO currency code of the budget."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
},
"num_objects": {
"type": "integer",
"default": 1,
"description": "How many ad sets or ad groups share the budget."
},
"monthly_budget": {
"type": "number",
"description": "Monthly budget in the stated currency, whole units."
},
"avg_order_value": {
"type": "number",
"description": "Average order value, for revenue and break-even."
},
"gross_margin_pct": {
"type": "number",
"description": "Gross margin in percent, for break-even."
},
"objective_or_type": {
"type": "string",
"description": "Goal or campaign type: leads, sales, traffic, or a key from campaign_type_coverage."
}
}
},
"annotations": {
"title": "Media plan numbers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| landing_page_url | string | Landing page URL. |
{
"name": "leads_quality_diagnose",
"description": "Works out where a campaign loses lead quality and what to change, from the numbers and complaints supplied. Takes up to a minute. Amounts are in the ad account's own currency, in whole units (not cents or micros). AI: 1 AI request. May return a job_id (get_job_result).",
"inputSchema": {
"type": "object",
"required": [
"campaign_name",
"platform"
],
"properties": {
"cpa": {
"type": "number",
"description": "Actual cost per lead."
},
"ctr": {
"type": "number",
"description": "CTR in percent."
},
"spend": {
"type": "number",
"description": "Spend over the period."
},
"clicks": {
"type": "integer",
"description": "Clicks over the period."
},
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin",
"microsoft"
],
"type": "string"
},
"client_id": {
"type": "integer",
"description": "Client id; when given, the result is saved as a report."
},
"target_cpa": {
"type": "number",
"description": "Target cost per lead."
},
"conversions": {
"type": "integer",
"description": "Conversions over the period."
},
"campaign_name": {
"type": "string",
"description": "Campaign name."
},
"lead_complaints": {
"type": "string",
"description": "What is wrong with the leads, in the client's words."
},
"landing_page_url": {
"type": "string",
"description": "Landing page URL."
}
}
},
"annotations": {
"title": "Diagnose lead quality",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "notification_preferences_set",
"description": "The key owner's own alert delivery: only critical alerts, a daily or weekly digest instead of every signal, mute one alert type, turn a channel off. Pass only what the user asked for. Quiet hours by clock time do not exist: set quiet_hours_requested and relay the question it returns. Called with nothing, it returns a question listing the options.",
"inputSchema": {
"type": "object",
"properties": {
"mute_types": {
"type": "array",
"items": {
"enum": [
"budget",
"cpa",
"ctr",
"roas",
"zero_conversions",
"overdue_reports",
"stale_campaigns"
],
"type": "string"
},
"description": "Alert types to turn off: budget, cpa, ctr, roas, zero_conversions, overdue_reports, stale_campaigns."
},
"digest_hour": {
"type": "integer",
"description": "Hour of the daily digest, 0 to 23 UTC."
},
"digest_mode": {
"enum": [
"realtime",
"daily",
"weekly"
],
"type": "string",
"description": "realtime, daily or weekly."
},
"unmute_types": {
"type": "array",
"items": {
"enum": [
"budget",
"cpa",
"ctr",
"roas",
"zero_conversions",
"overdue_reports",
"stale_campaigns"
],
"type": "string"
},
"description": "Alert types to turn back on."
},
"channel_email": {
"type": "boolean"
},
"critical_only": {
"type": "boolean",
"description": "true to receive only critical alerts."
},
"channel_browser": {
"type": "boolean"
},
"channel_telegram": {
"type": "boolean"
},
"quiet_hours_requested": {
"type": "boolean",
"description": "true when the user asks for quiet hours or do-not-disturb by time of day."
},
"confirm_all_channels_off": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Change my notification preferences",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "ab_test_create",
"description": "Register an A/B test in ADS Beast to track its hypothesis and variants. It records the test; it does not change ads.",
"inputSchema": {
"type": "object",
"required": [
"name",
"hypothesis",
"what_tested",
"variant_a_name",
"variant_b_name"
],
"properties": {
"name": {
"type": "string",
"description": "Name shown in the interface."
},
"client_id": {
"type": "integer"
},
"hypothesis": {
"type": "string",
"description": "If X then Y changes by Z, because..."
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
},
"what_tested": {
"enum": [
"headline",
"creative",
"cta",
"audience",
"landing",
"bid",
"offer",
"format"
],
"type": "string",
"description": "What differs between the variants."
},
"variant_a_name": {
"type": "string",
"description": "Control variant."
},
"variant_b_name": {
"type": "string",
"description": "Test variant."
},
"variant_a_description": {
"type": "string",
"description": "Control variant in detail."
},
"variant_b_description": {
"type": "string",
"description": "Test variant in detail."
}
}
},
"annotations": {
"title": "Create an A/B test record",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "telegram_ads_draft_generate",
"description": "Builds a ready-to-submit Telegram ad within the 160-character limit with bid, budget and an impressions estimate, and reports whether it passes preflight. Amounts are in the Telegram account currency.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"cpm": {
"type": "number",
"description": "CPM bid in the account currency."
},
"text": {
"type": "string",
"description": "Ad text."
},
"title": {
"type": "string",
"description": "Short title."
},
"budget": {
"type": "number",
"description": "Budget in the account currency."
},
"button": {
"type": "string",
"description": "Button for a website ad."
},
"currency": {
"type": "string",
"description": "EUR, TON or XTR."
},
"client_id": {
"type": "integer"
},
"placement": {
"type": "string",
"description": "channel_post, bot_banner, search_result or video_banner."
},
"autoshorten": {
"type": "boolean",
"description": "Cut the text at a word boundary when it is too long."
},
"promote_url": {
"type": "string",
"description": "@username, t.me link, bot or website."
},
"website_name": {
"type": "string",
"description": "Site name for an external link."
}
}
},
"annotations": {
"title": "Draft a Telegram ad",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "campaign_draft_edit",
"description": "Low-level edit of a campaign draft before publishing: merge targeting keys, update ads, replace ad groups, rename, change goal, budget or UTM. Nothing is sent to the platform. Amounts are in the ad account's own currency, in whole units (not cents or micros).",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"build_id"
],
"properties": {
"name": {
"type": "string",
"description": "Name shown in the interface."
},
"build_id": {
"type": "integer",
"description": "Draft id from list_campaign_drafts."
},
"ad_groups": {
"type": "array",
"items": {
"type": "object"
},
"description": "Full replacement of the ad groups."
},
"client_id": {
"type": "integer"
},
"objective": {
"type": "string",
"description": "Campaign goal."
},
"targeting": {
"type": "object",
"description": "Targeting keys to merge; a null value removes the key."
},
"ad_updates": {
"type": "array",
"items": {
"type": "object",
"required": [
"group",
"ad_number",
"fields"
],
"properties": {
"group": {
"type": "string"
},
"fields": {
"type": "object"
},
"ad_number": {
"type": "integer"
}
}
},
"description": "Ad edits."
},
"utm_params": {
"type": "object",
"description": "UTM parameters."
},
"budget_type": {
"type": "string",
"description": "daily or monthly."
},
"budget_amount": {
"type": "number",
"description": "Budget in the account currency, whole units."
}
}
},
"annotations": {
"title": "Edit campaign draft targeting and ads",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "prepare_google_rsa_variations",
"description": "Prepare additional responsive search ads for a client's Google campaigns. New ads are created paused. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"ad_variations",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
},
"campaign_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "ADS Beast ids from list_campaigns."
},
"ad_variations": {
"type": "array",
"items": {
"type": "object",
"required": [
"campaign_id",
"ad_group_name",
"final_url",
"headlines",
"descriptions"
],
"properties": {
"label": {
"type": "string"
},
"path1": {
"type": "string"
},
"path2": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"match_type": {
"enum": [
"EXACT",
"PHRASE",
"BROAD"
],
"type": "string"
},
"is_negative": {
"type": "boolean"
}
}
}
},
"final_url": {
"type": "string"
},
"headlines": {
"type": "array",
"items": {
"type": "string"
}
},
"campaign_id": {
"type": "integer"
},
"descriptions": {
"type": "array",
"items": {
"type": "string"
}
},
"ad_group_name": {
"type": "string"
},
"cpc_bid_micros": {
"type": "integer"
}
}
},
"description": "Ad variations, each naming its campaign and ad group."
},
"verify_ad_strength": {
"type": "boolean",
"default": true,
"description": "Read Ad Strength back after upload."
},
"require_full_assets": {
"type": "boolean",
"default": true,
"description": "Require 15 headlines and 4 descriptions per ad."
},
"create_missing_ad_groups": {
"type": "boolean",
"default": false,
"description": "Allow creating ad groups that do not exist yet."
},
"min_new_ads_per_campaign": {
"type": "integer",
"default": 0,
"description": "Minimum number of new ads per campaign."
}
}
},
"annotations": {
"title": "Prepare new Google search ad variations",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}| Channel languages, up to 8. |
| daily_budget_limit | number | Daily limit in the account currency. |
{
"name": "prepare_telegram_ad_publish",
"description": "Prepare creating an ad in Telegram Ads through its API. The ad is created paused. cpm and daily_budget_limit are in the Telegram account's currency. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"account_id",
"title",
"promote_url",
"cpm",
"reason"
],
"properties": {
"cpm": {
"type": "number",
"description": "CPM bid in the account currency."
},
"text": {
"type": "string",
"description": "Ad text, up to 160 characters."
},
"title": {
"type": "string",
"description": "Ad name in the account, up to 128 bytes."
},
"button": {
"type": "string",
"description": "Button for a website ad."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"placement": {
"type": "string",
"description": "channel_post, bot_banner, search_result or video_banner."
},
"account_id": {
"type": "integer",
"description": "ADS Beast ad account id."
},
"promote_url": {
"type": "string",
"description": "@username, t.me link, bot or website."
},
"website_name": {
"type": "string",
"description": "Site name for an external link."
},
"language_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Channel languages, up to 8."
},
"daily_budget_limit": {
"type": "number",
"description": "Daily limit in the account currency."
}
}
},
"annotations": {
"title": "Prepare publishing a Telegram ad",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "prepare_meta_audience_create",
"description": "Prepare one custom audience (customer list, website pixel, app or offline) or one lookalike in a client's Meta account. Changes nothing: returns a preview_id (15 min, one use) for execute_prepared_change.",
"inputSchema": {
"type": "object",
"required": [
"client_id",
"audience_type",
"name",
"reason"
],
"properties": {
"name": {
"type": "string",
"description": "Audience name in the Meta account."
},
"ratio": {
"type": "number",
"description": "For lookalike: size 0.01-0.20 (1-20% of the country)."
},
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"country": {
"type": "string",
"description": "For lookalike: country code, e.g. PL."
},
"subtype": {
"enum": [
"CUSTOM",
"WEBSITE",
"APP",
"OFFLINE_CONVERSION"
],
"type": "string",
"description": "For custom: CUSTOM, WEBSITE, APP or OFFLINE_CONVERSION."
},
"pixel_id": {
"type": "string",
"description": "For WEBSITE: Meta pixel id."
},
"client_id": {
"type": "integer"
},
"audience_type": {
"enum": [
"custom",
"lookalike"
],
"type": "string",
"description": "custom or lookalike."
},
"retention_days": {
"type": "integer",
"description": "For WEBSITE: days a visitor stays in the audience."
},
"source_audience_id": {
"type": "string",
"description": "For lookalike: Meta id of the source custom audience."
}
}
},
"annotations": {
"title": "Prepare creating one Meta audience",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}