Meta Ads MCP API
Full reference for all 30+ tools, API token authentication, and direct API access.
Available Tools
30+ functions organized by category. All tools are available through the MCP server.
Account Management
Access and manage ad account information
get_ad_accountsGet all ad accounts accessible by a user with details
get_account_infoGet detailed information about a specific ad account
get_account_pagesGet Facebook pages associated with an ad account
Campaigns
Create, read, update, and manage campaigns
get_campaignsGet campaigns with optional filtering by status or objective
New: Objective filtering
Filter campaigns by objective (e.g., OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC)
get_campaign_detailsGet detailed information about a specific campaign
create_campaignCreate a new campaign with budget, objective, and targeting
update_campaignUpdate campaign settings and budgets
create_budget_scheduleSchedule budget increases for high-demand periods
Ad Sets
Manage ad sets with targeting and budgets
get_adsetsGet ad sets with optional campaign filtering
get_adset_detailsGet detailed information about an ad set
create_adsetCreate a new ad set with targeting and optimization settings
update_adsetUpdate ad set settings including frequency caps and budgets
Ads
Create and manage individual ads
get_adsGet ads with optional campaign or ad set filtering
get_ad_detailsGet detailed information about a specific ad
create_adCreate a new ad with an existing creative
update_adUpdate ad status, bid, or creative
Creatives & Media
Upload images and manage ad creatives
get_ad_creativesGet creative details for a specific ad
upload_ad_imageUpload an image to use in creatives (returns image hash)
create_ad_creativeCreate a new creative with image, copy, and CTA
update_ad_creativeUpdate creative copy, headlines, or CTA
get_ad_imageDownload and visualize ad images
Analytics & Insights
Access performance data and metrics
get_insightsGet performance metrics for campaigns, ad sets, or ads
Supports time ranges (today, last_7d, last_30d, etc.) and breakdowns (age, gender, platform, etc.)
bulk_get_insightsNewGet performance metrics across all your ad accounts in one call
Returns impressions, clicks, spend, CTR, CPC, CPM, reach, and conversions for all accounts. Takes 3-5 seconds with smart caching for repeat calls.
Available with Pipeboard's remote MCP (not the open-source GitHub version)
Audience Targeting
Research and validate targeting options
search_interestsSearch for interest targeting options
get_interest_suggestionsGet related interest suggestions for existing interests
estimate_audience_sizeEstimate reach for targeting specifications
search_behaviorsSearch for behavior targeting options
search_demographicsSearch demographic targeting options (life events, income, etc.)
search_geo_locationsSearch for geographic targeting (countries, regions, cities)
Premium Tools (Paid Plans Only)
Advanced duplication features for A/B testing and scaling
duplicate_campaignDuplicate entire campaigns with all ad sets and ads
duplicate_adsetDuplicate ad sets with optional targeting changes
duplicate_adDuplicate ads to different ad sets
duplicate_creativeDuplicate creatives with copy variations
API Tokens & Direct Access
For programmatic access, automation scripts, and direct API calls
If your MCP client requires an API token, or if you want to call the MCP server directly from code, you can use a Pipeboard API token for authentication.
1. Get your API token:
pipeboard.co/api-tokens →2. Use in your requests:
Option A: Authorization header
Authorization: Bearer YOUR_TOKENOption B: Query parameter
https://mcp.pipeboard.co/meta-ads-mcp?token=pk_...Useful for MCP clients that don't support custom headers. Less secure as the token may appear in request logs — prefer the header option when possible.
Direct Testing with curl
For testing or debugging, you can call the MCP directly using the MCP protocol:
curl -X POST https://mcp.pipeboard.co/meta-ads-mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer $PIPEBOARD_API_TOKEN" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_ad_accounts",
"arguments": {}
}
}'Replace $PIPEBOARD_API_TOKEN with your API token from pipeboard.co/api-tokens
Rate Limits
Meta API Limits
The Meta Ads API has rate limits of 200 calls per hour per user. The MCP server automatically handles retries with exponential backoff.
Tips
- Batch operations when possible (use filters to reduce API calls)
- Cache insights data for reporting workflows
- Use paused status when creating campaigns to review before activation
- Test targeting with audience estimation before launching campaigns
Support & Documentation
Need help?