{
  "markdown": "# meta-ads-mcp\n\n[![npm version](https://img.shields.io/npm/v/@mikusnuz/meta-ads-mcp.svg)](https://www.npmjs.com/package/@mikusnuz/meta-ads-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP server for the **Meta Marketing API v26.0** — 135 tools for managing Facebook & Instagram ad campaigns, audiences, creatives, insights, catalogs, and more.\n\n## When to Use\n\nUse this MCP when you need to:\n\n- **\"Create a new Facebook ad campaign\"** — use `create_campaign`, `create_adset`, `create_ad`, and `create_creative` to build a full funnel\n- **\"Check how my ads are performing today\"** — use `get_account_insights` or `get_campaign_insights` with today's date range\n- **\"Pause all campaigns with ROAS below 2\"** — use `list_campaigns` + `get_campaign_insights` to find underperformers, then `update_campaign` to pause\n- **\"Set up A/B test between two ad creatives\"** — use `create_experiment` to run a controlled test between ad sets\n- **\"Create a lookalike audience from my customers\"** — use `create_custom_audience`, `add_users_to_audience`, then `create_lookalike_audience`\n- **\"Upload ad images and create a carousel ad\"** — use `upload_image` for each image, then `create_creative` with carousel format\n- **\"Get a detailed performance report for last 30 days\"** — use `create_async_report` for large date ranges, then `get_async_report` to retrieve\n- **\"Search the Facebook Ad Library for competitor ads\"** — use `search_ad_library` to find public ad data\n- **\"Set up automated rules to pause underperforming ads\"** — use `create_rule` with conditions like CPA > threshold\n- **\"Manage my product catalog for dynamic ads\"** — use `create_catalog`, `create_feed`, and `upload_feed` to set up dynamic product ads\n\n## Installation\n\n```json\n{\n  \"mcpServers\": {\n    \"meta-ads\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mikusnuz/meta-ads-mcp\"],\n      \"env\": {\n        \"META_ADS_ACCESS_TOKEN\": \"your-access-token\",\n        \"META_AD_ACCOUNT_ID\": \"123456789\",\n        \"META_APP_ID\": \"your-app-id\",\n        \"META_APP_SECRET\": \"your-app-secret\",\n        \"META_BUSINESS_ID\": \"your-business-id\",\n        \"META_PIXEL_ID\": \"your-pixel-id\"\n      }\n    }\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `META_ADS_ACCESS_TOKEN` | **Yes** | Meta Marketing API access token |\n| `META_AD_ACCOUNT_ID` | **Yes** | Ad account ID (numeric, without `act_` prefix) |\n| `META_APP_ID` | Optional | App ID — required for token exchange/extension and debug |\n| `META_APP_SECRET` | Optional | App secret — required for token exchange/extension and debug |\n| `META_BUSINESS_ID` | Optional | Business Manager ID — required for business tools |\n| `META_PIXEL_ID` | Optional | Pixel ID — required for conversion tools |\n\n## Tools (135)\n\n### Campaign Management (25)\n\n| Tool | Description |\n|---|---|\n| `list_campaigns` | List campaigns with filtering and pagination |\n| `get_campaign` | Get campaign details by ID |\n| `create_campaign` | Create a new campaign |\n| `update_campaign` | Update campaign settings |\n| `delete_campaign` | Delete a campaign |\n| `copy_campaign` | Copy an existing campaign with ad sets and ads |\n| `get_campaign_adsets` | List ad sets within a campaign |\n| `get_campaign_ads` | List ads within a campaign |\n| `get_campaign_leads` | Get leads from a campaign |\n| `list_adsets` | List ad sets with filtering |\n| `get_adset` | Get ad set details by ID |\n| `create_adset` | Create a new ad set |\n| `update_adset` | Update ad set settings |\n| `delete_adset` | Delete an ad set |\n| `copy_adset` | Copy an existing ad set to same or different campaign |\n| `get_adset_targeting_sentence` | Get human-readable targeting description |\n| `get_adset_ads` | List ads within an ad set |\n| `get_adset_leads` | Get leads from an ad set |\n| `list_ads` | List ads with filtering |\n| `get_ad` | Get ad details by ID |\n| `create_ad` | Create a new ad |\n| `update_ad` | Update ad settings |\n| `delete_ad` | Delete an ad |\n| `copy_ad` | Copy an existing ad to same or different ad set |\n| `get_ad_preview` | Generate ad preview HTML |\n| `get_delivery_estimate` | Get delivery estimate for an ad set |\n\n### Creatives (6)\n\n| Tool | Description |\n|---|---|\n| `list_creatives` | List ad creatives |\n| `get_creative` | Get creative details |\n| `create_creative` | Create a new ad creative |\n| `update_creative` | Update an ad creative |\n| `create_dynamic_creative` | Create a dynamic creative |\n| `generate_preview` | Generate ad preview from creative spec without an existing ad |\n\n### Media Assets (12)\n\n| Tool | Description |\n|---|---|\n| `list_images` | List ad images |\n| `upload_image` | Upload an image from a URL or local file |\n| `get_image` | Get image details |\n| `delete_image` | Delete an image |\n| `list_videos` | List ad videos |\n| `upload_video` | Upload a video from a URL or local file |\n| `get_video` | Get video details |\n| `delete_video` | Delete a video |\n| `list_canvases` | List Instant Experience canvases |\n| `get_canvas` | Get canvas details |\n| `create_canvas` | Create a canvas |\n| `delete_canvas` | Delete a canvas |\n\n### Audiences & Targeting (16)\n\n| Tool | Description |\n|---|---|\n| `list_custom_audiences` | List custom audiences |\n| `get_audience` | Get audience details |\n| `create_custom_audience` | Create a custom audience |\n| `update_audience` | Update audience settings |\n| `delete_audience` | Delete an audience |\n| `add_users_to_audience` | Add users to a custom audience |\n| `remove_users_from_audience` | Remove users from a custom audience |\n| `create_lookalike_audience` | Create a lookalike audience |\n| `get_audience_health` | Get audience health, delivery status, and match rate |\n| `list_saved_audiences` | List saved audiences |\n| `get_saved_audience` | Get saved audience details |\n| `search_targeting` | Search targeting interests, behaviors, demographics |\n| `search_locations` | Search targetable locations |\n| `search_targeting_map` | Browse targeting category tree |\n| `get_reach_estimate` | Estimate audience reach for targeting spec |\n| `get_targeting_suggestions` | Get related targeting suggestions |\n\n### Insights & Reporting (6)\n\n| Tool | Description |\n|---|---|\n| `get_account_insights` | Account-level performance metrics |\n| `get_campaign_insights` | Campaign-level performance metrics |\n| `get_adset_insights` | Ad set-level performance metrics |\n| `get_ad_insights` | Ad-level performance metrics |\n| `create_async_report` | Create an async insights report |\n| `get_async_report` | Poll the report-run status, then fetch its `/insights` results when complete |\n\n`date_preset` values are lowercase Graph API identifiers such as `today`, `yesterday`, `last_7d`, and `last_30d`. `create_async_report` always creates an asynchronous job; `get_async_report` returns status immediately and, by default, fetches the paginated result edge after the status becomes `Job Completed`.\n\n### Leads (5)\n\n| Tool | Description |\n|---|---|\n| `get_form_leads` | Get leads from a lead form |\n| `get_lead` | Get a single lead by ID |\n| `create_lead_form` | Create a new lead generation form on a page |\n| `list_lead_forms` | List lead gen forms for a page |\n| `get_lead_form` | Get lead form details |\n\n### Catalog & Commerce (17)\n\n| Tool | Description |\n|---|---|\n| `list_catalogs` | List product catalogs |\n| `get_catalog` | Get catalog details |\n| `create_catalog` | Create a product catalog |\n| `update_catalog` | Update a catalog |\n| `list_product_sets` | List product sets in a catalog |\n| `create_product_set` | Create a product set |\n| `get_product_set` | Get product set details |\n| `update_product_set` | Update a product set |\n| `list_products` | List products in a catalog |\n| `get_product` | Get product details |\n| `update_product` | Update a product |\n| `list_feeds` | List data feeds for a catalog |\n| `create_feed` | Create a data feed |\n| `upload_feed` | Upload data to a feed |\n| `get_feed_uploads` | Get feed upload history |\n| `batch_products` | Batch create, update, or delete products (up to 5,000/request) |\n| `get_batch_status` | Check status of a catalog batch operation |\n\n### Automation & Rules (5)\n\n| Tool | Description |\n|---|---|\n| `list_rules` | List automated rules |\n| `get_rule` | Get rule details |\n| `create_rule` | Create an automated rule |\n| `update_rule` | Update a rule |\n| `delete_rule` | Delete a rule |\n\n### Experiments (5)\n\n| Tool | Description |\n|---|---|\n| `list_experiments` | List A/B test experiments |\n| `create_experiment` | Create an experiment |\n| `get_experiment` | Get experiment details |\n| `update_experiment` | Update an experiment |\n| `get_experiment_results` | Get experiment results |\n\n### Conversions (4)\n\n| Tool | Description |\n|---|---|\n| `send_conversion_event` | Send server-side conversion event via Conversions API |\n| `send_offline_event` | Send an offline conversion event |\n| `list_offline_event_sets` | List offline event sets |\n| `create_offline_event_set` | Create an offline event set |\n\n### Budget & Planning (8)\n\n| Tool | Description |\n|---|---|\n| `list_budget_schedules` | List schedules from a campaign or ad set `budget_schedules` edge |\n| `create_budget_schedule` | Create a schedule on a campaign or ad set |\n| `update_budget_schedule` | Update a budget schedule |\n| `delete_budget_schedule` | Delete a budget schedule |\n| `list_rf_predictions` | List Reach & Frequency predictions |\n| `create_rf_prediction` | Create a Reach & Frequency prediction |\n| `get_rf_prediction` | Get prediction details |\n| `delete_rf_prediction` | Delete a prediction |\n\n### Brand Safety (5)\n\n| Tool | Description |\n|---|---|\n| `list_block_lists` | List publisher block lists |\n| `create_block_list` | Create a block list |\n| `add_to_block_list` | Add URLs/domains to a block list |\n| `remove_from_block_list` | Remove entries from a block list |\n| `delete_block_list` | Delete a block list |\n\n### Account & Business (15)\n\n| Tool | Description |\n|---|---|\n| `get_ad_account` | Get ad account details |\n| `list_ad_accounts` | List ad accounts for a business |\n| `update_ad_account` | Update ad account settings |\n| `get_account_activities` | Get account activity log |\n| `list_account_users` | List users with access to the account |\n| `list_businesses` | List businesses you have access to |\n| `get_business` | Get business details |\n| `list_business_ad_accounts` | List ad accounts in a business |\n| `list_business_users` | List users in a business |\n| `add_business_user` | Add a user to a business |\n| `remove_business_user` | Remove a user from a business |\n| `list_business_pages` | List Facebook Pages owned by a business |\n| `list_business_instagram_accounts` | List Instagram accounts owned by a business |\n| `list_system_users` | List system users for a business |\n| `create_system_user` | Create a system user |\n\n### Auth & Token (3)\n\n| Tool | Description |\n|---|---|\n| `exchange_token` | Exchange short-lived token for long-lived token |\n| `refresh_token` | Extend a valid long-lived user token through the documented exchange flow |\n| `debug_token` | Debug/inspect token metadata |\n\n### Ad Library (1)\n\n| Tool | Description |\n|---|---|\n| `search_ad_library` | Search Meta Ad Library for public ad data |\n\n## Resources (3)\n\n| URI | Description |\n|---|---|\n| `ads://account` | Ad account overview — status, balance, currency, timezone, and total spend |\n| `ads://campaigns-overview` | All active campaigns with budget information |\n| `ads://spending-today` | Today's spending summary — spend, impressions, clicks, and reach |\n\n## Prompts (3)\n\n| Prompt | Description |\n|---|---|\n| `campaign_wizard` | Step-by-step guide to create a full ad campaign from scratch |\n| `performance_report` | Analyze ad performance with detailed breakdowns and recommendations |\n| `audience_builder` | Build and refine target audiences using Meta's targeting tools |\n\n## Permissions Required\n\nYour Meta access token needs the following permissions depending on which tools you use:\n\n| Permission | Tools |\n|---|---|\n| `ads_management` | All campaign, ad set, ad, and creative CRUD operations |\n| `ads_read` | All read/list operations and insights |\n| `business_management` | Business tools, system users, account assignments |\n| `leads_retrieval` | Lead form and lead data tools |\n| `catalog_management` | Catalog, product set, product, and feed tools |\n| `pages_read_engagement` | Lead forms linked to pages |\n\n## License\n\nMIT\n",
  "bytes": 12408,
  "sha": "6e4cbf699c11e528a19937d5998754ab08a85108c4437f185ce9b1f986c55421",
  "repo_slug": "mikusnuz/meta-ads-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mikusnuz_meta_ads_b8653e61/readme"
}