Scaleforge Mcp Meta Ads
A production-grade wrapper for Meta's Graph API v24.0 that surfaces 32 tools for managing Facebook and Instagram ad campaigns directly from Claude or any MCP client. It handles the sharp edges: auto-batching to dodge rate limits, pre-flight checks against Meta's 250-ads-per-Page cap, enhanced error messages when tokens expire, and automatic PBIA provisioning when a Page lacks an Instagram account. Communicates directly with graph.facebook.com with no intermediary backend. Supports both short-lived user tokens from the Graph API Explorer and long-lived System User tokens from Business Manager. Useful when you need programmatic control over campaign CRUD, bid adjustments, or bulk pause/activate operations without wrestling with v22-to-v24 deprecations or image hash quirks across multiple ad accounts.
- tools
- 32
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Apr 17, 2026
Tools
32 toolsPublic tool metadata for what this MCP can expose to an agent.
list_ad_accountsList Ad Accounts accessible to the token
List Ad Accounts accessible to the token
No parameter schema in public metadata yet.
get_ad_accountDetailed info for one account (status, spend cap, balance)
Detailed info for one account (status, spend cap, balance)
No parameter schema in public metadata yet.
get_ads_volumePer-Page running-ads count + limit + remaining slots (pre-flight check)
Per-Page running-ads count + limit + remaining slots (pre-flight check)
No parameter schema in public metadata yet.
list_campaignsPaginated campaign list
Paginated campaign list
No parameter schema in public metadata yet.
get_campaignSingle campaign by ID
Single campaign by ID
No parameter schema in public metadata yet.
create_campaignCreate new campaign (defaults to PAUSED)
Create new campaign (defaults to PAUSED)
No parameter schema in public metadata yet.
update_campaignUpdate any mutable field
Update any mutable field
No parameter schema in public metadata yet.
delete_campaignHard delete
Hard delete
No parameter schema in public metadata yet.
list_adsetsList by ad_account_id OR campaign_id
List by ad_account_id OR campaign_id
No parameter schema in public metadata yet.
get_adsetSingle ad set by ID
Single ad set by ID
No parameter schema in public metadata yet.
create_adsetCreate ad set under a campaign
Create ad set under a campaign
No parameter schema in public metadata yet.
update_adsetUpdate targeting, bid, budget, status
Update targeting, bid, budget, status
No parameter schema in public metadata yet.
delete_adsetHard delete
Hard delete
No parameter schema in public metadata yet.
list_adsList by ad_account_id, adset_id, or campaign_id
List by ad_account_id, adset_id, or campaign_id
No parameter schema in public metadata yet.
get_adSingle ad by ID (incl. creative + issues + preview link)
Single ad by ID (incl. creative + issues + preview link)
No parameter schema in public metadata yet.
update_adUpdate name, status, swap creative
Update name, status, swap creative
No parameter schema in public metadata yet.
delete_adHard delete
Hard delete
No parameter schema in public metadata yet.
list_creativesList all creatives in an ad account
List all creatives in an ad account
No parameter schema in public metadata yet.
get_creativeSingle creative by ID
Single creative by ID
No parameter schema in public metadata yet.
create_ad_creativeSingle-text creative via object_story_spec
Single-text creative via object_story_spec
No parameter schema in public metadata yet.
create_ad_creative_with_asset_feedDynamic/multi-text creative via asset_feed_spec
Dynamic/multi-text creative via asset_feed_spec
No parameter schema in public metadata yet.
upload_videoUpload video via remote URL (returns video_id)
Upload video via remote URL (returns video_id)
No parameter schema in public metadata yet.
upload_imageUpload image via remote URL (returns image_hash, scoped to account)
Upload image via remote URL (returns image_hash, scoped to account)
No parameter schema in public metadata yet.
get_campaign_insightsMetrics at campaign level with breakdowns
Metrics at campaign level with breakdowns
No parameter schema in public metadata yet.
get_adset_insightsMetrics at ad set level
Metrics at ad set level
No parameter schema in public metadata yet.
get_ad_insightsMetrics at ad level (compare creatives)
Metrics at ad level (compare creatives)
No parameter schema in public metadata yet.
pause_campaigns_batchPause many campaigns via Batch API
Pause many campaigns via Batch API
No parameter schema in public metadata yet.
activate_campaigns_batchActivate many + pre-flight ads_volume check
Activate many + pre-flight ads_volume check
No parameter schema in public metadata yet.
update_bids_batchUpdate bid_amount on many ad sets
Update bid_amount on many ad sets
No parameter schema in public metadata yet.
list_pagesFacebook Pages the token can manage
Facebook Pages the token can manage
No parameter schema in public metadata yet.
get_pbiaGet or auto-create a Page-Backed Instagram Account
Get or auto-create a Page-Backed Instagram Account
No parameter schema in public metadata yet.
search_ads_libraryPublic Meta Ad Library search for competitive research
Public Meta Ad Library search for competitive research
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
META_ACCESS_TOKEN*secretMeta Marketing API token (System User or Graph API Explorer). See README.
Readme
Meta Ads MCP by ScaleForge
Control Facebook & Instagram Ads from Claude, ChatGPT, Cursor, or any MCP-compatible agent.
Direct Meta Graph API v24.0 wrapper. 32 tools. No backend required — just bring your own Meta access token.
The problem
Meta's Marketing API is powerful but punishing. Anyone who's tried to automate Meta Ads has run into these five walls:
Details
- Repository
- github.com/mike25app/scaleforge-mcp-meta-ads
- Website
- getscaleforge.com
- Categories
- Finance & Commerce, Media & Entertainment
- Package
@getscaleforge/mcp-meta-ads- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Finance & Commerce MCP servers
View all
Quickbooks Mcp Servernyxtoolsdev/quickbooks-mcp-serverConnect Claude to QuickBooks Online — query finances, create invoices, run reports0stars
Trading Mcporderlynetwork/trading-mcpOrderly Network trading MCP server backed by the orderly CLI. Keys stay in the OS keychain.0stars
Ads AI Creator MCProcnubie/ads-ai-creator-mcpAds AI Creator generates ad creatives, copy, and visuals using AI so marketers can iterate on0stars
Newsletter Commerce Mcpteamsincetoday/newsletter-commerce-mcpExtract shoppable products from newsletter content with affiliate signals.0starsPodcast Commerce Mcpteamsincetoday/podcast-commerce-mcpExtract product mentions from podcast transcripts with affiliate signals. Free tier 200/day.0stars
Polymarket Guardevidai/agent-payment-mcpPolymarket prediction markets — buy/sell positions in USDC. LemonCake pay-per-call billing.0stars