@mikusnuz/meta-ads-mcp

finance MCP Server

MCP server for Meta Marketing API v25.0 — 135 tools for Facebook & Instagram ad campaign management

Install Ready
financefinance
6 views49 stars7 forksv1.3.0MIT

Why This Matters

Discovered via unknown and last synced 3mo ago.

Install Ready
Source
unknown
Stars
49
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx -y @mikusnuz/meta-ads-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "mikusnuz-meta-ads-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

154
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (154)

META_AD_ACCOUNT_ID

**Yes**

META_ADS_ACCESS_TOKEN

**Yes**

get_campaign

Get campaign details by ID

Variable

Required

list_campaigns

List campaigns with filtering and pagination

get_campaign_ads

List ads within a campaign

delete_adset

Delete an ad set

get_campaign_adsets

List ad sets within a campaign

copy_adset

Copy an existing ad set to same or different campaign

delete_ad

Delete an ad

update_creative

Update an ad creative

get_adset_ads

List ads within an ad set

get_adset_leads

Get leads from an ad set

list_ads

List ads with filtering

list_images

List ad images

list_canvases

List Instant Experience canvases

update_audience

Update audience settings

update_rule

Update a rule

copy_ad

Copy an existing ad to same or different ad set

create_dynamic_creative

Create a dynamic creative

upload_video

Upload a video from URL

list_custom_audiences

List custom audiences

get_ad_preview

Generate ad preview HTML

generate_preview

Generate ad preview from creative spec without an existing ad

remove_users_from_audience

Remove users from a custom audience

get_reach_estimate

Estimate audience reach for targeting spec

get_async_report

Poll async report status and results

search_locations

Search targetable locations

get_ad_insights

Ad-level performance metrics

get_lead_form

Get lead form details

get_product_set

Get product set details

list_product_sets

List product sets in a catalog

update_product_set

Update a product set

batch_products

Batch create, update, or delete products (up to 5,000/request)

list_feeds

List data feeds for a catalog

list_rules

List automated rules

get_rule

Get rule details

update_experiment

Update an experiment

list_budget_schedules

List budget schedules

create_rule

Create an automated rule

create_experiment

Create an experiment

create_offline_event_set

Create an offline event set

get_rf_prediction

Get prediction details

get_experiment_results

Get experiment results

create_budget_schedule

Create a budget schedule

Permission

Tools

send_offline_event

Send an offline conversion event

list_rf_predictions

List Reach & Frequency predictions

remove_from_block_list

Remove entries from a block list

list_businesses

List businesses you have access to

list_business_pages

List Facebook Pages owned by a business

list_business_instagram_accounts

List Instagram accounts owned by a business

list_system_users

List system users for a business

URI

Description

business_management

Business tools, system users, account assignments

exchange_token

Exchange short-lived token for long-lived token

performance_report

Analyze ad performance with detailed breakdowns and recommendations

pages_read_engagement

Lead forms linked to pages

search_ad_library

Search Meta Ad Library for public ad data

ads_read

All read/list operations and insights

Prompt

Description

leads_retrieval

Lead form and lead data tools

audience_builder

Build and refine target audiences using Meta's targeting tools

META_PIXEL_ID

Optional

get_delivery_estimate

Get delivery estimate for an ad

create_campaign

Create a new campaign

create_adset

Create a new ad set

create_ad

Create a new ad

create_creative

Create a new ad creative

list_videos

List ad videos

list_saved_audiences

List saved audiences

get_campaign_insights

Campaign-level performance metrics

list_lead_forms

List lead gen forms for a page

list_experiments

List A/B test experiments

delete_rf_prediction

Delete a prediction

list_ad_accounts

List ad accounts for a business

remove_business_user

Remove a user from a business

get_campaign_leads

Get leads from a campaign

upload_image

Upload an image from URL

create_canvas

Create a canvas

get_targeting_suggestions

Get related targeting suggestions

get_form_leads

Get leads from a lead form

update_catalog

Update a catalog

create_feed

Create a data feed

send_conversion_event

Send server-side conversion event via Conversions API

delete_block_list

Delete a block list

list_business_ad_accounts

List ad accounts in a business

list_adsets

List ad sets with filtering

list_creatives

List ad creatives

get_image

Get image details

delete_canvas

Delete a canvas

create_lookalike_audience

Create a lookalike audience

get_lead

Get a single lead by ID

upload_feed

Upload data to a feed

delete_rule

Delete a rule

create_rf_prediction

Create a Reach & Frequency prediction

list_business_users

List users in a business

refresh_token

Refresh a long-lived token

META_BUSINESS_ID

Optional

get_adset_targeting_sentence

Get human-readable targeting description

delete_audience

Delete an audience

search_targeting_map

Browse targeting category tree

get_catalog

Get catalog details

update_product

Update a product

update_budget_schedule

Update a budget schedule

add_to_block_list

Add URLs/domains to a block list

create_system_user

Create a system user

campaign_wizard

Step-by-step guide to create a full ad campaign from scratch

META_APP_ID

Optional

META_APP_SECRET

Optional

delete_campaign

Delete a campaign

copy_campaign

Copy an existing campaign with ad sets and ads

get_adset

Get ad set details by ID

get_ad

Get ad details by ID

get_creative

Get creative details

delete_image

Delete an image

get_video

Get video details

delete_video

Delete a video

create_custom_audience

Create a custom audience

get_audience_health

Get audience health, delivery status, and match rate

search_targeting

Search targeting interests, behaviors, demographics

get_account_insights

Account-level performance metrics

create_async_report

Create an async insights report

create_lead_form

Create a new lead generation form on a page

list_catalogs

List product catalogs

create_product_set

Create a product set

list_products

List products in a catalog

get_product

Get product details

get_feed_uploads

Get feed upload history

get_experiment

Get experiment details

list_offline_event_sets

List offline event sets

list_block_lists

List publisher block lists

create_block_list

Create a block list

get_ad_account

Get ad account details

get_account_activities

Get account activity log

list_account_users

List users with access to the account

add_business_user

Add a user to a business

debug_token

Debug/inspect token metadata

ads_management

All campaign, ad set, ad, and creative CRUD operations

catalog_management

Catalog, product set, product, and feed tools

update_campaign

Update campaign settings

update_adset

Update ad set settings

update_ad

Update ad settings

get_audience

Get audience details

get_saved_audience

Get saved audience details

get_adset_insights

Ad set-level performance metrics

get_batch_status

Check status of a catalog batch operation

update_ad_account

Update ad account settings

get_canvas

Get canvas details

add_users_to_audience

Add users to a custom audience

create_catalog

Create a product catalog

delete_budget_schedule

Delete a budget schedule

get_business

Get business details

Tool

Description