ADS Beast
Server Details
Ad account audits, analytics, leads and campaign changes that run only from an approved preview.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- notformal/adsbeast-plugins
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Score is being calculated.
Available Tools
184 toolsab_test_createAInspect
Register an A/B test in ADS Beast to track its hypothesis and variants. It records the test; it does not change ads.
Inputs: name (required), hypothesis (required), what_tested (required), variant_a_name (required), +5 more.
aeo_content_optimizeBInspect
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.
Inputs: page_url (required), client_id (required), focus_query.
aeo_mention_opportunitiesCRead-onlyInspect
Fresh discussions where people ask for recommendations in a client's niche, with a suggested reply. AI: 1 AI request.
Inputs: client_id (required), limit.
aeo_visibility_scanARead-onlyInspect
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).
Inputs: client_id (required), competitors.
alerts_unread_countRead-onlyInspect
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.
Inputs: no named parameters.
analytics_ab_testsCRead-onlyInspect
A/B tests with their status and interim results.
Inputs: limit, status, client_id, campaign_id.
analytics_agency_briefingRead-onlyInspect
Morning briefing for the workspace: critical alerts, today's tasks and what needs attention now.
Inputs: no named parameters.
analytics_attributionBRead-onlyInspect
Time-decay multi-touch attribution for a client's campaigns: attributed conversions, attributed CPA and the lift against last click.
Inputs: client_id (required), days.
analytics_benchmarksARead-onlyInspect
Reference CTR, CPC, CPA and ROAS ranges for a platform and niche. Benchmarks are orientation, not a verdict on one account.
Inputs: platform (required), niche.
analytics_compare_periodsBRead-onlyInspect
Percentage change of every KPI between the current period and the one before it, by platform, with what got worse and what improved.
Inputs: client_id (required), platform, current_days, previous_days.
analytics_cross_client_insightsBRead-onlyInspect
Patterns and anomalies across clients: platforms that sag for most of them, shared niche problems, who outperforms.
Inputs: days, platform.
analytics_forecastRead-onlyInspect
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.
Inputs: client_id (required), campaign_id.
analytics_forecast_warningsCRead-onlyInspect
Campaigns expected to break a KPI target within days, from a linear trend.
Inputs: client_id (required).
analytics_growth_opportunitiesRead-onlyInspect
Campaigns ready to scale: ROAS well above target, CPA well below target, or budget left unused.
Inputs: client_id, min_roas_multiplier.
analytics_kpi_healthRead-onlyInspect
Quick status of all active campaigns: how many are on target and how many need attention.
Inputs: client_id.
analytics_media_planBRead-onlyInspect
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.
Inputs: platform (required), monthly_budget (required), objective_or_type (required), niche, +5 more.
analytics_portfolioARead-onlyInspect
Cross-client analysis of the whole portfolio: best and worst performers, platform trends, total spend. Takes up to a minute. AI: 1 AI request.
Inputs: days, platform.
analytics_summaryRead-onlyInspect
Spend, CTR, CPA and ROAS of one client over a period. Money is reported in the account currency and never summed across currencies.
Inputs: client_id (required), days, platform.
audit_accountBRead-onlyInspect
AI audit of a client's ad account on one platform or all of them. Takes 10-30 seconds. AI: 1 AI request.
Inputs: client_id (required), platform.
audit_ad_disapprovalsCRead-onlyInspect
Ads the platforms rejected, with the reason and the policy code.
Inputs: status, platform, client_id.
audit_campaign_healthCRead-onlyInspect
A 1-10 health score for each campaign of a client with the problems behind it.
Inputs: client_id (required).
audit_campaign_portfolioBRead-onlyInspect
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.
Inputs: client_id, only_active.
audit_campaign_qualityARead-onlyInspect
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.
Inputs: client_id (required).
audit_conversion_goalsARead-onlyInspect
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.
Inputs: client_id (required).
audit_google_adsRead-onlyInspect
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.
Inputs: client_id (required), depth.
audit_meta_adsBRead-onlyInspect
Full Meta Ads audit for a client: funnel structure, audiences, creatives, pixel health, conversion events, audience fatigue and Advantage+ setup. AI: 1 AI request.
Inputs: client_id (required).
audit_performance_coachARead-onlyInspect
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.
Inputs: client_id (required).
audit_trackingRead-onlyInspect
Tracking diagnostics for a client: pixel, GA4 and GTM mismatches on the landing page, conversion actions and the other tracking guards in one report.
Inputs: client_id (required).
audit_wasted_spendRead-onlyInspect
Campaigns that burn budget: spend with zero conversions, CPA above target, no clicks. Returns the amounts lost, in the account currency.
Inputs: days, client_id.
campaign_analyzeARead-onlyInspect
Deep analysis of one campaign: metrics, trends and recommendations. Takes up to a minute. AI: 1 AI request.
Inputs: campaign_id (required), days.
campaign_dashboard_summaryRead-onlyInspect
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.
Inputs: no named parameters.
campaign_diagnoseBRead-onlyInspect
Works through the possible causes of one KPI problem in a campaign: audience saturation, creative fatigue, landing page, bid strategy, seasonality, tracking.
Inputs: problem (required), campaign_id (required), days.
campaign_draft_detailsCRead-onlyInspect
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.
Inputs: build_id (required), client_id (required).
campaign_draft_editAInspect
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).
Inputs: build_id (required), client_id (required), name, ad_groups, +6 more.
campaign_draft_publish_checkARead-onlyInspect
Validates a campaign draft against the live ad account and reports exactly what publishing would create or change. Read-only rehearsal: nothing is written.
Inputs: build_id (required), client_id (required), platform_campaign_id.
campaign_history_analysisBRead-onlyInspect
What worked for a client before: average CPA and CTR, best campaigns and best audiences.
Inputs: client_id (required).
campaign_searchRead-onlyInspect
Campaigns filtered by client, platform, status or a substring of the name.
Inputs: limit, status, platform, client_id, +1 more.
campaign_strategy_expert_reviewRead-onlyInspect
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).
Inputs: client_id (required), geo, platform, objective, +2 more.
campaign_strategy_generateARead-onlyInspect
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).
Inputs: client_id (required), focus, horizon_months.
campaign_swarm_runsCRead-onlyInspect
Recent multi-agent campaign generation runs with status, platform and budget.
Inputs: limit, client_id.
campaign_type_coverageRead-onlyInspect
Which campaign types ADS Beast supports on each platform and how far: creation through the API, generation, validation.
Inputs: platform.
chatgpt_ads_draft_generateAInspect
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.
Inputs: business (required), geo, url, clusters, +3 more.
chatgpt_ads_policy_checkBRead-onlyInspect
Whether ChatGPT Ads policy admits this business and whether the texts fit the limits (title 50, body 100).
Inputs: url, body, text, title, +2 more.
chatgpt_ads_review_syncAInspect
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.
Inputs: chatgpt_campaign_id (required).
chatgpt_ads_statusRead-onlyInspect
Connected ChatGPT Ads accounts, campaigns, ad review statuses and what blocks delivery.
Inputs: client_id.
client_action_planBRead-onlyInspect
The action plan from the client's latest weekly deep-dive audit: findings labelled confirmed, inferred or hypothesis, open change proposals and open tasks.
Inputs: client_id (required).
client_data_freshnessARead-onlyInspect
When each client and platform was last synced. Call it before a deep analysis so stale data is named as stale.
Inputs: client_id.
client_goalsARead-onlyInspect
KPI goals (ROAS, CPA, CTR, CPC) with target, current value, progress and status. Without client_id: goals of every client.
Inputs: client_id.
client_history_searchBRead-onlyInspect
Full-text search over a client's earlier reports, audits and analyses.
Inputs: query (required), limit, client_id, report_type.
client_landing_scanARead-onlyInspect
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.
Inputs: url, client_id.
client_market_analysisARead-onlyInspect
The stored market analysis of a client: summary, competitor matrix, audience signals and the draft campaign strategy.
Inputs: client_id (required), section.
client_market_analysis_runARead-onlyInspect
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.
Inputs: client_id (required), force.
client_market_intel_searchBRead-onlyInspect
Semantic search over a client's indexed market data: its site, competitor profiles and the market report.
Inputs: query (required), client_id (required), top_k.
client_market_simulationCRead-onlyInspect
Status and report of the multi-agent market simulations requested for a client.
Inputs: client_id (required).
client_market_simulation_requestAInspect
Ask for a multi-agent market simulation for a client. It is queued as a request a person confirms, because it costs model usage.
Inputs: client_id (required), requirement (required).
client_memory_searchBRead-onlyInspect
Search the facts, decisions, preferences and brand notes ADS Beast has stored about clients.
Inputs: query (required), client_id.
client_overviewCRead-onlyInspect
One client with its campaigns, key metrics and goals.
Inputs: client_id (required).
competitor_ads_researchRead-onlyInspect
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.
Inputs: geo, niche, client_id.
competitor_aeo_benchmarkRead-onlyInspect
Compares how often AI models mention the client versus competitors for the same prompts. AI: 1 AI request.
Inputs: client_id (required), competitors.
competitor_listCRead-onlyInspect
Competitors on record with site, niche, collected ads and keywords.
Inputs: with_ads, client_id.
competitor_search_intelRead-onlyInspect
Searches the web for a competitor's ads, positioning, pricing, selling points and reviews.
Inputs: niche, aspect, client_id, competitor_domain.
competitor_site_analyzeBRead-onlyInspect
Reads one competitor site: selling points, prices, technology, pixels, call-to-action patterns and audience signals.
Inputs: url (required), client_id (required).
competitor_social_signalsRead-onlyInspect
A competitor's recent activity outside its site: YouTube, blog feed, public posts and community mentions.
Inputs: client_id (required), competitor_url (required).
create_campaign_draftAInspect
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.
Inputs: name (required), platform (required), client_id (required), campaign_type (required), +13 more.
create_webhookDestructiveInspect
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.
Inputs: url (required), name (required), events (required), client_id, +1 more.
creative_banner_quality_checkARead-onlyInspect
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.
Inputs: creative_id (required), platform, format_label.
creative_copy_generateAInspect
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.
Inputs: platform (required), client_id (required), tone, count, +1 more.
creative_copy_humanizeARead-onlyInspect
Scores a text 0-100 for signs of machine writing, lists the markers found and returns a cleaned version. It never invents facts.
Inputs: text (required), surface.
creative_fatigue_checkAInspect
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.
Inputs: client_id, campaign_id.
creative_fatigue_reportBRead-onlyInspect
Campaigns of a client with high frequency and falling CTR, ranked by how tired the creative is.
Inputs: client_id (required), threshold_frequency.
creative_image_analyzeBRead-onlyInspect
Reviews an ad image for platform fit, visual hierarchy, call-to-action legibility and brand fit. AI: 1 AI request.
Inputs: image_url (required), context, platform.
creative_prompt_templatesBRead-onlyInspect
A library of prompts for generating ad banners, filtered by business vertical and visual style.
Inputs: style, vertical.
execute_prepared_changeADestructiveInspect
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.
Inputs: preview_id (required).
get_agency_kitAgency Kit: everything about one client in one documentARead-onlyInspect
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.
Inputs: client_id (required).
get_campaignRead-onlyInspect
Return a single campaign by its ADS Beast id with its settings, budget, status and the native id it has on its platform.
Inputs: campaign_id (required).
get_campaign_draftARead-onlyInspect
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.
Inputs: draft_id (required).
get_clientRead-onlyInspect
Return a single client by its ADS Beast id: profile, budget, goals and connected advertising accounts.
Inputs: client_id (required).
get_job_resultARead-onlyInspect
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.
Inputs: job_id (required).
get_leadRead-onlyInspect
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.
Inputs: lead_id (required).
get_new_leadsRead-onlyInspect
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.
Inputs: limit, since, stage, offset, +3 more.
get_prepared_changeARead-onlyInspect
What became of a preview: still ready, expired, or submitted - and then the proposal's status (pending, executed, rejected, failed) with the execution result.
Inputs: preview_id (required).
get_social_queueRead-onlyInspect
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.
Inputs: campaign_id (required), limit, platform.
google_ads_ad_strengthBRead-onlyInspect
Ad Strength of a client's responsive search ads: counts by level and the weak ads with Google's own action items.
Inputs: client_id (required), force_refresh.
google_ads_app_videos_checkRead-onlyInspect
Reads a Google App campaign and validates the videos proposed for it. Read-only.
Inputs: client_id (required), campaign_id (required), title, account_id, +2 more.
google_ads_conversion_tracking_checkBRead-onlyInspect
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.
Inputs: name (required), client_id (required), category, account_id.
google_ads_keyword_overlapARead-onlyInspect
Finds the same keyword and match type enabled in two or more active Google campaigns of one account. Detection only.
Inputs: client_id (required).
google_ads_script_generateRead-onlyInspect
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).
Inputs: action (required), campaign_id (required), new_value.
lead_outcome_contractRead-onlyInspect
Return the field names and outcome values that push_lead_outcomes accepts, as the server currently defines them.
Inputs: no named parameters.
lead_pipeline_statsRead-onlyInspect
Return aggregate lead counts by pipeline stage over a recent window, for the whole organization or for one client.
Inputs: days, client_id.
leads_meta_ingestBInspect
Pulls a client's Meta instant-form leads into ADS Beast now (scored, de-duplicated, forwarded to the client's webhooks). Idempotent.
Inputs: client_id (required), lookback_hours.
leads_meta_ingest_checkBRead-onlyInspect
Shows which Meta instant-form leads of a client would be imported. Read-only.
Inputs: client_id (required), lookback_hours.
leads_quality_diagnoseARead-onlyInspect
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).
Inputs: platform (required), campaign_name (required), cpa, ctr, +7 more.
linkedin_ads_account_setupCRead-onlyInspect
Conversions, campaign groups and account details of a client's LinkedIn ad account.
Inputs: client_id (required).
list_alertsRead-onlyInspect
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.
Inputs: limit, offset, is_read, severity, +4 more.
list_campaign_draftsRead-onlyInspect
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.
Inputs: limit, offset, status, client_id.
list_campaignsRead-onlyInspect
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.
Inputs: limit, offset, platform, client_id, +1 more.
list_campaign_typesRead-onlyInspect
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.
Inputs: platform.
list_clientsRead-onlyInspect
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}.
Inputs: limit, offset.
list_lead_formsRead-onlyInspect
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.
Inputs: limit, offset, platform, client_id.
list_offer_packsRead-onlyInspect
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.
Inputs: limit, offset.
list_outreach_campaignsRead-onlyInspect
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.
Inputs: limit, offset, client_id, include_body.
list_proposalsRead-onlyInspect
Change proposals waiting for a person (status pending by default), or their history. Each proposal shows what would change, why, and who proposed it.
Inputs: limit, offset, status, client_id.
list_reportsRead-onlyInspect
Return the client reports already generated in ADS Beast, newest first, with their type, period and client.
Inputs: limit, offset, client_id, report_type.
list_social_campaignsRead-onlyInspect
Return the Instagram/TikTok/Facebook prospecting campaigns: offer, platforms, cities with message language, daily manual-send cap.
Inputs: limit, offset, client_id.
list_tasksRead-onlyInspect
Return the team tasks recorded in ADS Beast with their status, priority, assignee and the client they belong to.
Inputs: limit, offset, status, priority, +2 more.
list_webhook_eventsRead-onlyInspect
Return the event names an outbound webhook can subscribe to, for example lead.created, with what each one carries.
Inputs: no named parameters.
list_webhooksRead-onlyInspect
Return the outbound webhook endpoints registered for this organization, the events each one receives and its current delivery state.
Inputs: limit, offset.
meta_ads_account_setupCRead-onlyInspect
Pixels, pages, lead forms and conversion events of a client's Meta ad account.
Inputs: client_id (required).
meta_ads_interest_searchRead-onlyInspect
Targeting interests matching a keyword, with id, name, audience size and topic.
Inputs: query (required), client_id (required), limit.
meta_ads_learning_phaseBRead-onlyInspect
Learning status of every active ad set of a client, with what holds learning back.
Inputs: client_id (required), campaign_id, target_cpa_usd.
meta_ads_placement_safety_checkBRead-onlyInspect
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.
Inputs: client_id (required), objective, include_bot_audience.
microsoft_ads_account_setupCRead-onlyInspect
UET tags, conversion goals and account details of a client's Microsoft Ads account.
Inputs: client_id (required).
move_lead_stageInspect
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.
Inputs: stage (required), lead_id (required).
outreach_campaign_checkRead-onlyInspect
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.
Inputs: campaign_id (required).
prepare_ad_createAInspect
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.
Inputs: name (required), reason (required), campaign_id (required), body, +4 more.
prepare_article_distributionAInspect
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.
Inputs: reason (required), channels (required), article_id (required).
prepare_campaign_bid_strategy_changeAInspect
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.
Inputs: reason (required), campaign_id (required), bid_strategy (required), target_cpa, +1 more.
prepare_campaign_budget_changeAInspect
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.
Inputs: reason (required), campaign_id (required), new_monthly_budget (required), currency.
prepare_campaign_draft_publishAInspect
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.
Inputs: reason (required), build_id (required), client_id (required), platform_campaign_id.
prepare_campaign_enableAInspect
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.
Inputs: reason (required), campaign_id (required).
prepare_campaign_pauseAInspect
Prepare pausing one campaign. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Inputs: reason (required), campaign_id (required).
prepare_chatgpt_ads_publishAInspect
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.
Inputs: reason (required), chatgpt_campaign_id (required).
prepare_client_report_sendAInspect
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.
Inputs: reason (required), client_id (required), send_email.
prepare_content_refreshAInspect
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.
Inputs: url (required), reason (required), content, client_id, +1 more.
prepare_google_app_videos_addAInspect
Prepare adding videos to a Google App campaign. Changes nothing: stores a preview_id (15 min, single use) to show, then execute_prepared_change.
Inputs: reason (required), client_id (required), campaign_id (required), title, +3 more.
prepare_google_conversion_action_createAInspect
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.
Inputs: name (required), reason (required), client_id (required), category, +1 more.
prepare_google_keyword_overlap_fixAInspect
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.
Inputs: reason (required), client_id (required).
prepare_google_rsa_variationsAInspect
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.
Inputs: reason (required), client_id (required), ad_variations (required), campaign_ids, +4 more.
prepare_meta_ad_set_createAInspect
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.
Inputs: name (required), reason (required), targeting (required), campaign_id (required), +2 more.
prepare_meta_audience_createAInspect
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.
Inputs: name (required), reason (required), client_id (required), audience_type (required), +6 more.
prepare_meta_audiences_createAInspect
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.
Inputs: reason (required), client_id (required), audience_types.
prepare_meta_placement_safety_applyAInspect
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.
Inputs: reason (required), client_id (required), objective, include_bot_audience.
prepare_negative_keywords_addAInspect
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.
Inputs: reason (required), keywords (required), client_id (required), list_name, +1 more.
prepare_social_post_scheduleAInspect
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.
Inputs: text (required), reason (required), platform (required), client_id (required), +2 more.
prepare_telegram_ad_publishAInspect
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.
Inputs: cpm (required), title (required), reason (required), account_id (required), +7 more.
propose_campaign_changePropose a campaign change (pause, enable, budget)Inspect
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.
Inputs: change (required), reason (required), campaign_id (required), client_id, +1 more.
push_lead_outcomesDestructiveInspect
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.
Inputs: rows (required), dry_run, client_id, update_stage, +2 more.
recommendation_listBRead-onlyInspect
Open recommendation cards: agent advice and Meta's own cabinet advice, judged against the client's goal.
Inputs: limit, source, platform, client_id.
recommendation_saveAInspect
Record a recommendation so ADS Beast checks in seven days whether it worked.
Inputs: action (required), metric (required), client_id, reasoning, +3 more.
reddit_amplification_planARead-onlyInspect
For one page: relevant subreddits, two post drafts and the best time to post. A plan only; nothing is posted. AI: 1 AI request.
Inputs: client_id (required), content_url (required).
reddit_mentions_monitorARead-onlyInspect
New Reddit threads mentioning a client's brand, keywords or competitors, with sentiment and a draft reply. AI: 1 AI request.
Inputs: client_id (required).
reddit_opportunitiesCRead-onlyInspect
Buyer-intent Reddit threads in a client's niche, ranked.
Inputs: client_id (required).
reddit_reply_draftAInspect
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.
Inputs: thread_url (required), brand_angle (required), client_id.
reject_proposalInspect
Reject a pending proposal with a short reason. Returns the proposal id and its new status.
Inputs: proposal_id (required), reason.
report_createAInspect
Save a report for a client. With content: stores that text (Markdown). Without content: generates a 30-day campaign summary. AI: 1 AI request.
Inputs: client_id (required), title, content.
seo_ai_citation_optimizeARead-onlyInspect
Rewrites guidance for a page or text so AI answers can quote it: definition blocks, quotable statements, FAQ. AI: 1 AI request.
Inputs: url, content, keyword, client_id.
seo_alerts_configureAInspect
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).
Inputs: domain (required), client_id, key_keywords, baseline_traffic, +1 more.
seo_article_generateBInspect
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.
Inputs: keyword (required), client_id (required), word_count.
seo_backlink_analysisCRead-onlyInspect
Backlink profile quality, toxic links and link-building opportunities. AI: 1 AI request.
Inputs: domain (required), client_id, competitors.
seo_brief_generateARead-onlyInspect
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).
Inputs: keyword (required), geo, url, language, +1 more.
seo_competitor_analysisCRead-onlyInspect
Competitors' search presence, content strategy, links and AI visibility, with gaps and opportunities. AI: 1 AI request.
Inputs: competitors (required), geo, niche, domain, +1 more.
seo_content_gapARead-onlyInspect
Topics competitors cover and this site does not, with an action plan. AI: 1 AI request. May return a job_id (get_job_result).
Inputs: geo, niche, domain, client_id, +1 more.
seo_content_quality_auditBRead-onlyInspect
An 80-criteria content quality audit (clarity, organisation, referenceability, experience, expertise, authority, trust) for a URL or a text. AI: 1 AI request.
Inputs: url, content, client_id, content_type.
seo_content_writeAInspect
Writes search- and AI-citation-ready content on a topic and saves it as a draft. Takes up to a minute. AI: 1 AI request. May return a job_id (get_job_result).
Inputs: topic (required), geo, client_id, word_count, +1 more.
seo_domain_authority_auditBRead-onlyInspect
A 40-criteria audit of domain authority: citation, identity, trust and eminence. AI: 1 AI request.
Inputs: domain (required), client_id, site_type.
seo_entity_auditCRead-onlyInspect
How well a brand is established as an entity for Google's Knowledge Graph and AI systems, with a plan to build it. AI: 1 AI request.
Inputs: brand_name (required), domain, industry, client_id.
seo_internal_links_auditCRead-onlyInspect
Orphan and weakly linked pages with the internal links to add. AI: 1 AI request.
Inputs: domain (required), client_id, key_pages.
seo_keyword_rank_checkBRead-onlyInspect
A site's Google position for one keyword with the matched URL, SERP features and the top ten.
Inputs: domain (required), keyword (required), gl, hl.
seo_keyword_researchBRead-onlyInspect
Keyword clusters with intent, priority and AI-citation potential for a topic. AI: 1 AI request.
Inputs: topic (required), geo, language, client_id, +1 more.
seo_keywords_trackBInspect
Checks positions now, records them and reports changes and quick wins. AI: 1 AI request.
Inputs: geo, domain, keywords, client_id.
seo_meta_tags_optimizeBInspect
Returns improved title, meta description, Open Graph and Twitter Card tags for a page and stores the suggestion. AI: 1 AI request.
Inputs: url (required), keyword, client_id, brand_name, +1 more.
seo_on_page_auditBRead-onlyInspect
One page audited across title, meta description, headings, content, keywords, internal links, images and technical basics. AI: 1 AI request.
Inputs: url (required), keyword, client_id.
seo_performance_reportCRead-onlyInspect
An SEO and AI-visibility report for a client or domain. AI: 1 AI request.
Inputs: domain, period, client_id, report_type.
seo_publish_safetyRead-onlyInspect
Ask this before publishing or scheduling any article for a site. Returns its gradual-launch state: articles allowed today and already published, whether publishing is paused and why, and indexed versus kept-out articles. Rules: 2 new articles a day at start, plus 1 a week up to 6; one language version of a topic a day; search visits below 30% of the weekly median pause publishing until a person lifts it; articles under 600 words, without a meta description or reusing another language's address get noindex and stay out of the sitemap. Do not plan around these limits: mass near-identical pages is how sites lose Google traffic overnight.
Inputs: client_id.
seo_rank_changesRead-onlyInspect
Position changes over 7-30 days: winners, drops and keywords in positions 11-30.
Inputs: client_id (required), days.
seo_researchBRead-onlyInspect
Keyword clusters, audience pain points, pre-purchase questions and competitor analysis for a client's site. Takes minutes. AI: 1 AI request. May return a job_id (get_job_result).
Inputs: client_id (required), max_parallel, competitor_urls.
seo_schema_generateBInspect
Schema.org JSON-LD for a page (FAQ, HowTo, Article, Product, LocalBusiness, Organization), stored as a suggestion. AI: 1 AI request.
Inputs: url, content, client_id, brand_name, +1 more.
seo_serp_analysisBRead-onlyInspect
What ranks for a query and why: content types, featured snippets, AI overviews, People Also Ask. AI: 1 AI request.
Inputs: keyword (required), geo, language, client_id.
seo_site_checkCInspect
Positions, technical state and a prioritised task list for a client's site; the tasks are saved in ADS Beast.
Inputs: client_id (required), website_url.
seo_technical_auditCRead-onlyInspect
Core Web Vitals, crawlability, indexability, structured data, redirects, canonicals, mobile, HTTPS, robots.txt and sitemap. AI: 1 AI request.
Inputs: url (required), depth, client_id.
task_createCInspect
Create a task for the team in ADS Beast.
Inputs: title (required), priority (required), category, due_date, +2 more.
task_suggestAInspect
Scans clients for unanswered critical alerts, KPI goals at risk, campaigns without metrics and projected overspend, and creates tasks for the team. dry_run=true only lists what it found.
Inputs: dry_run, client_id.
telegram_ads_draft_generateAInspect
Builds a ready-to-submit Telegram ad within the 160-character limit with bid, budget and an impressions estimate, and reports whether it passes preflight. Amounts are in the Telegram account currency.
Inputs: text (required), cpm, title, budget, +7 more.
telegram_ads_policy_checkARead-onlyInspect
Checks a sponsored message against Telegram's prohibited categories, the 160-character text limit, the title limit and the link format.
Inputs: text (required), cpm, title, currency, +3 more.
telegram_ads_publish_taskAInspect
Creates a task for an operator to paste a checked ad into ads.telegram.org by hand. The path for accounts without an API token.
Inputs: text (required), promote_url (required), campaign_name (required), cpm, +5 more.
telegram_ads_statusRead-onlyInspect
Connected Telegram Ads accounts, their goal and currency, and what is automated versus done by hand.
Inputs: client_id.
telegram_ads_targetingBRead-onlyInspect
Languages, topics with their ids and countries, read from Telegram Ads itself for one connected account.
Inputs: account_id (required).
telegram_ads_verify_channelBRead-onlyInspect
Whether a channel exists, is public and how many subscribers it has.
Inputs: username (required).
tiktok_ads_account_setupCRead-onlyInspect
Pixels, identities and account details of a client's TikTok ad account.
Inputs: client_id (required).
update_campaign_draftAInspect
Replace fields of a draft that was created with create_campaign_draft and has not been published: each field passed replaces the stored one whole (ad_groups replaces all ad groups). Returns the draft with a fresh validation. Drafts made by a person in the builder and builds that were already published are refused. Nothing is sent to the ad platform.
Inputs: draft_id (required), geo, name, extra, +11 more.
update_leadInspect
Change fields on one existing lead: notes, assignee, contact details or pipeline stage. Only the keys supplied are written; the rest of the record is left as it is. A key that is not writable is refused with the list of fields that are, so a misspelled field cannot pass as a successful write.
Inputs: fields (required), lead_id (required).
update_social_prospectInspect
Record the outcome of a hand-sent message: sent, replied, registered, declined, do_not_contact, skipped (or new to undo a mis-click), plus an optional note. Moves follow the pipeline (sent -> replied -> registered); 'sent' is refused once today's per-platform cap is used. This records a fact, it does not message anyone.
Inputs: prospect_id (required), note, status.
whoamiRead-onlyInspect
Report the name of the API key in use, the ADS Beast organization it belongs to, the scopes it carries and, in one line, whether it is read-only or can propose changes. The scope list is what a 403 from any other tool in this server refers to: a key without read:leads reaches no lead tool, whatever else it holds.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Google Ads MCP server with Reddit Ads, GA4 and Tag Manager. Every change is previewed first.
Ad, SMM, SEO and market analytics for one account owner; drafts only, owner approves in dashboard.
Ad platform character limits, creative specs, A/B significance, UTM and policy checks. No account.
1Build, edit, transfer and report on ad campaigns across Meta, Google Ads, TikTok, Snapchat, LinkedIn, Reddit, X, Microsoft Ads, DV360, Criteo, Apple Ads and Amazon Ads, with GA4 and Search Console. Ad-platform writes start as dry-run previews; live and destructive changes need explicit confirmation.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables read-only Meta Ads reporting and diagnostics, plus safe, preview-before-apply mutations such as campaign creation, duplication, targeting replacement, and attribution changes.-
- AlicenseNot gradedqualityBmaintenanceEnables checking whether a Meta, LinkedIn, or Google Ads campaign is structurally able to serve and convert before spending, by inspecting schedule, bid, destination, approval, geo, and budget fields through read-only tools. It also reconciles reported spend across the three platforms against a ledger to surface discrepancies, armed campaigns, and drift.16 npmMIT
- AlicenseAqualityCmaintenanceEnables managing Instagram and Facebook campaigns, ad sets, ads, creatives, and audiences for a single Meta ad account, plus reading performance insights and Instagram media, with confirmation guards that keep every write paused and explicitly approved.10MIT
- AlicenseBqualityBmaintenanceEnables an AI assistant to read and audit a user's own ad account, preview and apply carefully bounded changes, and turn creator ad codes into paused ads. Runs locally with safety limits, approval tokens, and a change log.851,842 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.
social_calendarRead-only Inspect
Scheduled and published social posts of a client.
Inputs: client_id (required), status, platform.