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/mcpAccount 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 asAuthorization: Bearer absk_...orX-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.
- ChatGPTOpen tools today. Account tools after sign-in is switched on.
- ClaudeCustom connector on the web, a local bridge with a key on desktop.
- Claude CodeOne command with a key, or the plugin from our repository.
- CursorA few lines in mcp.json with the key in an environment variable.
- CodexOne command, the key stays in an environment variable.
- Gemini CLIOne command or a block in settings.json.
- Devin Desktop (Windsurf)A block in the MCP config file of Devin Desktop.
- Any MCP clientURL, one header and a curl check for any other client.
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)
whoamireadsDescribe the current API key
get_new_leadsreadsPull leads, including newly created ones
get_leadreadsGet one lead
list_lead_formsreadsList known lead forms
lead_pipeline_statsreadsSummarise the lead pipeline
lead_outcome_contractreadsGet the accepted outcome fields
update_leadwritesUpdate a lead
move_lead_stagewritesMove a lead to another stage
push_lead_outcomeswritesPush CRM outcomes back into the pipeline
list_campaignsreadsList campaigns
get_campaignreadsGet one campaign
campaign_dashboard_summaryreadsSummarise spend and delivery
list_clientsreadsList clients
get_clientreadsGet one client
list_reportsreadsList generated reports
list_alertsreadsList monitoring alerts
alerts_unread_countreadsCount unread alerts
list_tasksreadsList team tasks
list_outreach_campaignsreadsList email outreach campaigns
outreach_campaign_checkreadsCheck an email campaign before launch
list_offer_packsreadsList offer packs
list_social_campaignsreadsList social prospecting campaigns
get_social_queuereadsGet the social outreach queue
update_social_prospectwritesRecord what happened with a social prospect
list_webhook_eventsreadsList subscribable events
list_webhooksreadsList registered webhooks
create_webhookwritesRegister an outbound webhook
seo_publish_safetyreadsCheck whether a site may publish now
list_proposalsreadsList change proposals
propose_campaign_changewritesPropose a campaign change (pause, enable, budget)
reject_proposalwritesReject a change proposal
list_campaign_typesreadsCampaign types that can be drafted
list_campaign_draftsreadsList campaign builds and drafts
get_campaign_draftreadsOne campaign draft with its validation
create_campaign_draftwritesCreate a campaign draft in the builder
update_campaign_draftwritesChange a campaign draft the assistant created
get_agency_kitreadsAgency Kit: everything about one client in one document
client_overviewreadsClient overview
client_action_planreadsClient action plan
client_goalsreadsClient KPI goals
client_data_freshnessreadsData freshness
client_memory_searchreadsSearch client memory
client_history_searchreadsSearch past reports and audits
client_landing_scanreadsScan a client's landing page
client_market_analysisreadsGet market analysis
client_market_analysis_runreadsRun market analysis
client_market_intel_searchreadsSearch market intelligence
client_market_simulationreadsGet market simulation
analytics_summaryreadsPerformance summary
analytics_compare_periodsreadsCompare two periods
analytics_forecastreadsForecast KPIs
analytics_forecast_warningsreadsForecast warnings
analytics_attributionreadsAttribution breakdown
analytics_portfolioreadsPortfolio analysis
analytics_cross_client_insightsreadsCross-client insights
analytics_kpi_healthreadsKPI health check
analytics_growth_opportunitiesreadsGrowth opportunities
analytics_benchmarksreadsIndustry benchmarks
analytics_agency_briefingreadsDaily briefing
analytics_media_planreadsMedia plan numbers
analytics_ab_testsreadsList A/B tests
audit_accountreadsAudit an ad account
audit_google_adsreadsAudit Google Ads
audit_meta_adsreadsAudit Meta Ads
audit_conversion_goalsreadsAudit conversion goals
audit_trackingreadsAudit tracking setup
audit_campaign_qualityreadsLive campaign quality check
audit_wasted_spendreadsFind wasted spend
audit_campaign_portfolioreadsScan campaign portfolio
audit_campaign_healthreadsCampaign health summary
audit_performance_coachreadsPerformance coaching review
audit_ad_disapprovalsreadsList disapproved ads
campaign_searchreadsSearch campaigns by name
campaign_analyzereadsAnalyse a campaign
campaign_diagnosereadsDiagnose a campaign problem
campaign_history_analysisreadsAnalyse campaign history
campaign_type_coveragereadsCampaign type coverage
campaign_strategy_generatereadsGenerate a strategy
campaign_strategy_expert_reviewreadsExpert strategy review
campaign_swarm_runsreadsList campaign generation runs
campaign_draft_detailsreadsFull campaign draft
campaign_draft_publish_checkreadsRehearse publishing a draft
google_ads_ad_strengthreadsGoogle ad strength
google_ads_keyword_overlapreadsFind duplicate keywords
google_ads_script_generatereadsGenerate a Google Ads script
google_ads_conversion_tracking_checkreadsCheck Google conversion tracking
google_ads_app_videos_checkreadsCheck videos for an App campaign
meta_ads_account_setupreadsMeta account setup
meta_ads_interest_searchreadsSearch Meta interests
meta_ads_learning_phasereadsMeta learning phase
meta_ads_placement_safety_checkreadsCheck risky Meta placements
tiktok_ads_account_setupreadsTikTok account setup
linkedin_ads_account_setupreadsLinkedIn account setup
microsoft_ads_account_setupreadsMicrosoft Ads account setup
telegram_ads_statusreadsTelegram Ads status
telegram_ads_policy_checkreadsCheck a Telegram ad
telegram_ads_verify_channelreadsVerify a Telegram channel
telegram_ads_targetingreadsTelegram targeting options
chatgpt_ads_statusreadsChatGPT Ads status
chatgpt_ads_policy_checkreadsCheck a ChatGPT ad
creative_fatigue_reportreadsCreative fatigue report
creative_image_analyzereadsAnalyse an ad image
creative_banner_quality_checkreadsCheck a banner's quality
creative_prompt_templatesreadsBanner prompt templates
creative_copy_humanizereadsCheck copy for AI tells
competitor_listreadsList competitors
competitor_search_intelreadsResearch competitors
competitor_ads_researchreadsResearch competitor ads
competitor_site_analyzereadsAnalyse a competitor site
competitor_social_signalsreadsCompetitor social signals
competitor_aeo_benchmarkreadsAI visibility benchmark
leads_quality_diagnosereadsDiagnose lead quality
leads_meta_ingest_checkreadsCheck Meta leads waiting
social_calendarreadsSocial content calendar
seo_researchreadsSEO research
seo_rank_changesreadsKeyword rank changes
seo_brief_generatereadsGenerate an SEO brief
seo_keyword_rank_checkreadsCheck a keyword position
seo_keyword_researchreadsKeyword research
seo_content_gapreadsContent gap analysis
seo_performance_reportreadsSEO performance report
seo_backlink_analysisreadsBacklink analysis
seo_competitor_analysisreadsSEO competitor analysis
seo_serp_analysisreadsSERP analysis
seo_technical_auditreadsTechnical SEO audit
seo_on_page_auditreadsOn-page SEO audit
seo_internal_links_auditreadsInternal links audit
seo_content_quality_auditreadsContent quality audit
seo_domain_authority_auditreadsDomain authority audit
seo_entity_auditreadsBrand entity audit
seo_ai_citation_optimizereadsOptimise for AI citation
aeo_visibility_scanreadsAI visibility scan
aeo_mention_opportunitiesreadsFind mention opportunities
reddit_mentions_monitorreadsMonitor Reddit mentions
reddit_opportunitiesreadsFind Reddit opportunities
reddit_amplification_planreadsPlan Reddit promotion
task_createwritesCreate a task
task_suggestwritesSuggest tasks from problems
report_createwritesCreate a report
recommendation_savewritesSave a recommendation
ab_test_createwritesCreate an A/B test record
creative_copy_generatewritesGenerate ad copy
creative_fatigue_checkwritesRun a creative fatigue check
seo_article_generatewritesGenerate an SEO article draft
seo_content_writewritesWrite SEO content
seo_meta_tags_optimizewritesOptimise meta tags
seo_schema_generatewritesGenerate schema markup
seo_site_checkwritesRun a site SEO check
seo_keywords_trackwritesTrack keyword positions
seo_alerts_configurewritesConfigure SEO alerts
aeo_content_optimizewritesOptimise a page for AI answers
reddit_reply_draftwritesDraft a Reddit reply
client_market_simulation_requestwritesRequest a market simulation
telegram_ads_draft_generatewritesDraft a Telegram ad
telegram_ads_publish_taskwritesQueue a Telegram ad for manual publishing
chatgpt_ads_draft_generatewritesDraft a ChatGPT Ads campaign
campaign_draft_editwritesEdit campaign draft targeting and ads
chatgpt_ads_review_syncwritesRefresh ChatGPT Ads review status
leads_meta_ingestwritesImport Meta leads now
prepare_campaign_pausewritesPrepare pausing a campaign
prepare_campaign_enablewritesPrepare enabling a campaign
prepare_campaign_budget_changewritesPrepare a budget change
prepare_negative_keywords_addwritesPrepare adding negative keywords
prepare_campaign_draft_publishwritesPrepare publishing a campaign draft
prepare_ad_createwritesPrepare creating an ad
prepare_meta_ad_set_createwritesPrepare creating a Meta ad set
prepare_campaign_bid_strategy_changewritesPrepare a bid strategy change
prepare_meta_audiences_createwritesPrepare creating Meta audiences
prepare_meta_placement_safety_applywritesPrepare excluding risky Meta placements
prepare_google_conversion_action_createwritesPrepare a Google conversion action
prepare_google_app_videos_addwritesPrepare adding videos to an App campaign
prepare_google_rsa_variationswritesPrepare new Google search ad variations
prepare_google_keyword_overlap_fixwritesPrepare pausing duplicate keywords
prepare_telegram_ad_publishwritesPrepare publishing a Telegram ad
prepare_chatgpt_ads_publishwritesPrepare publishing a ChatGPT Ads campaign
prepare_meta_audience_createwritesPrepare creating one Meta audience
prepare_video_banner_generatewritesPrepare animating a banner into a video
prepare_article_distributionwritesPrepare social posts for an article
prepare_client_report_sendwritesPrepare sending a client report
prepare_social_post_schedulewritesPrepare scheduling a social post
prepare_creative_image_generatewritesPrepare generating an ad image
prepare_banner_generatewritesPrepare generating an ad banner
prepare_content_refreshwritesPrepare a content refresh
execute_prepared_changewritesRequest execution of a prepared change
get_job_resultreadsResult of a long tool call
get_prepared_changereadsStatus of a prepared change
Open tools (9)
get_platform_specsreadsGet platform specifications
validate_ad_copyreadsValidate ad copy against platform limits
validate_creative_specreadsValidate a creative file against platform specs
check_decision_readinessreadsCheck whether there is enough data to act
ab_test_significancereadsTest an A/B result for significance
build_utmreadsBuild a tagged campaign URL
validate_utmreadsCheck tagging on an existing URL
estimate_budget_feasibilityreadsCheck a budget against a cost or return goal
check_ad_policy_preflightreadsPre-check ad copy for policy risk
curl -s https://adsbeast.pro/api/mcp/workspace \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'(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.nameAsk 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.