Disclaimer: This is an unofficial third-party tool and is not associated with, endorsed by, or affiliated with Meta in any way. This project is maintained independently and uses Meta's public APIs…
meta-ads-mcp-server is an MCP project maintained in the hashcott/meta-ads-mcp-server repository. The maintainer describes its purpose as “Disclaimer: This is an unofficial third-party tool and is not associated with, endorsed by, or affiliated with Meta in any way. This project is maintained…”. Read the project documentation for the complete scope.
The documented npm package is meta-ads-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares META_ADS_ACCESS_TOKEN, META_ADS_ENABLE_WRITE_TOOLS. 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 |
|---|---|
| bid_strategy | LOWEST_COST_WITHOUT_CAP (default), LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS. Bid-cap strategies require bid_amount on every child ad set. |
| bid_amount | required for LOWEST_COST_WITH_BID_CAP / COST_CAP. |
| bid_constraints | required for LOWEST_COST_WITH_MIN_ROAS, e.g., {"roas_average_floor": 20000} for a 2.0× ROAS floor. |
| promoted_object | required for APP_INSTALLS. |
| frequency_control_specs | MUST be set at creation; Meta makes it immutable afterward. |
| file | a data URL (data:image/png;base64,iVBORw0KG...) or a raw base64 string. |
| image_url | a public URL; the server downloads the bytes and uploads them. |
| budget_value_type | ABSOLUTE (cents in account currency) or MULTIPLIER (e.g., 2 doubles the budget) |
| meta_ads_list_ad_accounts | 🔍 |
| meta_ads_get_ad_account_details | 🔍 |
| meta_ads_get_campaign_by_id | 🔍 |
| meta_ads_get_campaigns_by_adaccount | 🔍 |
| meta_ads_create_campaign | ✏️ |
| meta_ads_update_campaign | ✏️ |
| meta_ads_delete_campaign | ✏️ |
| meta_ads_pause_campaign | ✏️ |
| meta_ads_resume_campaign | ✏️ |
| meta_ads_get_adset_by_id | 🔍 |
| meta_ads_get_adsets_by_ids | 🔍 |
| meta_ads_get_adsets_by_adaccount | 🔍 |
| meta_ads_get_adsets_by_campaign | 🔍 |
| meta_ads_create_adset | ✏️ |
| meta_ads_update_adset | ✏️ |
| meta_ads_delete_adset | ✏️ |
| meta_ads_pause_adset | ✏️ |
| meta_ads_resume_adset | ✏️ |
| meta_ads_get_ad_by_id | 🔍 |
| meta_ads_get_ads_by_adaccount | 🔍 |
| meta_ads_get_ads_by_campaign | 🔍 |
| meta_ads_get_ads_by_adset | 🔍 |
| meta_ads_create_ad | ✏️ |
| meta_ads_update_ad | ✏️ |
| meta_ads_delete_ad | ✏️ |
| meta_ads_pause_ad | ✏️ |
| meta_ads_resume_ad | ✏️ |
| meta_ads_get_ad_creative_by_id | 🔍 |
| meta_ads_get_ad_creatives_by_ad_id | 🔍 |
| meta_ads_get_adcreatives_by_adaccount | 🔍 |
| meta_ads_compute_image_crops | 🛠️ |
| meta_ads_create_ad_creative | ✏️ |
| meta_ads_update_ad_creative | ✏️ |
| meta_ads_get_ad_images | 🔍 |
| meta_ads_get_image_by_hash | 🔍 |
| meta_ads_get_ad_previews | 🔍 |
| meta_ads_get_ad_video | 🔍 |
| meta_ads_upload_ad_image | ✏️ |
| meta_ads_get_adaccount_insights | 🔍 |
| meta_ads_get_campaign_insights | 🔍 |
| meta_ads_get_adset_insights | 🔍 |
| meta_ads_get_ad_insights | 🔍 |
| meta_ads_search_interests | 🔍 |
| meta_ads_get_interest_suggestions | 🔍 |
| meta_ads_search_behaviors | 🔍 |
| meta_ads_search_demographics | 🔍 |
| meta_ads_search_geo_locations | 🔍 |
| meta_ads_estimate_audience_size | 🔍 |
| meta_ads_get_account_pages | 🔍 |
| meta_ads_search_pages_by_name | 🔍 |
| meta_ads_create_budget_schedule | ✏️ |
| meta_ads_get_activities_by_adaccount | 🔍 |
| meta_ads_get_activities_by_adset | 🔍 |
| meta_ads_fetch_pagination_url | 🛠️ |
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": [
"-y",
"meta-ads-mcp-server"
],
"env": {
"META_ADS_ACCESS_TOKEN": "YOUR_META_ADS_ACCESS_TOKEN",
"META_ADS_ENABLE_WRITE_TOOLS": "true"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| META_ADS_ACCESS_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
| META_ADS_ENABLE_WRITE_TOOLS | 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.