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.
Meta Ads Mcp Scaleforge is an MCP project maintained in the mike25app/scaleforge-mcp-meta-ads repository. The maintainer describes its purpose as “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 —…”. Read the project documentation for the complete scope.
The documented npm package is @getscaleforge/mcp-meta-ads. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares META_ACCESS_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| list_ad_accounts | List Ad Accounts accessible to the token |
| get_ad_account | Detailed info for one account (status, spend cap, balance) |
| get_ads_volume | Per-Page running-ads count + limit + remaining slots (pre-flight check) |
| list_campaigns | Paginated campaign list |
| get_campaign | Single campaign by ID |
| create_campaign | WRITE — create new campaign (defaults to PAUSED) |
| update_campaign | WRITE — update any mutable field |
| delete_campaign | WRITE — hard delete |
| list_adsets | List by ad_account_id OR campaign_id |
| get_adset | Single ad set by ID |
| create_adset | WRITE — create ad set under a campaign |
| update_adset | WRITE — update targeting, bid, budget, status |
| delete_adset | WRITE — hard delete |
| list_ads | List by ad_account_id, adset_id, or campaign_id |
| get_ad | Single ad by ID (incl. creative + issues + preview link) |
| update_ad | WRITE — update name, status, swap creative |
| delete_ad | WRITE — hard delete |
| list_creatives | List all creatives in an ad account |
| get_creative | Single creative by ID |
| create_ad_creative | WRITE — single-text creative via object_story_spec |
| create_ad_creative_with_asset_feed | WRITE — dynamic/multi-text creative via asset_feed_spec |
| upload_video | WRITE — upload video via remote URL (returns video_id) |
| upload_image | WRITE — upload image via remote URL (returns image_hash, scoped to account) |
| get_campaign_insights | Metrics at campaign level with breakdowns |
| get_adset_insights | Metrics at ad set level |
| get_ad_insights | Metrics at ad level (compare creatives) |
| pause_campaigns_batch | WRITE (BULK) — pause many campaigns via Batch API |
| activate_campaigns_batch | WRITE (BULK) — activate many + pre-flight ads_volume check |
| update_bids_batch | WRITE (BULK) — update bid_amount on many ad sets |
| list_pages | Facebook Pages the token can manage |
| get_pbia | Get or auto-create a Page-Backed Instagram Account |
| search_ads_library | Public Meta Ad Library search for competitive research |
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": [
"-y",
"@getscaleforge/mcp-meta-ads"
],
"env": {
"META_ACCESS_TOKEN": "YOUR_META_ACCESS_TOKEN"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| META_ACCESS_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
Search built for AI, not humans — semantic web search that returns model-ready content, plus code context.
Put 6,000+ pre-built scrapers at your assistant's fingertips through one MCP endpoint.
Fetches and analyzes content from Reddit, providing access to hot threads and post details.
Enables interaction with X (formerly Twitter) for retrieving tweets, creating new posts, and replying to existing ones.
Automates LinkedIn interactions and extracts data through browser automation, respecting terms of service and rate limits.
Automates SEO tasks and provides AI-powered optimization by integrating with the Google Ads Keyword Planner API.