137 Tools: The Complete AdsMAA MCP Server Reference
Full reference guide to all 137 tools in AdsMAA's MCP server for Meta Ads. Covers campaigns, analytics, creatives, audiences, catalogs, rules, and more.
Key Takeaways
- Tool Categories Overview
- AdsMAA Stored Data Tools (51)
- Live Meta API Tools (86)
- Most Used Tools by Category
73%
More Accurate Data
3x
Better ROAS
40%
Lower CPA
24/7
AI Optimization
Tool Categories Overview
The AdsMAA MCP server provides 137 tools across 20 categories, making it the most comprehensive Meta Ads MCP server available. Every tool is accessible through natural language when connected to Claude, Cursor, or any MCP-compatible client.
Here is the complete category breakdown:
| Category | Count | Description |
|---|---|---|
| Integrations | 3 | List connected accounts, trigger syncs, health check |
| Campaigns | 8 | List, get, stats, trends, top performers, needs attention, bulk update |
| Ad Sets & Ads | 5 | List and get ad sets and ads with creative data |
| Analytics | 12 | Audience, video, engagement, placement, frequency, attribution |
| Audit & AI | 9 | Health score audits, AI recommendations, action approval |
| AI Tools | 8 | Autopilot, campaign generator, copy generator, AI chat |
| Targeting & Export | 5 | Interest/location search, data export, activity feed |
| Live Core | 18 | Campaign/adset/ad CRUD, insights, leads, previews, rules |
| Ad Creatives | 5 | List, get, create, update, delete creatives |
| Videos | 4 | Upload, list, get details, thumbnails |
| Audiences | 9 | Website, CRM, lookalike audiences, saved audiences |
| Custom Conversions | 5 | List, create, update, delete conversions |
| Conversions API | 1 | Send server-side events with test mode |
| Product Catalogs | 5 | Catalogs, products, product sets, batch items |
| Async Reports | 3 | Large report creation and retrieval |
| Ad Labels | 4 | Create, apply, manage labels |
| A/B Experiments | 3 | Split test creation and results |
| Page Posts & Instagram | 4 | Page posts, dark posts, Instagram media |
| Ad Rules | 6 | Automated rule creation and management |
| Account & Business | 10 | Account details, spend caps, business manager |
Tools Distribution: Stored vs Live
Breakdown of AdsMAA MCP tools by data source.
AdsMAA Stored Data Tools (51)
These tools query AdsMAA's local database and include features you cannot get from Meta directly, such as AI-powered audits, health scores, and autopilot optimization.
Integration Tools
meta_list_integrations- List all connected Meta ad accounts with sync statusmeta_sync_integration- Trigger a manual sync of campaign data from Metameta_integration_stats- Overview of integration health and last sync time
Campaign Management
meta_list_campaigns- List campaigns with filters for status, date range, and paginationmeta_get_campaign- Detailed campaign data including performance metricsmeta_campaign_stats- Aggregate statistics across all campaignsmeta_top_performers- Ranked list of best-performing campaignsmeta_needs_attention- Campaigns flagged for poor performance or anomaliesmeta_account_trends- Spend vs ROAS trends over timemeta_update_campaign- Update campaign settings in AdsMAAmeta_bulk_update_campaigns- Batch status updates
Analytics Tools
The analytics suite provides 12 tools for deep performance analysis:
meta_audience_insights- Demographics breakdown (age, gender, location)meta_video_insights- Video-specific metrics (views, completion rate, ThruPlay)meta_engagement_insights- Likes, comments, shares, reactionsmeta_placement_insights- Performance by placement (Feed, Stories, Reels)meta_breakdown_insights- Device, platform, and country breakdownsmeta_compare_periods- Period-over-period comparison (this week vs last week)meta_budget_pacing- Budget utilization and spend pacingmeta_advanced_metrics- Quality rankings and conversion funnelsmeta_region_insights- Regional demographic analysismeta_ad_comparison- Side-by-side A/B test comparisonmeta_frequency_insights- Frequency and creative fatigue detectionmeta_attribution_insights- Multi-touch attribution window metrics
AI and Audit Tools
These are the tools that truly differentiate AdsMAA from any other MCP server:
meta_audit_account- Full account audit with health score (0-100)meta_audit_campaign- Campaign-specific audit with recommendationsmeta_audit_latest- Retrieve the most recent audit reportmeta_audit_history- Historical audit reports for trend analysismeta_audit_trends- Week-over-week audit score trendsmeta_ai_insights- AI-generated recommendations for improvementmeta_ai_pending_actions- AI-suggested actions waiting for approvalmeta_ai_approve_action- Approve a recommended AI actionmeta_ai_reject_action- Reject a recommended AI action
Pro tip: Run
meta_audit_accountweekly to track your health score trajectory. Combine it withmeta_audit_trendsto see if your optimization efforts are paying off.
Pro Tip
This section contains advanced strategies that can significantly improve your results. Make sure to implement them step by step.
Live Meta API Tools (86)
All tools prefixed with live_ connect directly to Meta's Graph API for real-time data and write operations.
Campaign/Ad Set/Ad CRUD
| Tool | Action |
|---|---|
live_meta_update_campaign | Update status, budget, name |
live_meta_update_adset | Full targeting, geo, budget, bid update |
live_meta_update_ad | Update status and creative |
live_meta_duplicate_adset | Clone ad set with modifications |
live_meta_create_campaign | Create a new campaign on Meta |
live_meta_create_adset | Create ad set with targeting |
live_meta_create_ad | Create an ad with creative |
Creative Management
live_meta_list_creatives/live_meta_get_creative- Browse existing creativeslive_meta_create_creative- Create image, video, carousel, or post-based creativeslive_meta_upload_video/live_meta_list_videos- Video asset managementlive_meta_list_images/live_meta_delete_image- Image asset management
Audience Tools
live_meta_create_audience- Create website, CRM, or lookalike audienceslive_meta_add_audience_users- Add user data to custom audienceslive_meta_list_saved_audiences- Browse saved targeting presetslive_meta_create_saved_audience- Save a targeting configuration for reuse
Product Catalogs and Dynamic Ads
live_meta_list_catalogs- List product catalogslive_meta_list_catalog_products- Browse products in a cataloglive_meta_batch_catalog_items- Bulk create or update productslive_meta_create_product_set- Create filtered product sets for dynamic ads
Tools by Functional Area
Number of tools available in each major functional area.
Most Used Tools by Category
Based on usage data, here are the most frequently called tools in each category:
| Category | Most Used Tool | Typical Prompt |
|---|---|---|
| Campaigns | meta_list_campaigns | "Show me all active campaigns" |
| Analytics | meta_audience_insights | "Who is seeing my ads?" |
| Audit | meta_audit_account | "Audit my ad account" |
| Creative | live_meta_list_creatives | "Show my ad creatives" |
| Write | live_meta_update_campaign | "Pause campaign X" |
| AI | meta_ai_insights | "What should I optimize?" |
The businesses that succeed are those that embrace data-driven decision making and continuous optimization.
Tool Naming Conventions
Understanding the naming pattern helps you predict which tools exist:
meta_prefix = AdsMAA stored data (fast, includes AI features)live_meta_prefix = Real-time Meta Graph API call_list_= Returns multiple items with pagination_get_= Returns a single item by ID_create_= Creates a new resource_update_= Modifies an existing resource_delete_= Removes a resource
For example, live_meta_create_audience tells you it is a real-time API call that creates a new audience on Meta.
Campaign Creation Workflow via MCP
Tools involved in creating a full campaign from scratch.
Generate Brief
meta_ai_generate_campaign
Create Campaign
live_meta_create_campaign
Create Ad Set
live_meta_create_adset
Create Ad
live_meta_create_ad
Practical Tool Workflows
Here are complete workflows combining multiple tools:
Full Account Audit Workflow
meta_list_integrations - Confirm which accounts are connectedmeta_audit_account - Run the comprehensive health auditmeta_ai_insights - Get AI-generated recommendationsmeta_ai_pending_actions - Review suggested actionsmeta_ai_approve_action - Approve the actions you agree withCampaign Launch Workflow
meta_ai_generate_campaign - Generate a campaign draft from a briefmeta_ai_campaign_drafts - Review the AI-generated draftmeta_ai_publish_campaign - Publish the draft to Metameta_campaign_stats - Monitor performance after launchAudience Research Workflow
meta_search_interests - Find relevant targeting interestslive_meta_search_behaviors - Discover behavioral targeting optionslive_meta_get_targeting_suggestions - Get AI targeting suggestionslive_meta_validate_targeting - Validate reach estimateslive_meta_create_saved_audience - Save the targeting for useFor a conceptual overview of what MCP is and how it works, see What is MCP?. For setup instructions, see our complete setup guide.
Frequently Asked Questions
How many tools does the AdsMAA MCP server have?
The AdsMAA MCP server provides 137 tools across 20 categories. 51 tools query AdsMAA's stored data (with AI features), and 86 tools connect directly to Meta's live Graph API.
What is the difference between meta_ and live_meta_ tools?
Tools prefixed with meta_ query AdsMAA's local database for fast responses and AI features. Tools prefixed with live_meta_ make real-time calls to Meta's Graph API for the latest data.
Can I create campaigns through the MCP server?
Yes. Use live_meta_create_campaign, live_meta_create_adset, and live_meta_create_ad to create full campaign structures directly on Meta. Or use meta_ai_generate_campaign to have AI draft a campaign from a brief.
Which tools require the Professional plan?
Audit tools (meta_audit_account, meta_audit_campaign) and autopilot tools (meta_autopilot_run) are available on the Professional plan. Campaign management and analytics tools are available on all plans.
How do I know which tool Claude will use for my request?
Claude automatically selects the appropriate tools based on your natural language prompt. You can also explicitly request a specific tool by name, like "Use meta_top_performers to show my best campaigns."
Can I manage product catalogs through MCP?
Yes. The catalog tools let you list catalogs, browse products, batch create or update items, and create product set filters for dynamic ads.
Are there tools for A/B testing?
Yes. Use live_meta_create_experiment to set up split tests, live_meta_list_experiments to see active tests, and meta_ad_comparison for comparing ad performance side by side.
Can I send Conversions API events through MCP?
Yes. The live_meta_send_conversion_event tool lets you send server-side events with support for test mode, making it useful for debugging your CAPI integration.
Ready to Transform Your Advertising?
Join thousands of marketers using AdsMAA to optimize their advertising with AI-powered tools.
No credit card required · Free plan available
Related Articles
Meta Conversions API (CAPI): Complete Setup Guide for 2025
Step-by-step guide to implementing Meta Conversions API. Improve your Facebook and Instagram ad performance by 20-30% with server-side tracking.
E-commerce Conversion Tracking: Complete Setup Guide for Shopify, WooCommerce & More
Learn how to set up accurate conversion tracking for your e-commerce store. Covers Shopify, WooCommerce, and custom platforms with Meta, Google, and TikTok.
TikTok Ads: The Complete Advertising Guide for 2025
Master TikTok advertising with our comprehensive guide. Learn about ad formats, targeting, attribution, Events API setup, and optimization strategies.