{"_id":"@mikusnuz/meta-ads-mcp","_rev":"6-0fdc6e97ea1b4ac8ba1ef081c3e148e8","name":"@mikusnuz/meta-ads-mcp","dist-tags":{"latest":"1.4.1"},"versions":{"1.2.0":{"name":"@mikusnuz/meta-ads-mcp","version":"1.2.0","keywords":["mcp","meta","facebook","instagram","ads","marketing","advertising","campaign"],"author":{"name":"mikusnuz"},"license":"MIT","_id":"@mikusnuz/meta-ads-mcp@1.2.0","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/meta-ads-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/meta-ads-mcp/issues"},"bin":{"meta-ads-mcp":"dist/index.js"},"dist":{"shasum":"40d16fefa2df12f47eb44ba541ad30d9c4d47262","tarball":"https://registry.npmjs.org/@mikusnuz/meta-ads-mcp/-/meta-ads-mcp-1.2.0.tgz","fileCount":120,"integrity":"sha512-14coW1HPMGwZkzJYxUdN6OxeqH5FkSV+ai39Suxp2LCR69dvv6XfzTyF79wgn50J+wmtJzYXt5gH9A3RaMf1ug==","signatures":[{"sig":"MEYCIQDR/8nAif5ccJfvc0wLQk21DhwsjAOe+z1ydev7E2OQQAIhALksmoRH5iNKtZKOrXliyXfVcJ39sbu+E14DmJHbWg8/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":357123},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"ab999a0b5ca51d36519a58e8d6a8eb006ba437d1","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/meta-ads-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Meta Marketing API v25.0 — 123 tools for Facebook & Instagram ad campaign management","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/meta-ads-mcp_1.2.0_1773910010316_0.01727042172078086","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@mikusnuz/meta-ads-mcp","version":"1.2.1","keywords":["mcp","meta","facebook","instagram","ads","marketing","advertising","campaign"],"author":{"name":"mikusnuz"},"license":"MIT","_id":"@mikusnuz/meta-ads-mcp@1.2.1","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/meta-ads-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/meta-ads-mcp/issues"},"bin":{"meta-ads-mcp":"dist/index.js"},"dist":{"shasum":"421c1966a1cd2590013fd1e5bbb0b2cdc315002c","tarball":"https://registry.npmjs.org/@mikusnuz/meta-ads-mcp/-/meta-ads-mcp-1.2.1.tgz","fileCount":120,"integrity":"sha512-Cz2d2Yp3Wu16IolKNRiFIiUKJ3YZm7dOVIeVCHoCBqIh3rhREbJKn49yTvJ2TzulDNovb1SOLZvOhHOM8a2Yrw==","signatures":[{"sig":"MEUCIFLGo81b82lkBcHD5yYg91sfeEJXV6SvV9BbKoQP7E64AiEA0opQii4VH94jCXBMGpEX6533A0mXCGBGO1U9iMZAlEU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":363185},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"94cbd96e64766f1a1e96bef871d2d354b2715c7c","mcpName":"io.github.mikusnuz/meta-ads","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/meta-ads-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Meta Marketing API v25.0 — 123 tools for Facebook & Instagram ad campaign management","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/meta-ads-mcp_1.2.1_1773945035635_0.2857654642218117","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@mikusnuz/meta-ads-mcp","version":"1.3.0","keywords":["mcp","meta","facebook","instagram","ads","marketing","advertising","campaign"],"author":{"name":"mikusnuz"},"license":"MIT","_id":"@mikusnuz/meta-ads-mcp@1.3.0","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/meta-ads-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/meta-ads-mcp/issues"},"bin":{"meta-ads-mcp":"dist/index.js"},"dist":{"shasum":"46d3a34f145385673d2f3a44839c737c568eb292","tarball":"https://registry.npmjs.org/@mikusnuz/meta-ads-mcp/-/meta-ads-mcp-1.3.0.tgz","fileCount":120,"integrity":"sha512-OakMp5IyELB9LurSyd3yK0jpGemas+9y6TBAt+zg7O/W5X3V35bC39JwoEIG4TbwF5A1wD/qsGsS2EE6DqAwGg==","signatures":[{"sig":"MEQCIFwv4eJZaqO9eKF5b2482tyY2JH5JokU49Q3XpfSHmV4AiBGLj2doqU4g6DqEgHDXvbkjXSzOHC3HhBfR3Rrb4xOIA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":391874},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"d9b5ee2443170fef40255624e12ef0efac8e8065","mcpName":"io.github.mikusnuz/meta-ads","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/meta-ads-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Meta Marketing API v25.0 — 135 tools for Facebook & Instagram ad campaign management","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/meta-ads-mcp_1.3.0_1776025723088_0.9590191465158644","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@mikusnuz/meta-ads-mcp","version":"1.3.1","keywords":["mcp","meta","facebook","instagram","ads","marketing","advertising","campaign"],"author":{"name":"mikusnuz"},"license":"MIT","_id":"@mikusnuz/meta-ads-mcp@1.3.1","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/meta-ads-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/meta-ads-mcp/issues"},"bin":{"meta-ads-mcp":"dist/index.js"},"dist":{"shasum":"8203a653fbbd2cf2f65efef077910480b11e9edc","tarball":"https://registry.npmjs.org/@mikusnuz/meta-ads-mcp/-/meta-ads-mcp-1.3.1.tgz","fileCount":120,"integrity":"sha512-F+biwbiEruZpmxf1V08Nmf7Pu5GU89l4yIaSgw8ayPN9/2vrFFlpJi4hy12Qojj/PWP0cuDWX/hw0hGZrfJxag==","signatures":[{"sig":"MEYCIQC0DAHp6EiOBVfTMRdgwLVobVgAXqDFThajmMd6sCYMjAIhAOy0jw8QSrPvcLarzpgsTN7mTeXqYzRXEgW9YkaCE2Kv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":414921},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"0156b71bd75f38c392e0c1512e73571397bc61f5","mcpName":"io.github.mikusnuz/meta-ads","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/meta-ads-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Meta Marketing API v25.0 — 135 tools for Facebook & Instagram ad campaign management","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/meta-ads-mcp_1.3.1_1785832492415_0.2129215375849336","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@mikusnuz/meta-ads-mcp","version":"1.4.0","keywords":["mcp","meta","facebook","instagram","ads","marketing","advertising","campaign"],"author":{"name":"mikusnuz"},"license":"MIT","_id":"@mikusnuz/meta-ads-mcp@1.4.0","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"homepage":"https://github.com/mikusnuz/meta-ads-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/meta-ads-mcp/issues"},"bin":{"meta-ads-mcp":"dist/index.js"},"dist":{"shasum":"fa1384f4fcd984aeeea685fddd9e84ec0644be66","tarball":"https://registry.npmjs.org/@mikusnuz/meta-ads-mcp/-/meta-ads-mcp-1.4.0.tgz","fileCount":120,"integrity":"sha512-3VEbIw0OPIUlp3rFw6Ka8FbC4FRQuPiTYZCAYR92lyUaSyQqQCIbQLTTXjTMXNea627jS4IlbO3CN2BZj03GNQ==","signatures":[{"sig":"MEQCIGF8eoKo9rjzUdal7J3WbFhk44yKIXvb9gFfSAKro3POAiAxGKmNhbvEB5NqHFqZ6Oo7xvF8OSw6BtNAgeXh2koQcg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":420214},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b3ad5a12d8902a39c6a564bb4818389706426ad2","mcpName":"io.github.mikusnuz/meta-ads","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"repository":{"url":"git+https://github.com/mikusnuz/meta-ads-mcp.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for Meta Marketing API v26.0 — 135 tools for Facebook & Instagram ad campaign management","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/meta-ads-mcp_1.4.0_1786004376742_0.4860259912137106","host":"s3://npm-registry-packages-npm-production"}},"1.4.1":{"name":"@mikusnuz/meta-ads-mcp","version":"1.4.1","mcpName":"io.github.mikusnuz/meta-ads","description":"MCP server for Meta Marketing API v26.0 — 135 tools for Facebook & Instagram ad campaign management","type":"module","bin":{"meta-ads-mcp":"dist/index.js"},"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"engines":{"node":">=18"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts"},"keywords":["mcp","meta","facebook","instagram","ads","marketing","advertising","campaign"],"license":"MIT","author":{"name":"mikusnuz"},"repository":{"type":"git","url":"git+https://github.com/mikusnuz/meta-ads-mcp.git"},"homepage":"https://github.com/mikusnuz/meta-ads-mcp#readme","bugs":{"url":"https://github.com/mikusnuz/meta-ads-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","zod":"^3.25.76"},"devDependencies":{"@types/node":"^22.20.1","tsx":"^4.23.9","typescript":"^5.9.3"},"gitHead":"6ccf36c761e82359eea0d929024f58cd9d32e2cc","_id":"@mikusnuz/meta-ads-mcp@1.4.1","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-GhygI8s0uQxsM1t1vUbnhJhbdxElMm4s83d8nb8Q18Al+asBrip/2W+iddZ479h9zwkhCeKK6dYUtHKQEcSG9w==","shasum":"1afb81088de2d623d2e8755dc808de4c15574bcc","tarball":"https://registry.npmjs.org/@mikusnuz/meta-ads-mcp/-/meta-ads-mcp-1.4.1.tgz","fileCount":120,"unpackedSize":420216,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD3kmtZkuX4N+n4VGSE5WIDIzaDXRBqe4766+FmMY8nuwIgdHbjZUFm1O/d7GQRDxHB3WhmxGsr+eWTBiaQGQ/Yc8c="}]},"_npmUser":{"name":"mikusnuz","email":"jooon530@gmail.com"},"directories":{},"maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/meta-ads-mcp_1.4.1_1786005070203_0.11184121840433803"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T08:46:50.214Z","modified":"2026-08-06T08:31:10.719Z","1.2.0":"2026-03-19T08:46:50.437Z","1.2.1":"2026-03-19T18:30:35.800Z","1.3.0":"2026-04-12T20:28:43.236Z","1.3.1":"2026-08-04T08:34:52.553Z","1.4.0":"2026-08-06T08:19:36.856Z","1.4.1":"2026-08-06T08:31:10.387Z"},"bugs":{"url":"https://github.com/mikusnuz/meta-ads-mcp/issues"},"author":{"name":"mikusnuz"},"license":"MIT","homepage":"https://github.com/mikusnuz/meta-ads-mcp#readme","keywords":["mcp","meta","facebook","instagram","ads","marketing","advertising","campaign"],"repository":{"type":"git","url":"git+https://github.com/mikusnuz/meta-ads-mcp.git"},"description":"MCP server for Meta Marketing API v26.0 — 135 tools for Facebook & Instagram ad campaign management","maintainers":[{"name":"mikusnuz","email":"jooon530@gmail.com"}],"readme":"# 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/debug |\n| `META_APP_SECRET` | Optional | App secret — required for token exchange/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 async report status and results |\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 budget schedules |\n| `create_budget_schedule` | Create a budget schedule |\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` | Refresh a long-lived token |\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","readmeFilename":"README.md"}