Cookies

We use cookies to sign you in (required) and for analytics (optional). More - Privacy Policy.

ADS Beast for AI assistants

ADS Beast MCP server

MCP is the protocol AI assistants use to call outside tools. ADS Beast runs two MCP servers: one with ad checks that need no account, and one that opens your own workspace to the assistant you already use.

Two servers

Open tools

No account and no key. Platform limits for ad copy and creatives, UTM tagging, an A/B significance test, budget and policy checks.

URL

https://adsbeast.pro/api/mcp

Account tools

Your organization in ADS Beast: campaigns, clients, leads, reports, alerts, tasks, webhooks. Needs an API key with scopes.

URL

https://adsbeast.pro/api/mcp/workspace
Transport
Streamable HTTP, JSON-RPC 2.0
Sign-in

An API key that starts with absk_, sent as Authorization: Bearer absk_... or X-API-Key. The key belongs to one organization and carries scopes.

Sign-in without a key (OAuth) is built, but it is not switched on in production yet. Until then, connect with a key.

Connect your assistant

One page per client: steps, a config to copy and a first prompt.

What an assistant can do

  • Read campaigns from every connected ad platform in one list, with spend and delivery, in the currency of each ad account.
  • Pull new leads with their source, UTM tags and the form they came from, and move a lead through the pipeline.
  • Send the real outcome of leads back, so ad platforms learn which leads became customers. This starts as a dry run.
  • Read clients, reports, alerts and tasks, and the knowledge pack the agency keeps for a client.
  • Build a campaign as a draft in the campaign builder and get the validation result in words.
  • Propose to pause or enable a campaign or to change its budget, with a reason.

How changes are controlled

  • A change to an ad account is a proposal with its exact content and a reason. By default it runs only after a person approves that proposal in ADS Beast. The owner can let reversible changes, such as a pause, apply on their own for a client.
  • A tool that changes an ad account first stores a preview: the exact change with the values before and after. The preview lives 15 minutes and works once. The change can be requested only by the id of that preview, and it is refused if the campaign has changed since.
  • A key or an assistant cannot approve, bulk-approve or roll back. Those actions are closed to integrations on the server, whatever the assistant is told.
  • A campaign built by an assistant stays a draft. A person opens it, reads what the check found and publishes it, and it is created paused.
  • Observe-only mode for a client and the emergency stop of the workspace hold for assistants as they do for our own agents.
  • Each tool needs its own scope. A missing scope answers 403 instead of returning less data.

Tools on the servers now

The account server lists 186 tools and the open server 9.

The list is read from the servers, not typed by hand, so it grows when the servers do. Names and descriptions are shown in English, as the servers return them.

Account tools (186)
  • whoamireads

    Describe the current API key

  • get_new_leadsreads

    Pull leads, including newly created ones

  • get_leadreads

    Get one lead

  • list_lead_formsreads

    List known lead forms

  • lead_pipeline_statsreads

    Summarise the lead pipeline

  • lead_outcome_contractreads

    Get the accepted outcome fields

  • update_leadwrites

    Update a lead

  • move_lead_stagewrites

    Move a lead to another stage

  • push_lead_outcomeswrites

    Push CRM outcomes back into the pipeline

  • list_campaignsreads

    List campaigns

  • get_campaignreads

    Get one campaign

  • campaign_dashboard_summaryreads

    Summarise spend and delivery

  • list_clientsreads

    List clients

  • get_clientreads

    Get one client

  • list_reportsreads

    List generated reports

  • list_alertsreads

    List monitoring alerts

  • alerts_unread_countreads

    Count unread alerts

  • list_tasksreads

    List team tasks

  • list_outreach_campaignsreads

    List email outreach campaigns

  • outreach_campaign_checkreads

    Check an email campaign before launch

  • list_offer_packsreads

    List offer packs

  • list_social_campaignsreads

    List social prospecting campaigns

  • get_social_queuereads

    Get the social outreach queue

  • update_social_prospectwrites

    Record what happened with a social prospect

  • list_webhook_eventsreads

    List subscribable events

  • list_webhooksreads

    List registered webhooks

  • create_webhookwrites

    Register an outbound webhook

  • seo_publish_safetyreads

    Check whether a site may publish now

  • list_proposalsreads

    List change proposals

  • propose_campaign_changewrites

    Propose a campaign change (pause, enable, budget)

  • reject_proposalwrites

    Reject a change proposal

  • list_campaign_typesreads

    Campaign types that can be drafted

  • list_campaign_draftsreads

    List campaign builds and drafts

  • get_campaign_draftreads

    One campaign draft with its validation

  • create_campaign_draftwrites

    Create a campaign draft in the builder

  • update_campaign_draftwrites

    Change a campaign draft the assistant created

  • get_agency_kitreads

    Agency Kit: everything about one client in one document

  • client_overviewreads

    Client overview

  • client_action_planreads

    Client action plan

  • client_goalsreads

    Client KPI goals

  • client_data_freshnessreads

    Data freshness

  • client_memory_searchreads

    Search client memory

  • client_history_searchreads

    Search past reports and audits

  • client_landing_scanreads

    Scan a client's landing page

  • client_market_analysisreads

    Get market analysis

  • client_market_analysis_runreads

    Run market analysis

  • client_market_intel_searchreads

    Search market intelligence

  • client_market_simulationreads

    Get market simulation

  • analytics_summaryreads

    Performance summary

  • analytics_compare_periodsreads

    Compare two periods

  • analytics_forecastreads

    Forecast KPIs

  • analytics_forecast_warningsreads

    Forecast warnings

  • analytics_attributionreads

    Attribution breakdown

  • analytics_portfolioreads

    Portfolio analysis

  • analytics_cross_client_insightsreads

    Cross-client insights

  • analytics_kpi_healthreads

    KPI health check

  • analytics_growth_opportunitiesreads

    Growth opportunities

  • analytics_benchmarksreads

    Industry benchmarks

  • analytics_agency_briefingreads

    Daily briefing

  • analytics_media_planreads

    Media plan numbers

  • analytics_ab_testsreads

    List A/B tests

  • audit_accountreads

    Audit an ad account

  • audit_google_adsreads

    Audit Google Ads

  • audit_meta_adsreads

    Audit Meta Ads

  • audit_conversion_goalsreads

    Audit conversion goals

  • audit_trackingreads

    Audit tracking setup

  • audit_campaign_qualityreads

    Live campaign quality check

  • audit_wasted_spendreads

    Find wasted spend

  • audit_campaign_portfolioreads

    Scan campaign portfolio

  • audit_campaign_healthreads

    Campaign health summary

  • audit_performance_coachreads

    Performance coaching review

  • audit_ad_disapprovalsreads

    List disapproved ads

  • campaign_searchreads

    Search campaigns by name

  • campaign_analyzereads

    Analyse a campaign

  • campaign_diagnosereads

    Diagnose a campaign problem

  • campaign_history_analysisreads

    Analyse campaign history

  • campaign_type_coveragereads

    Campaign type coverage

  • campaign_strategy_generatereads

    Generate a strategy

  • campaign_strategy_expert_reviewreads

    Expert strategy review

  • campaign_swarm_runsreads

    List campaign generation runs

  • campaign_draft_detailsreads

    Full campaign draft

  • campaign_draft_publish_checkreads

    Rehearse publishing a draft

  • google_ads_ad_strengthreads

    Google ad strength

  • google_ads_keyword_overlapreads

    Find duplicate keywords

  • google_ads_script_generatereads

    Generate a Google Ads script

  • google_ads_conversion_tracking_checkreads

    Check Google conversion tracking

  • google_ads_app_videos_checkreads

    Check videos for an App campaign

  • meta_ads_account_setupreads

    Meta account setup

  • meta_ads_interest_searchreads

    Search Meta interests

  • meta_ads_learning_phasereads

    Meta learning phase

  • meta_ads_placement_safety_checkreads

    Check risky Meta placements

  • tiktok_ads_account_setupreads

    TikTok account setup

  • linkedin_ads_account_setupreads

    LinkedIn account setup

  • microsoft_ads_account_setupreads

    Microsoft Ads account setup

  • telegram_ads_statusreads

    Telegram Ads status

  • telegram_ads_policy_checkreads

    Check a Telegram ad

  • telegram_ads_verify_channelreads

    Verify a Telegram channel

  • telegram_ads_targetingreads

    Telegram targeting options

  • chatgpt_ads_statusreads

    ChatGPT Ads status

  • chatgpt_ads_policy_checkreads

    Check a ChatGPT ad

  • creative_fatigue_reportreads

    Creative fatigue report

  • creative_image_analyzereads

    Analyse an ad image

  • creative_banner_quality_checkreads

    Check a banner's quality

  • creative_prompt_templatesreads

    Banner prompt templates

  • creative_copy_humanizereads

    Check copy for AI tells

  • competitor_listreads

    List competitors

  • competitor_search_intelreads

    Research competitors

  • competitor_ads_researchreads

    Research competitor ads

  • competitor_site_analyzereads

    Analyse a competitor site

  • competitor_social_signalsreads

    Competitor social signals

  • competitor_aeo_benchmarkreads

    AI visibility benchmark

  • leads_quality_diagnosereads

    Diagnose lead quality

  • leads_meta_ingest_checkreads

    Check Meta leads waiting

  • social_calendarreads

    Social content calendar

  • seo_researchreads

    SEO research

  • seo_rank_changesreads

    Keyword rank changes

  • seo_brief_generatereads

    Generate an SEO brief

  • seo_keyword_rank_checkreads

    Check a keyword position

  • seo_keyword_researchreads

    Keyword research

  • seo_content_gapreads

    Content gap analysis

  • seo_performance_reportreads

    SEO performance report

  • seo_backlink_analysisreads

    Backlink analysis

  • seo_competitor_analysisreads

    SEO competitor analysis

  • seo_serp_analysisreads

    SERP analysis

  • seo_technical_auditreads

    Technical SEO audit

  • seo_on_page_auditreads

    On-page SEO audit

  • seo_internal_links_auditreads

    Internal links audit

  • seo_content_quality_auditreads

    Content quality audit

  • seo_domain_authority_auditreads

    Domain authority audit

  • seo_entity_auditreads

    Brand entity audit

  • seo_ai_citation_optimizereads

    Optimise for AI citation

  • aeo_visibility_scanreads

    AI visibility scan

  • aeo_mention_opportunitiesreads

    Find mention opportunities

  • reddit_mentions_monitorreads

    Monitor Reddit mentions

  • reddit_opportunitiesreads

    Find Reddit opportunities

  • reddit_amplification_planreads

    Plan Reddit promotion

  • task_createwrites

    Create a task

  • task_suggestwrites

    Suggest tasks from problems

  • report_createwrites

    Create a report

  • recommendation_savewrites

    Save a recommendation

  • ab_test_createwrites

    Create an A/B test record

  • creative_copy_generatewrites

    Generate ad copy

  • creative_fatigue_checkwrites

    Run a creative fatigue check

  • seo_article_generatewrites

    Generate an SEO article draft

  • seo_content_writewrites

    Write SEO content

  • seo_meta_tags_optimizewrites

    Optimise meta tags

  • seo_schema_generatewrites

    Generate schema markup

  • seo_site_checkwrites

    Run a site SEO check

  • seo_keywords_trackwrites

    Track keyword positions

  • seo_alerts_configurewrites

    Configure SEO alerts

  • aeo_content_optimizewrites

    Optimise a page for AI answers

  • reddit_reply_draftwrites

    Draft a Reddit reply

  • client_market_simulation_requestwrites

    Request a market simulation

  • telegram_ads_draft_generatewrites

    Draft a Telegram ad

  • telegram_ads_publish_taskwrites

    Queue a Telegram ad for manual publishing

  • chatgpt_ads_draft_generatewrites

    Draft a ChatGPT Ads campaign

  • campaign_draft_editwrites

    Edit campaign draft targeting and ads

  • chatgpt_ads_review_syncwrites

    Refresh ChatGPT Ads review status

  • leads_meta_ingestwrites

    Import Meta leads now

  • prepare_campaign_pausewrites

    Prepare pausing a campaign

  • prepare_campaign_enablewrites

    Prepare enabling a campaign

  • prepare_campaign_budget_changewrites

    Prepare a budget change

  • prepare_negative_keywords_addwrites

    Prepare adding negative keywords

  • prepare_campaign_draft_publishwrites

    Prepare publishing a campaign draft

  • prepare_ad_createwrites

    Prepare creating an ad

  • prepare_meta_ad_set_createwrites

    Prepare creating a Meta ad set

  • prepare_campaign_bid_strategy_changewrites

    Prepare a bid strategy change

  • prepare_meta_audiences_createwrites

    Prepare creating Meta audiences

  • prepare_meta_placement_safety_applywrites

    Prepare excluding risky Meta placements

  • prepare_google_conversion_action_createwrites

    Prepare a Google conversion action

  • prepare_google_app_videos_addwrites

    Prepare adding videos to an App campaign

  • prepare_google_rsa_variationswrites

    Prepare new Google search ad variations

  • prepare_google_keyword_overlap_fixwrites

    Prepare pausing duplicate keywords

  • prepare_telegram_ad_publishwrites

    Prepare publishing a Telegram ad

  • prepare_chatgpt_ads_publishwrites

    Prepare publishing a ChatGPT Ads campaign

  • prepare_meta_audience_createwrites

    Prepare creating one Meta audience

  • prepare_video_banner_generatewrites

    Prepare animating a banner into a video

  • prepare_article_distributionwrites

    Prepare social posts for an article

  • prepare_client_report_sendwrites

    Prepare sending a client report

  • prepare_social_post_schedulewrites

    Prepare scheduling a social post

  • prepare_creative_image_generatewrites

    Prepare generating an ad image

  • prepare_banner_generatewrites

    Prepare generating an ad banner

  • prepare_content_refreshwrites

    Prepare a content refresh

  • execute_prepared_changewrites

    Request execution of a prepared change

  • get_job_resultreads

    Result of a long tool call

  • get_prepared_changereads

    Status of a prepared change

Open tools (9)
  • get_platform_specsreads

    Get platform specifications

  • validate_ad_copyreads

    Validate ad copy against platform limits

  • validate_creative_specreads

    Validate a creative file against platform specs

  • check_decision_readinessreads

    Check whether there is enough data to act

  • ab_test_significancereads

    Test an A/B result for significance

  • build_utmreads

    Build a tagged campaign URL

  • validate_utmreads

    Check tagging on an existing URL

  • estimate_budget_feasibilityreads

    Check a budget against a cost or return goal

  • check_ad_policy_preflightreads

    Pre-check ad copy for policy risk

macOS, Linux
curl -s https://adsbeast.pro/api/mcp/workspace \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Windows PowerShell
(Invoke-RestMethod -Method Post -Uri https://adsbeast.pro/api/mcp/workspace -ContentType "application/json" -Body '{"jsonrpc":"2.0","id":1,"method":"tools/list"}').result.tools.name

Ask an assistant about ADS Beast

The button opens the assistant with a question already typed. It reads our public pages and answers in its own words; we do not see or edit the answer.

Questions

What is the ADS Beast MCP server?
It is an endpoint that lets an AI assistant such as ChatGPT, Claude or Cursor call ADS Beast tools. The open server at https://adsbeast.pro/api/mcp checks ad copy, creatives and budgets without an account. The account server at https://adsbeast.pro/api/mcp/workspace opens one ADS Beast organization to the assistant through an API key with scopes.
Can an assistant spend my ad budget through ADS Beast?
Not unless you allow it. An assistant can read data, build a campaign draft and propose a change. By default a change reaches an ad account only after a person approves it in ADS Beast, and a campaign published from a draft is created paused.
Do I need a paid plan to use the MCP server?
The open server needs no account. The account server works on the free plan with a monthly allowance of tool calls; paid plans raise it. The current numbers are on the pricing page.
Is ADS Beast listed in the ChatGPT or Claude directories?
Not yet. Today you add the server by its URL or install the plugin from our public GitHub repository. We will say so here when a listing is approved.