MCP Tools Reference
Complete reference for all 65 MCP tools — parameters, descriptions, and usage examples.
Intermediate15 min readUpdated 2026-03-31
Complete reference for every tool available in the AdsMAA MCP Server.
Integrations (3 tools)
| Tool | Description |
|---|---|
output | List all connected Meta ad account integrations. Returns ID, account name, status, last sync time. |
output | Trigger a campaign sync from Meta. Params: output |
output | Get integration health overview — total accounts, sync status. |
Campaigns (10 tools)
| Tool | Description | Key Parameters |
|---|---|---|
output | List campaigns with filtering and pagination | output output output output output |
output | Full campaign details with metrics and AI insights | output |
output | Aggregate stats (total spend, avg ROAS, counts) | output |
output | Top campaigns by ROAS/efficiency | output output |
output | Campaigns with problems | output |
output | Spend vs ROAS over time | output |
output | Update name, status, or budget | output output output output |
output | Bulk status change | output output |
output | Get ad sets in a campaign | output |
output | Get ads in a campaign | output |
Ad Sets & Ads (7 tools)
| Tool | Description |
|---|---|
output | List ad sets (filter by campaign, status, integration) |
output | Full ad set details with targeting and optimization goal |
output | Update ad set name, status, or budget |
output | Get all ads within an ad set |
output | List ads (filter by campaign, ad set, status) |
output | Full ad details with creative content and fatigue detection |
output | Update ad name or status |
Analytics (12 tools)
| Tool | Description |
|---|---|
output | Demographics breakdown: age, gender, device, location |
output | Video metrics: views, thruplay rate, watch time, completion % |
output | Engagement: reactions, comments, shares |
output | Placement breakdown: Feed, Stories, Reels, etc. |
output | Breakdown by device, platform, position, or country |
output | Period-over-period comparison (current vs previous) |
output | Budget spend vs planned for active campaigns |
output | Quality rankings, conversion funnels, social metrics |
output | Regional performance with gender/age/placement splits |
output | A/B test comparison across ads in a campaign |
output | Frequency and audience fatigue detection |
output | Metrics by attribution window (1d/7d/28d click/view) |
All analytics tools accept optional
output
date_fromoutput
date_tooutput
date_presetAudit & AI Intelligence (9 tools)
| Tool | Description |
|---|---|
output | Full AI audit: health score (0-100), executive summary, cost of inaction, recommendations |
output | Campaign-specific audit with targeted findings |
output | Most recent audit (without running a new one) |
output | Historical audit reports |
output | Week-over-week health score trends |
output | AI-powered optimization recommendations and alerts |
output | Pending AI actions awaiting approval |
output | Approve a pending AI action |
output | Reject a pending AI action |
AI Tools (8 tools)
| Tool | Description |
|---|---|
output | Check autopilot status and which campaigns are enabled |
output | Trigger an autopilot optimization cycle |
output | Generate a full campaign from a text brief |
output | List AI-generated campaign drafts |
output | Publish a draft to Meta Ads Manager |
output | Generate ad copy with tone and platform options |
output | Analyze existing copy with improvement suggestions |
output | Chat with AdsMAA AI about your ad account |
Targeting & Export (5 tools)
| Tool | Description |
|---|---|
output | Search Meta targeting interests by keyword |
output | Search targeting locations (city, country, region, zip) |
output | Export campaign data as JSON/CSV with filters |
output | Recent account changes, syncs, and events |
output | Get ad account currency info |
Live Meta API (11 tools)
These tools fetch real-time data directly from Meta Graph API using your stored integration tokens. All require an
output
integration_idoutput
meta_list_integrations| Tool | Description |
|---|---|
output | All ad accounts accessible by the integration |
output | All campaigns with current status from Meta |
output | Campaign metrics live from Meta. Params: output output |
output | All ad sets with targeting and optimization data |
output | Ad set metrics live from Meta |
output | All ads with creative content from Meta |
output | Ad metrics live from Meta |
output | Account-level daily breakdown from Meta |
output | Bulk: insights for all campaigns in one call |
output | Custom audiences with sizes and delivery status |
output | Facebook Pages, Instagram accounts, Threads profiles |
Live Meta Write Operations (7 tools)
These tools make changes directly on Meta Ads Manager in real-time. All require an
output
integration_id| Tool | Description |
|---|---|
output | Update campaign status, budget, name, schedule on Meta |
output | Full ad set update — targeting (geo, age, gender, interests, radius), optimization goal, billing event, bid strategy, budget, schedule, promoted object |
output | Update ad status, name, or swap creative on Meta |
output | Duplicate an ad set with modifications. Use when changing optimization events (e.g., Lead → Initiate Checkout) since Meta blocks this on active ad sets |
output | Create a new campaign on Meta with objective, budget, and status |
output | Create a new ad set with full targeting, optimization, and budget |
output | Create a new ad with creative on Meta |
Key tool: supports these parameters:outputlive_meta_update_adset
- — JSON with geo_locations, age_min, age_max, genders, interests, behaviors, city radiusoutput
targeting - — REACH, LINK_CLICKS, OFFSITE_CONVERSIONS, LEAD_GENERATION, etc.output
optimization_goal - — IMPRESSIONS, LINK_CLICKSoutput
billing_event - /output
bid_strategy— bidding configurationoutputbid_amount - — pixel ID and conversion eventoutput
promoted_object - ,output
status,outputname,outputdaily_budget,outputlifetime_budget,outputstart_timeoutputend_time
Key tool: — when Meta won't let you change optimization on a running ad set, this tool copies all settings and applies your changes to the copy, then optionally pauses the original.outputlive_meta_duplicate_adset
Lead Forms (3 tools)
| Tool | Description |
|---|---|
output | List all lead gen forms for the ad account |
output | Create a new lead form (name, questions, privacy policy, thank you page) |
output | Update an existing lead form |
Insights & Breakdowns (1 tool)
| Tool | Description |
|---|---|
output | Get real-time insights with breakdowns (age, gender, region, placement, device). Supports custom date ranges. |
Ad Scheduling & Controls (3 tools)
| Tool | Description |
|---|---|
output | Set dayparting — run ads only during specific hours/days (e.g., Mon-Fri 9AM-9PM) |
output | Limit how many times one person sees your ad (e.g., max 3 times per 7 days) |
output | Set lifetime spending limit on a campaign |
Comment Management (3 tools)
| Tool | Description |
|---|---|
output | Get comments on an ad (message, author, likes, hidden status) |
output | Reply to a comment on your ad |
output | Hide a negative comment from public view |
Audience & Attribution (3 tools)
| Tool | Description |
|---|---|
output | Check how much two audiences overlap to prevent waste |
output | Change click/view attribution window (1d, 7d, 28d click; 0d, 1d view) |
output | Set different creatives per placement (Feed vs Stories vs Reels) |
Ad Creatives (5 tools)
| Tool | Description |
|---|---|
output | List all creatives — name, image, video, CTA, object story spec |
output | Full creative details with asset feed spec |
output | Create image, video, carousel, or existing post creative |
output | Update creative name, URL tags, status |
output | Delete a creative |
Videos (4 tools)
| Tool | Description |
|---|---|
output | List uploaded videos — title, length, source URL |
output | Video details with encoding status and views |
output | Get available thumbnails for a video |
output | Upload a video from URL for use in ads |
Custom Audiences (9 tools)
| Tool | Description |
|---|---|
output | Full audience details — rule, lookalike spec, data source |
output | Create website, customer list, or lookalike audience |
output | Update audience name, description |
output | Add users to customer list (email/phone hashes) |
output | Delete a custom audience |
output | List saved targeting presets |
output | Save a targeting spec as reusable preset |
output | Delete a saved audience |
Custom Conversions (5 tools)
| Tool | Description |
|---|---|
output | List custom conversions — event type, rule, default value |
output | Create custom conversion with pixel, rule, and value |
output | Update conversion name or value |
output | Delete a custom conversion |
output | Send server-side events via Conversions API (with test mode) |
Product Catalogs (5 tools)
| Tool | Description |
|---|---|
output | List product catalogs — name, product count |
output | List products — name, price, availability, image |
output | Batch create/update/delete catalog products |
output | List filtered product subsets for dynamic ads |
output | Create product set with filter rules |
Async Reports (3 tools)
| Tool | Description |
|---|---|
output | Create heavy report for large date ranges |
output | Check report completion status |
output | Fetch completed report data |
Ad Labels (4 tools)
| Tool | Description |
|---|---|
output | List all ad labels |
output | Create a label for organizing campaigns/ads |
output | Apply label to a campaign, ad set, or ad |
output | Delete a label |
A/B Experiments (3 tools)
| Tool | Description |
|---|---|
output | List all split test experiments |
output | Get experiment results and confidence level |
output | Create a new A/B test |
Page Posts & Instagram (4 tools)
| Tool | Description |
|---|---|
output | List published Facebook Page posts |
output | List dark posts (ads-only, not on timeline) |
output | Create unpublished post for ad use |
output | List Instagram posts/reels for promotion |
Account & Targeting (15 tools)
| Tool | Description |
|---|---|
output | Full account info — status, currency, spend cap, balance |
output | Set account spending limit |
output | Audit log of account changes |
output | List users with access and roles |
output | Search behavioral targeting (purchase, travel) |
output | Search demographic targeting (education, jobs) |
output | Search employer/workplace targeting |
output | AI-suggested targeting from Meta |
output | Convert targeting to human-readable and validate |
output | List uploaded ad images |
output | Delete an ad image |
output | Business manager info |
output | Business ad accounts |
output | Business Facebook Pages |
Key Takeaways
- 1148 tools across 20 categories — the most comprehensive Meta Ads MCP server available
- 2Stored data tools (meta_*) use cached data for fast responses
- 3Live tools (live_*) fetch real-time data from Meta Graph API
- 4All live tools require an integration_id parameter
Frequently Asked Questions
What is the difference between meta_list_campaigns and live_meta_campaigns?
meta_list_campaigns returns data from AdsMAA's database (last synced state, includes health scores and AI data). live_meta_campaigns fetches current data directly from Meta's API in real-time.
How do I get the integration_id for live tools?
Run meta_list_integrations first. It returns all connected Meta accounts with their IDs. Use any connected integration's ID for the live_ tools.
Why can't I change the optimization event on an active ad set?
Meta doesn't allow changing the conversion event on running ad sets. Use live_meta_duplicate_adset to create a copy with the new optimization goal, then pause the original.
Can Claude change my geo-targeting and audience settings?
Yes. Use live_meta_update_adset with the targeting parameter. Pass a JSON object with geo_locations (cities, countries, radius), age_min, age_max, genders, interests, and behaviors.
Can I use natural language instead of remembering tool names?
Yes! AI clients like Claude automatically choose the right tool based on your request. Just say "show me real-time campaign data" and it will use the appropriate live_ tool.
Was this article helpful?