Skip to main content
Glama

ADS Beast

Server Details

Ad account audits, analytics, leads and campaign changes that run only from an approved preview.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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 tools
ab_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_opportunitiesC
Read-only
Inspect

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_scanA
Read-only
Inspect

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_count
Read-only
Inspect

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_testsC
Read-only
Inspect

A/B tests with their status and interim results.

Inputs: limit, status, client_id, campaign_id.

analytics_agency_briefing
Read-only
Inspect

Morning briefing for the workspace: critical alerts, today's tasks and what needs attention now.

Inputs: no named parameters.

analytics_attributionB
Read-only
Inspect

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_benchmarksA
Read-only
Inspect

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_periodsB
Read-only
Inspect

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_insightsB
Read-only
Inspect

Patterns and anomalies across clients: platforms that sag for most of them, shared niche problems, who outperforms.

Inputs: days, platform.

analytics_forecast
Read-only
Inspect

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_warningsC
Read-only
Inspect

Campaigns expected to break a KPI target within days, from a linear trend.

Inputs: client_id (required).

analytics_growth_opportunities
Read-only
Inspect

Campaigns ready to scale: ROAS well above target, CPA well below target, or budget left unused.

Inputs: client_id, min_roas_multiplier.

analytics_kpi_health
Read-only
Inspect

Quick status of all active campaigns: how many are on target and how many need attention.

Inputs: client_id.

analytics_media_planB
Read-only
Inspect

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_portfolioA
Read-only
Inspect

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_summary
Read-only
Inspect

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_accountB
Read-only
Inspect

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_disapprovalsC
Read-only
Inspect

Ads the platforms rejected, with the reason and the policy code.

Inputs: status, platform, client_id.

audit_campaign_healthC
Read-only
Inspect

A 1-10 health score for each campaign of a client with the problems behind it.

Inputs: client_id (required).

audit_campaign_portfolioB
Read-only
Inspect

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_qualityA
Read-only
Inspect

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_goalsA
Read-only
Inspect

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_ads
Read-only
Inspect

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_adsB
Read-only
Inspect

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_coachA
Read-only
Inspect

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_tracking
Read-only
Inspect

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_spend
Read-only
Inspect

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_analyzeA
Read-only
Inspect

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_summary
Read-only
Inspect

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_diagnoseB
Read-only
Inspect

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_detailsC
Read-only
Inspect

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_checkA
Read-only
Inspect

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_analysisB
Read-only
Inspect

What worked for a client before: average CPA and CTR, best campaigns and best audiences.

Inputs: client_id (required).

campaign_strategy_expert_review
Read-only
Inspect

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_generateA
Read-only
Inspect

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_runsC
Read-only
Inspect

Recent multi-agent campaign generation runs with status, platform and budget.

Inputs: limit, client_id.

campaign_type_coverage
Read-only
Inspect

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_checkB
Read-only
Inspect

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_status
Read-only
Inspect

Connected ChatGPT Ads accounts, campaigns, ad review statuses and what blocks delivery.

Inputs: client_id.

client_action_planB
Read-only
Inspect

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_freshnessA
Read-only
Inspect

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_goalsA
Read-only
Inspect

KPI goals (ROAS, CPA, CTR, CPC) with target, current value, progress and status. Without client_id: goals of every client.

Inputs: client_id.

client_landing_scanA
Read-only
Inspect

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_analysisA
Read-only
Inspect

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_runA
Read-only
Inspect

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_simulationC
Read-only
Inspect

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_overviewC
Read-only
Inspect

One client with its campaigns, key metrics and goals.

Inputs: client_id (required).

competitor_ads_research
Read-only
Inspect

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_benchmark
Read-only
Inspect

Compares how often AI models mention the client versus competitors for the same prompts. AI: 1 AI request.

Inputs: client_id (required), competitors.

competitor_listC
Read-only
Inspect

Competitors on record with site, niche, collected ads and keywords.

Inputs: with_ads, client_id.

competitor_search_intel
Read-only
Inspect

Searches the web for a competitor's ads, positioning, pricing, selling points and reviews.

Inputs: niche, aspect, client_id, competitor_domain.

competitor_site_analyzeB
Read-only
Inspect

Reads one competitor site: selling points, prices, technology, pixels, call-to-action patterns and audience signals.

Inputs: url (required), client_id (required).

competitor_social_signals
Read-only
Inspect

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_webhook
Destructive
Inspect

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_checkA
Read-only
Inspect

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_humanizeA
Read-only
Inspect

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_reportB
Read-only
Inspect

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_analyzeB
Read-only
Inspect

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_templatesB
Read-only
Inspect

A library of prompts for generating ad banners, filtered by business vertical and visual style.

Inputs: style, vertical.

execute_prepared_changeA
Destructive
Inspect

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 documentA
Read-only
Inspect

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_campaign
Read-only
Inspect

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_draftA
Read-only
Inspect

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_client
Read-only
Inspect

Return a single client by its ADS Beast id: profile, budget, goals and connected advertising accounts.

Inputs: client_id (required).

get_job_resultA
Read-only
Inspect

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_lead
Read-only
Inspect

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_leads
Read-only
Inspect

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_changeA
Read-only
Inspect

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_queue
Read-only
Inspect

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.

lead_outcome_contract
Read-only
Inspect

Return the field names and outcome values that push_lead_outcomes accepts, as the server currently defines them.

Inputs: no named parameters.

lead_pipeline_stats
Read-only
Inspect

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_checkB
Read-only
Inspect

Shows which Meta instant-form leads of a client would be imported. Read-only.

Inputs: client_id (required), lookback_hours.

leads_quality_diagnoseA
Read-only
Inspect

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_setupC
Read-only
Inspect

Conversions, campaign groups and account details of a client's LinkedIn ad account.

Inputs: client_id (required).

list_alerts
Read-only
Inspect

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_drafts
Read-only
Inspect

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_campaigns
Read-only
Inspect

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_types
Read-only
Inspect

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_clients
Read-only
Inspect

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_forms
Read-only
Inspect

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_packs
Read-only
Inspect

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_campaigns
Read-only
Inspect

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_proposals
Read-only
Inspect

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_reports
Read-only
Inspect

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_campaigns
Read-only
Inspect

Return the Instagram/TikTok/Facebook prospecting campaigns: offer, platforms, cities with message language, daily manual-send cap.

Inputs: limit, offset, client_id.

list_tasks
Read-only
Inspect

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_events
Read-only
Inspect

Return the event names an outbound webhook can subscribe to, for example lead.created, with what each one carries.

Inputs: no named parameters.

list_webhooks
Read-only
Inspect

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_setupC
Read-only
Inspect

Pixels, pages, lead forms and conversion events of a client's Meta ad account.

Inputs: client_id (required).

meta_ads_learning_phaseB
Read-only
Inspect

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_checkB
Read-only
Inspect

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_setupC
Read-only
Inspect

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_check
Read-only
Inspect

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_outcomes
Destructive
Inspect

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_listB
Read-only
Inspect

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_planA
Read-only
Inspect

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_monitorA
Read-only
Inspect

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_opportunitiesC
Read-only
Inspect

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_optimizeA
Read-only
Inspect

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_brief_generateA
Read-only
Inspect

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_analysisC
Read-only
Inspect

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_gapA
Read-only
Inspect

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_auditB
Read-only
Inspect

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_auditB
Read-only
Inspect

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_auditC
Read-only
Inspect

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_keyword_rank_checkB
Read-only
Inspect

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_researchB
Read-only
Inspect

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_auditB
Read-only
Inspect

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_reportC
Read-only
Inspect

An SEO and AI-visibility report for a client or domain. AI: 1 AI request.

Inputs: domain, period, client_id, report_type.

seo_publish_safety
Read-only
Inspect

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_changes
Read-only
Inspect

Position changes over 7-30 days: winners, drops and keywords in positions 11-30.

Inputs: client_id (required), days.

seo_researchB
Read-only
Inspect

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_analysisB
Read-only
Inspect

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_auditC
Read-only
Inspect

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.

social_calendar
Read-only
Inspect

Scheduled and published social posts of a client.

Inputs: client_id (required), status, platform.

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_checkA
Read-only
Inspect

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_status
Read-only
Inspect

Connected Telegram Ads accounts, their goal and currency, and what is automated versus done by hand.

Inputs: client_id.

telegram_ads_targetingB
Read-only
Inspect

Languages, topics with their ids and countries, read from Telegram Ads itself for one connected account.

Inputs: account_id (required).

telegram_ads_verify_channelB
Read-only
Inspect

Whether a channel exists, is public and how many subscribers it has.

Inputs: username (required).

tiktok_ads_account_setupC
Read-only
Inspect

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.

whoami
Read-only
Inspect

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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only Meta Ads reporting and diagnostics, plus safe, preview-before-apply mutations such as campaign creation, duplication, targeting replacement, and attribution changes.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      10
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      85
      1,842 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.