Ad account audits, analytics, leads and campaign changes that run only from an approved preview.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Clients that support OAuth sign in through the ADS Beast consent screen and need no header. Otherwise: Bearer followed by a scoped ADS Beast API key (absk_...), created by an admin under API Keys.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Register an A/B test in ADS Beast to track its hypothesis and variants. It records the test; it does not change ads.
Name shown in the interface.
If X then Y changes by Z, because...
What differs between the variants.
Control variant.
Test variant.
ADS Beast id from list_campaigns, not the platform's.
Control variant in detail.
Test variant in detail.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http adsbeast https://adsbeast.pro/api/mcp/workspace
Headers
Authorization (optional, not in the config above): Optional. Clients that support OAuth sign in through the ADS Beast consent screen and need no header. Otherwise: Bearer followed by a scoped ADS Beast API key (absk_...), created by an admin under API Keys.Showing the first 150 of 184, by name. Connect in the playground above to browse them all.
Register an A/B test in ADS Beast to track its hypothesis and variants. It records the test; it does not change ads.
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page_url* | string | The page to optimise. |
| client_id* | integer | |
| focus_query | string | The AI query to win. |
{
"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."
}
}
}Fresh discussions where people ask for recommendations in a client's niche, with a suggested reply. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"description": "Max records."
},
"client_id": {
"type": "integer"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| competitors | array | Competitor names or domains. |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"competitors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Competitor names or domains."
}
}
}Return how many live alerts are still unread, as a single number. An alert whose condition has already cleared is not counted even if nobody opened it, so this is the number that still needs a person. Cheaper than list_alerts when only the count matters.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}A/B tests with their status and interim results.
| Argument | 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. |
{
"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."
}
}
}Morning briefing for the workspace: critical alerts, today's tasks and what needs attention now.
No arguments.
{
"type": "object",
"properties": {}
}Time-decay multi-touch attribution for a client's campaigns: attributed conversions, attributed CPA and the lift against last click.
| Argument | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"client_id": {
"type": "integer"
}
}
}Reference CTR, CPC, CPA and ROAS ranges for a platform and niche. Benchmarks are orientation, not a verdict on one account.
| Argument | Type | Description |
|---|---|---|
| niche | string | Business niche or industry, in plain words. |
| platform* | string |
{
"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"
}
}
}Percentage change of every KPI between the current period and the one before it, by platform, with what got worse and what improved.
| Argument | 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. |
{
"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."
}
}
}Patterns and anomalies across clients: platforms that sag for most of them, shared niche problems, who outperforms.
| Argument | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| campaign_id | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"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."
}
}
}Campaigns expected to break a KPI target within days, from a linear trend.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Campaigns ready to scale: ROAS well above target, CPA well below target, or budget left unused.
| Argument | Type | Description |
|---|---|---|
| client_id | integer | |
| min_roas_multiplier | number | ROAS-to-target ratio that counts as ready to scale, for example 1.5. |
{
"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."
}
}
}Quick status of all active campaigns: how many are on target and how many need attention.
| Argument | Type | Description |
|---|---|---|
| client_id | integer |
{
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | 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. |
{
"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."
}
}
}Cross-client analysis of the whole portfolio: best and worst performers, platform trends, total spend. Takes up to a minute. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
}
}
}Spend, CTR, CPA and ROAS of one client over a period. Money is reported in the account currency and never summed across currencies.
| Argument | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id* | integer |
{
"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"
}
}
}AI audit of a client's ad account on one platform or all of them. Takes 10-30 seconds. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"platform": {
"type": "string",
"default": "all",
"description": "google, meta, tiktok, linkedin or microsoft."
},
"client_id": {
"type": "integer"
}
}
}Ads the platforms rejected, with the reason and the policy code.
| Argument | Type | Description |
|---|---|---|
| status | string | open (default), acknowledged, fixed, wontfix or all. |
| platform | string | google, meta, tiktok, linkedin or microsoft. |
| client_id | integer |
{
"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"
}
}
}A 1-10 health score for each campaign of a client with the problems behind it.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id | integer | |
| only_active | boolean | Only running campaigns. |
{
"type": "object",
"properties": {
"client_id": {
"type": "integer"
},
"only_active": {
"type": "boolean",
"default": true,
"description": "Only running campaigns."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| depth | string | quick or full. |
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"depth": {
"enum": [
"quick",
"full"
],
"type": "string",
"default": "full",
"description": "quick or full."
},
"client_id": {
"type": "integer"
}
}
}Full Meta Ads audit for a client: funnel structure, audiences, creatives, pixel health, conversion events, audience fatigue and Advantage+ setup. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Tracking diagnostics for a client: pixel, GA4 and GTM mismatches on the landing page, conversion actions and the other tracking guards in one report.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Campaigns that burn budget: spend with zero conversions, CPA above target, no clicks. Returns the amounts lost, in the account currency.
| Argument | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| client_id | integer |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look-back days."
},
"client_id": {
"type": "integer"
}
}
}Deep analysis of one campaign: metrics, trends and recommendations. Takes up to a minute. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| days | integer | Look-back days. |
| campaign_id* | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"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."
}
}
}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 arguments.
{
"type": "object",
"required": [],
"properties": {}
}Works through the possible causes of one KPI problem in a campaign: audience saturation, creative fatigue, landing page, bid strategy, seasonality, tracking.
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| build_id* | integer | Draft id from list_campaign_drafts. |
| client_id* | integer |
{
"type": "object",
"required": [
"client_id",
"build_id"
],
"properties": {
"build_id": {
"type": "integer",
"description": "Draft id from list_campaign_drafts."
},
"client_id": {
"type": "integer"
}
}
}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).
| Argument | 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. |
{
"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."
}
}
}Validates a campaign draft against the live ad account and reports exactly what publishing would create or change. Read-only rehearsal: nothing is written.
| Argument | 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. |
{
"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."
}
}
}What worked for a client before: average CPA and CTR, best campaigns and best audiences.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Campaigns filtered by client, platform, status or a substring of the name.
| Argument | 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. |
{
"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."
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| platform | string | |
| 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. |
{
"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."
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| focus | string | growth, efficiency or brand. |
| client_id* | integer | |
| horizon_months | integer | Planning horizon, 1-12 months. |
{
"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."
}
}
}Recent multi-agent campaign generation runs with status, platform and budget.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| client_id | integer |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"description": "Max records."
},
"client_id": {
"type": "integer"
}
}
}Which campaign types ADS Beast supports on each platform and how far: creation through the API, generation, validation.
| Argument | Type | Description |
|---|---|---|
| platform | string | google, meta, tiktok, linkedin or microsoft. |
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"description": "google, meta, tiktok, linkedin or microsoft."
}
}
}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.
| Argument | 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. |
{
"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."
}
}
}Whether ChatGPT Ads policy admits this business and whether the texts fit the limits (title 50, body 100).
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| chatgpt_campaign_id* | integer | ADS Beast id of the ChatGPT Ads campaign, from chatgpt_ads_status. |
{
"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."
}
}
}Connected ChatGPT Ads accounts, campaigns, ad review statuses and what blocks delivery.
| Argument | Type | Description |
|---|---|---|
| client_id | integer |
{
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
}The action plan from the client's latest weekly deep-dive audit: findings labelled confirmed, inferred or hypothesis, open change proposals and open tasks.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}When each client and platform was last synced. Call it before a deep analysis so stale data is named as stale.
| Argument | Type | Description |
|---|---|---|
| client_id | integer |
{
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
}KPI goals (ROAS, CPA, CTR, CPC) with target, current value, progress and status. Without client_id: goals of every client.
| Argument | Type | Description |
|---|---|---|
| client_id | integer |
{
"type": "object",
"properties": {
"client_id": {
"type": "integer"
}
}
}Full-text search over a client's earlier reports, audits and analyses.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| query* | string | Search text. |
| client_id | integer | |
| report_type | string | audit, monthly, jarvis_chat or all. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| url | string | https:// page URL. |
| client_id | integer |
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"client_id": {
"type": "integer"
}
}
}The stored market analysis of a client: summary, competitor matrix, audience signals and the draft campaign strategy.
| Argument | Type | Description |
|---|---|---|
| section | string | all, summary, competitors, audience, strategy or insights. |
| client_id* | integer |
{
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| force | boolean | true re-runs even when a fresh report exists. |
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"force": {
"type": "boolean",
"description": "true re-runs even when a fresh report exists."
},
"client_id": {
"type": "integer"
}
}
}Semantic search over a client's indexed market data: its site, competitor profiles and the market report.
| Argument | Type | Description |
|---|---|---|
| query* | string | Search text. |
| top_k | integer | Number of results, 5 by default. |
| client_id* | integer |
{
"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"
}
}
}Status and report of the multi-agent market simulations requested for a client.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Ask for a multi-agent market simulation for a client. It is queued as a request a person confirms, because it costs model usage.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| requirement* | string | What to simulate. |
{
"type": "object",
"required": [
"requirement",
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"requirement": {
"type": "string",
"description": "What to simulate."
}
}
}Search the facts, decisions, preferences and brand notes ADS Beast has stored about clients.
| Argument | Type | Description |
|---|---|---|
| query* | string | What to look for, in plain words. |
| client_id | integer |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "What to look for, in plain words."
},
"client_id": {
"type": "integer"
}
}
}One client with its campaigns, key metrics and goals.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| geo | string | Country code, e.g. us or de. |
| niche | string | Business niche or industry, in plain words. |
| client_id | integer |
{
"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"
}
}
}Compares how often AI models mention the client versus competitors for the same prompts. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| competitors | array | Competitor names or domains. |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"competitors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Competitor names or domains."
}
}
}Competitors on record with site, niche, collected ads and keywords.
| Argument | Type | Description |
|---|---|---|
| with_ads | boolean | Include the collected ads (larger response). |
| client_id | integer |
{
"type": "object",
"properties": {
"with_ads": {
"type": "boolean",
"default": false,
"description": "Include the collected ads (larger response)."
},
"client_id": {
"type": "integer"
}
}
}Searches the web for a competitor's ads, positioning, pricing, selling points and reviews.
| Argument | 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. |
{
"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."
}
}
}Reads one competitor site: selling points, prices, technology, pixels, call-to-action patterns and audience signals.
| Argument | Type | Description |
|---|---|---|
| url* | string | https:// page URL. |
| client_id* | integer |
{
"type": "object",
"required": [
"url",
"client_id"
],
"properties": {
"url": {
"type": "string",
"description": "https:// page URL."
},
"client_id": {
"type": "integer"
}
}
}A competitor's recent activity outside its site: YouTube, blog feed, public posts and community mentions.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| competitor_url* | string | Competitor's site. |
{
"type": "object",
"required": [
"competitor_url",
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"competitor_url": {
"type": "string",
"description": "Competitor's site."
}
}
}Create a campaign as a DRAFT in the ADS Beast builder: type, geo, languages, daily budget, ad groups with keywords or audiences, ad texts, landing page. Nothing reaches the ad platform. Returns the draft id, builder_url and what still blocks publishing (platform limits, ad policy, compliance); a draft with problems is still saved for update_campaign_draft. Publishing: prepare_campaign_draft_publish or a person in the builder, always paused. Call list_campaign_types first.
| Argument | Type | Description |
|---|---|---|
| geo | array | Country codes ('UA', 'SK'); Google also takes 'City, CC'. Meta takes country codes only. |
| 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 | A note for the person who will review the draft: what it is for and what to check. |
| audience | object | Social types: age_min, age_max, genders, interests, placements, custom_audiences, allow_broad_audience + broad_audience_reason. |
| platform* | string | |
| ad_groups | array | Ad groups (ad sets) with their keywords and ads. The exact fields and limits per type are in list_campaign_types. |
| client_id* | integer | Client id from list_clients. |
| languages | array | Language codes of the audience ('uk', 'en'). |
| conversion | object | Meta leads/sales: {type: 'website', pixel_id, event} or {type: 'lead_form', lead_form_id}. |
| target_cpa | number | Target cost per result in the account currency, when the strategy needs one. |
| landing_url | string | https landing page used for every ad that has no final_url of its own. |
| target_roas | number | |
| bid_strategy | string | See default_bid_strategies of the type in list_campaign_types; empty keeps the platform default. |
| daily_budget | number | Per day, in the currency of the client's ad account. |
| campaign_type* | string | Type key from list_campaign_types, for example google.search or meta.leads_website. |
| negative_keywords | array | Campaign-level negative keywords (search types). |
{
"type": "object",
"required": [
"client_id",
"platform",
"campaign_type",
"name"
],
"properties": {
"geo": {
"type": "array",
"items": {
"type": "string"
},
"description": "Country codes ('UA', 'SK'); Google also takes 'City, CC'. Meta takes country codes only."
},
"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": "A note for the person who will review the draft: what it is for and what to check."
},
"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": "Search types: text, or {text, match_type: EXACT|PHRASE|BROAD}."
},
"match_type": {
"enum": [
"EXACT",
"PHRASE",
"BROAD"
],
"type": "string",
"description": "Default for keywords without their own."
},
"negative_keywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"maxItems": 20,
"description": "Ad groups (ad sets) with their keywords and ads. The exact fields and limits per type are in list_campaign_types."
},
"client_id": {
"type": "integer",
"description": "Client id from list_clients."
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Language codes of the audience ('uk', 'en')."
},
"conversion": {
"type": "object",
"description": "Meta leads/sales: {type: 'website', pixel_id, event} or {type: 'lead_form', lead_form_id}."
},
"target_cpa": {
"type": "number",
"description": "Target cost per result in the account currency, when the strategy needs one.",
"exclusiveMinimum": 0
},
"landing_url": {
"type": "string",
"description": "https landing page used for every ad that has no final_url of its own."
},
"target_roas": {
"type": "number",
"exclusiveMinimum": 0
},
"bid_strategy": {
"type": "string",
"description": "See default_bid_strategies of the type in list_campaign_types; empty keeps the platform default."
},
"daily_budget": {
"type": "number",
"description": "Per day, in the currency of the client's ad account.",
"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"
},
"description": "Campaign-level negative keywords (search types)."
}
}
}Register an endpoint ADS Beast calls when a chosen event happens. From then on those records go to that URL until it is removed. Without client_id it covers every client of the organization. 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.
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| platform | string | |
| 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'. |
{
"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'."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| tone | string | Tone of voice. |
| count | integer | Number of variants. |
| ad_type | string | search, display, video, stories or feed. |
| platform* | string | |
| client_id* | integer |
{
"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"
}
}
}Scores a text 0-100 for signs of machine writing, lists the markers found and returns a cleaned version. It never invents facts.
| Argument | Type | Description |
|---|---|---|
| text* | string | The text to check or use. |
| surface | string | ad_copy, prose, report or raw. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id | integer | |
| campaign_id | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"type": "object",
"properties": {
"client_id": {
"type": "integer"
},
"campaign_id": {
"type": "integer",
"description": "ADS Beast id from list_campaigns, not the platform's."
}
}
}Campaigns of a client with high frequency and falling CTR, ranked by how tired the creative is.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| threshold_frequency | number | Minimum frequency that counts as fatigue. |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
},
"threshold_frequency": {
"type": "number",
"default": 3.5,
"description": "Minimum frequency that counts as fatigue."
}
}
}Reviews an ad image for platform fit, visual hierarchy, call-to-action legibility and brand fit. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| context | string | Brand, audience or goal. |
| platform | string | |
| image_url* | string | Public https URL of the image. |
{
"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."
}
}
}A library of prompts for generating ad banners, filtered by business vertical and visual style.
| Argument | Type | Description |
|---|---|---|
| style | string | Visual style. |
| vertical | string | Business vertical. |
{
"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."
}
}
}Step 2 of every change: submit one preview made by a prepare_* tool. Only that stored preview runs - this tool takes no other argument, so the change cannot differ from what was shown. A preview works once, for 15 minutes, and is refused when the campaign changed in the meantime. The answer says whether the change now waits for a person's approval in ADS Beast (the default) or is being applied under the client's write policy. This connector cannot approve.
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | The preview_id returned by a prepare_* tool. |
{
"type": "object",
"required": [
"preview_id"
],
"properties": {
"preview_id": {
"type": "string",
"description": "The preview_id returned by a prepare_* tool."
}
}
}The knowledge pack the agency keeps for one client: who they are, accounts and campaigns with the last 30 days of results, leads by stage, KPI goals, the write policy, the methodology of working through ADS Beast and ready prompts. Read it first when a conversation is about one client. Contains no contacts or keys.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | Client id from list_clients. |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer",
"description": "Client id from list_clients."
}
}
}Return a single campaign by its ADS Beast id with its settings, budget, status and the native id it has on its platform.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | integer | ADS Beast id of the campaign, as returned by list_campaigns. |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "integer",
"description": "ADS Beast id of the campaign, as returned by list_campaigns."
}
}
}The current content of one build and a fresh validation: 'problems' block publishing, 'warnings' do not, 'launch_blockers' say why a person could not publish right now (no connected account, writing switched off), 'not_checked_here' lists what only the publish step checks. Problem texts come from the builder's own checker and are in Russian; relay them in the user's language.
| Argument | Type | Description |
|---|---|---|
| draft_id* | integer | Build id from list_campaign_drafts or create_campaign_draft. |
{
"type": "object",
"required": [
"draft_id"
],
"properties": {
"draft_id": {
"type": "integer",
"description": "Build id from list_campaign_drafts or create_campaign_draft."
}
}
}Return a single client by its ADS Beast id: profile, budget, goals and connected advertising accounts.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | ADS Beast id of the client, as returned by list_clients. |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer",
"description": "ADS Beast id of the client, as returned by list_clients."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | The job_id from a tool answer with status 'running'. |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "The job_id from a tool answer with status 'running'."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| lead_id* | integer | ADS Beast id of the lead, as returned by get_new_leads. |
{
"type": "object",
"required": [
"lead_id"
],
"properties": {
"lead_id": {
"type": "integer",
"description": "ADS Beast id of the lead, as returned by get_new_leads."
}
}
}A page of leads with contact details, form answers and attribution (UTM, click ids, platform form, lead and campaign ids). Pass updated_since (ISO-8601, your last sync) to get only new or changed leads. Reply: {count, leads, has_more, next_offset, offset, limit}; page with next_offset while has_more.
| Argument | 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. |
{
"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."
}
}
}What became of a preview: still ready, expired, or submitted - and then the proposal's status (pending, executed, rejected, failed) with the execution result.
| Argument | Type | Description |
|---|---|---|
| preview_id* | string | The preview_id returned by a prepare_* tool. |
{
"type": "object",
"required": [
"preview_id"
],
"properties": {
"preview_id": {
"type": "string",
"description": "The preview_id returned by a prepare_* tool."
}
}
}Return the next business profiles to message by hand, best first, within today's remaining cap per platform: profile link, signals (books by DM, by phone, competitor tool), the drafted first message in the profile's language (no link) and the follow-up with a tracked link to send after a reply. Nothing is sent by this tool.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many profiles. Clamped into 1..100. |
| platform | string | Only this platform. |
| campaign_id* | integer | Social campaign id. |
{
"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."
}
}
}Ad Strength of a client's responsive search ads: counts by level and the weak ads with Google's own action items.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| force_refresh | boolean | true queries Google live instead of using the stored snapshot. |
{
"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."
}
}
}Reads a Google App campaign and validates the videos proposed for it. Read-only.
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | 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. |
{
"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."
}
}
}Finds the same keyword and match type enabled in two or more active Google campaigns of one account. Detection only.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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).
| Argument | 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. |
{
"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."
}
}
}Return the field names and outcome values that push_lead_outcomes accepts, as the server currently defines them.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Return aggregate lead counts by pipeline stage over a recent window, for the whole organization or for one client.
| Argument | 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. |
{
"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."
}
}
}Pulls a client's Meta instant-form leads into ADS Beast now (scored, de-duplicated, forwarded to the client's webhooks). Idempotent.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| lookback_hours | integer | How far back to look. |
{
"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."
}
}
}Shows which Meta instant-form leads of a client would be imported. Read-only.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| lookback_hours | integer | How far back to look. |
{
"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."
}
}
}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).
| Argument | 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 | |
| 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. |
| landing_page_url | string | Landing page URL. |
{
"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."
}
}
}Conversions, campaign groups and account details of a client's LinkedIn ad account.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | 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. |
{
"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."
}
}
}Builds in the campaign builder, newest first, as summaries: name, platform, type, status (draft, ready, paused, launched), budget, how many ad groups, ads and keywords, whether an assistant created it, whether it was already published, and the cabinet link. A key bound to one client lists only that client's builds.
| Argument | 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 | |
| client_id | integer | Only this client's builds (id from list_clients). |
{
"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)."
}
}
}Campaign types of the ADS Beast registry that an assistant may draft, per platform (google, meta, tiktok, linkedin, microsoft): the key to pass as campaign_type, the objective, required tracking, bid strategies and, under 'fields', exactly what a draft of that type needs with the platform's character limits. structure_check 'full' (Google Search, Meta) means the draft is validated the way the builder validates before publishing; 'basic' means only the common checks run. Call it with a platform before create_campaign_draft.
| Argument | Type | Description |
|---|---|---|
| platform | string | Only this platform's types. Without it every type is listed. |
{
"type": "object",
"properties": {
"platform": {
"enum": [
"google",
"meta",
"tiktok",
"linkedin",
"microsoft"
],
"type": "string",
"description": "Only this platform's types. Without it every type is listed."
}
}
}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.
| Argument | 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. |
{
"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."
}
}
}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}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Clients per page. |
| offset | integer | Clients to skip; use next_offset from the previous page. |
{
"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."
}
}
}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.
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Packs per page. |
| offset | integer | Packs to skip; use next_offset from the previous page. |
{
"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."
}
}
}Return a page of the email outreach campaigns, newest first, with their status, sender, offer pack, legal basis and daily limit. The reply is {campaigns, total, count, limit, offset, has_more, next_offset}; walk the pages with offset = next_offset. The letter itself is summarised as body_preview and body_chars; pass include_body = true for the full text.
| Argument | 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. |
{
"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."
}
}
}Change proposals waiting for a person (status pending by default), or their history. Each proposal shows what would change, why, and who proposed it.
| Argument | 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. |
{
"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."
}
}
}Return the client reports already generated in ADS Beast, newest first, with their type, period and client.
| Argument | 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. |
{
"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."
}
}
}Return the Instagram/TikTok/Facebook prospecting campaigns: offer, platforms, cities with message language, daily manual-send cap.
| Argument | 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. |
{
"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."
}
}
}Return the team tasks recorded in ADS Beast with their status, priority, assignee and the client they belong to.
| Argument | 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. |
{
"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."
}
}
}Return the event names an outbound webhook can subscribe to, for example lead.created, with what each one carries.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Return the outbound webhook endpoints registered for this organization, the events each one receives and its current delivery state.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Webhooks per page. |
| offset | integer | Webhooks to skip; use next_offset from the previous page. |
{
"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."
}
}
}Pixels, pages, lead forms and conversion events of a client's Meta ad account.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Targeting interests matching a keyword, with id, name, audience size and topic.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max records. |
| query* | string | Keyword, for example fitness or real estate. |
| client_id* | integer |
{
"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"
}
}
}Learning status of every active ad set of a client, with what holds learning back.
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| objective | string | Meta objective, OUTCOME_LEADS by default. |
| include_bot_audience | boolean | Also plan the bot exclusion audience. |
{
"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."
}
}
}UET tags, conversion goals and account details of a client's Microsoft Ads account.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| stage* | string | Stage to move the lead into. |
| lead_id* | integer | ADS Beast id of the lead to move. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | integer | Email campaign id. |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "integer",
"description": "Email campaign id."
}
}
}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: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare drafting social posts that announce a blog article of a client on the chosen channels. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare a new bid strategy for one campaign, with its target cost per conversion or target ROAS. target_cpa is in whole units of the account currency; the preview shows the figure the platform receives. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare a new monthly budget for one campaign. new_monthly_budget is in the ad account's own currency, in whole units (3000 means 3000.00, never cents or micros); the preview shows the daily amount and the exact figure the platform will receive. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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
}
}
}Prepare creating a full campaign in Google Ads or Meta from a campaign draft. The campaign is created PAUSED: it does not serve and spends nothing until a person enables it separately. The preview carries the rehearsal against the live account. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare switching one paused campaign back on. Enabling always waits for a person, whatever the client's write policy. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | Type | Description |
|---|---|---|
| reason* | string | Why, with numbers (shown to the approver). |
| campaign_id* | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"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."
}
}
}Prepare pausing one campaign. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | Type | Description |
|---|---|---|
| reason* | string | Why, with numbers (shown to the approver). |
| campaign_id* | integer | ADS Beast id from list_campaigns, not the platform's. |
{
"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."
}
}
}Prepare uploading a prepared ChatGPT Ads campaign to the platform. Everything is created paused and passes the policy check first; it spends nothing until its ads are approved and a person enables it. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare generating the monthly report for a client and emailing it to the client's address on record. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | Type | Description |
|---|---|---|
| reason* | string | Why, with numbers (shown to the approver). |
| client_id* | integer | |
| send_email | boolean | Send by email (default true). |
{
"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)."
}
}
}Prepare a refresh plan for an outdated page: what to rewrite, update or remove. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare adding videos to a Google App campaign. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare creating a conversion action in a client's Google Ads account; the result carries the tag code for the site. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}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: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | Type | Description |
|---|---|---|
| reason* | string | Why, with numbers (shown to the approver). |
| client_id* | integer |
{
"type": "object",
"required": [
"client_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"description": "Why, with numbers (shown to the approver)."
},
"client_id": {
"type": "integer"
}
}
}Prepare additional responsive search ads for a client's Google campaigns. New ads are created paused. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare a new ad set inside an existing Meta campaign. The ad set is created PAUSED. daily_budget is in whole units of the account currency (20 means 20.00); the preview shows the figure Meta receives. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare one custom audience (customer list, website pixel, app or offline) or one lookalike in a client's Meta account. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare website custom audiences and lookalikes in a client's Meta account. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | Type | Description |
|---|---|---|
| reason* | string | Why, with numbers (shown to the approver). |
| client_id* | integer | |
| audience_types | array | Audience types to create. |
{
"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."
}
}
}Prepare removing fraud-prone placements from every ad set of a client's active Meta campaigns. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare negative keywords for a client's Google Ads account: a shared list attached to the named campaigns, or to every enabled Search, Shopping and Display campaign. If it cannot be attached anywhere, nothing is left behind. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}Prepare publishing or scheduling a post on a client's connected social channel. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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. |
{
"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."
}
}
}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: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
| Argument | 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 | Channel languages, up to 8. |
| daily_budget_limit | number | Daily limit in the account currency. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| change* | string | |
| 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). |
{
"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)."
}
}
}Write the real outcome of leads back into ADS Beast so the ad platforms learn which leads became sales. Each row names a lead by lead_id, email or phone, and its outcome. dry_run defaults to true and reports what would change without writing; run it first. Unmatched rows are skipped unless create_missing is true. The lead's stage follows the outcome unless update_stage is false.
| Argument | 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 from lead_outcome_contract. |
| 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. |
{
"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."
}
}
}Open recommendation cards: agent advice and Meta's own cabinet advice, judged against the client's goal.
| Argument | 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 |
{
"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"
}
}
}Record a recommendation so ADS Beast checks in seven days whether it worked.
| Argument | 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. |
{
"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."
}
}
}For one page: relevant subreddits, two post drafts and the best time to post. A plan only; nothing is posted. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer | |
| content_url* | string | The page to promote. |
{
"type": "object",
"required": [
"client_id",
"content_url"
],
"properties": {
"client_id": {
"type": "integer"
},
"content_url": {
"type": "string",
"description": "The page to promote."
}
}
}New Reddit threads mentioning a client's brand, keywords or competitors, with sentiment and a draft reply. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Buyer-intent Reddit threads in a client's niche, ranked.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| client_id | integer | |
| thread_url* | string | Reddit thread URL. |
| brand_angle* | string | How the brand should be mentioned. |
{
"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."
}
}
}Reject a pending proposal with a short reason. Returns the proposal id and its new status.
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| proposal_id* | integer |
{
"type": "object",
"required": [
"proposal_id"
],
"properties": {
"reason": {
"type": "string"
},
"proposal_id": {
"type": "integer"
}
}
}Save a report for a client. With content: stores that text (Markdown). Without content: generates a 30-day campaign summary. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| title | string | Short title. |
| content | string | Full report text in Markdown. |
| client_id* | integer |
{
"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"
}
}
}Rewrites guidance for a page or text so AI answers can quote it: definition blocks, quotable statements, FAQ. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| url | string | https:// page URL. |
| content | string | The text, when there is no URL. |
| keyword | string | Target search query. |
| client_id | integer |
{
"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"
}
}
}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).
| Argument | 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. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| keyword* | string | Target search query. |
| client_id* | integer | |
| word_count | integer | Target length in words. |
{
"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."
}
}
}Backlink profile quality, toxic links and link-building opportunities. AI: 1 AI request.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Domain without scheme. |
| client_id | integer | |
| competitors | string | Competitor domains, comma-separated. |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain without scheme."
},
"client_id": {
"type": "integer"
},
"competitors": {
"type": "string",
"description": "Competitor domains, comma-separated."
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| geo | string | Country: SK. |
| url | string | https:// page URL. |
| keyword* | string | Target search query. |
| language | string | en, sk |
| client_id | integer |
{
"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"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.