Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.mikusnuz/meta-ads

NPM · @MIKUSNUZ/META-ADS-MCP

MCP server for Meta Marketing API — Facebook & Instagram ad campaign management

−1 this week 78 Trust /100

Last scanned (2 hours ago)

Scores higher than 58% of npm servers

Category Marketing and SEO

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security81
  • No malware found by supply-chain analysis.Pass
  • CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available. View diagnostics → Fail
  • No install/post-install scripts declared.Pass
  • 30 of 93 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability85
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 13559 tokens (~98/item across 137 items; 134 tools + 3 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management93
  • Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 16 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "delete_campaign" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 135 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 4 Nov 26 −1
    • Stability: fail → 0.90 functional
  • 29 Oct 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 95 to 98.

  • 27 Oct 26 −1

    No change was recorded against any check on this day. Stability & Change Management went from 98 to 92.

  • 24 Oct 26 −5
    • CVE-2023-54404 affects this package: high ▼ security
    • Known CVEs: pass → fail ▼ security
  • 20 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
  • 19 Oct 26 −13
    • Malware scan: pass → unverified ▼ security
    • Judged manipulation: unverified → pass ▲ security
    • Package version: 1.5.0 → 1.6.1 functional
  • 17 Oct 26 +2

    No change was recorded against any check on this day. Stability & Change Management went from 82 to 98.

  • 15 Oct 26 −2

    No change was recorded against any check on this day. Stability & Change Management went from 98 to 78.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 5 Nov 2026 · Analysed npm/@mikusnuz/meta-ads-mcp@1.6.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Vulnerabilities 1 finding
ID CVE Severity Vector Fix available
GHSA-mrhx-c7xc-m3w5 CVE-2023-54404 high CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H yes

Background: What a vulnerability scan can and cannot prove →

Dependencies 93 packages
Packages resolved 93
Stale 30
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 134 exposed · ~13,506 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
get_adset_leads ~78

Get leads generated by a specific ad set. Requires leads_retrieval permission.

NameTypeReqDescription
adset_idstringyesAd set ID
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

get_adset_targeting_sentence ~41

Get human-readable targeting description for an ad set. Converts targeting spec into readable sentences.

NameTypeReqDescription
adset_idstringyesAd set ID

No output schema declared.

No examples provided.

get_async_report ~101

Check status and retrieve results of an async insight report.

NameTypeReqDescription
afterstring–Pagination cursor for the result page
fieldsstring–Comma-separated insight fields to return once the job completes
include_resultsboolean–Fetch /{report_run_id}/insights when the job is complete
limitinteger–Maximum result rows per page
report_run_idstringyesReport run ID from create_async_report

No output schema declared.

No examples provided.

get_audience ~42

Get details of a specific custom audience by ID.

NameTypeReqDescription
audience_idstringyesAudience ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_audience_health ~42

Get health status and delivery readiness of a custom audience. Shows match rate, size, and operation status.

NameTypeReqDescription
audience_idstringyesCustom audience ID

No output schema declared.

No examples provided.

get_batch_status ~42

Check the status of a catalog batch operation.

NameTypeReqDescription
catalog_idstringyesProduct catalog ID
handlestringyesBatch handle returned from batch_products

No output schema declared.

No examples provided.

get_business ~40

Get details of a specific business by ID.

NameTypeReqDescription
business_idstringyesBusiness ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_campaign ~40

Get details of a specific campaign by ID.

NameTypeReqDescription
campaign_idstringyesCampaign ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_campaign_ads ~67

Get all ads belonging to a specific campaign.

NameTypeReqDescription
afterstring–Pagination cursor for next page
campaign_idstringyesCampaign ID
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

get_campaign_adsets ~69

Get all ad sets belonging to a specific campaign.

NameTypeReqDescription
afterstring–Pagination cursor for next page
campaign_idstringyesCampaign ID
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

get_campaign_insights ~236

Get performance insights for a specific campaign.

NameTypeReqDescription
breakdownsstring–Breakdown dimensions: age,gender,country,region,publisher_platform,platform_position,device_platform,comscore_market (replaces dma). Some accounts must opt in in Ads Manager for impression_device, ho…
campaign_idstringyesCampaign ID
date_presetstring–Lowercase date preset, for example: today, yesterday, last_7d, last_14d, last_30d, this_month, last_month, this_quarter, last_quarter, this_year, last_year
fieldsstring–Comma-separated insight fields
filteringstring–JSON string for filtering
levelstring–Aggregation level: campaign, adset, ad
time_incrementstring–Time granularity: all_days, 1, 7, monthly
time_rangestring–JSON string {since,until} in YYYY-MM-DD format

No output schema declared.

No examples provided.

get_campaign_leads ~74

Get leads generated by a specific campaign. Requires leads_retrieval permission.

NameTypeReqDescription
afterstring–Pagination cursor for next page
campaign_idstringyesCampaign ID
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

get_canvas ~44

Get details of a specific Instant Experience (Canvas) by ID.

NameTypeReqDescription
canvas_idstringyesCanvas ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_catalog ~40

Get details of a specific product catalog.

NameTypeReqDescription
catalog_idstringyesProduct catalog ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_creative ~42

Get details of a specific ad creative by ID.

NameTypeReqDescription
creative_idstringyesCreative ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_delivery_estimate ~107

Get delivery estimate for an ad set, including estimated daily reach. Note: the delivery_estimate edge exists on the ad set (and ad account) node, not on individual ads. Also note: as of v26.0, the daily_outcomes_curve, budget_guardrail, and estimate_dau fields are no longer returned (removed with no replacement).

NameTypeReqDescription
adset_idstringyesAd Set ID
optimization_goalstring–Optimization goal to estimate for

No output schema declared.

No examples provided.

get_experiment ~46

Get details of a specific experiment (ad study).

NameTypeReqDescription
experiment_idstringyesExperiment (ad study) ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_experiment_results ~48

Get results/cells of an experiment (ad study).

NameTypeReqDescription
experiment_idstringyesExperiment (ad study) ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_feed_uploads ~66

Get upload history for a product feed.

NameTypeReqDescription
afterstring–Pagination cursor for next page
feed_idstringyesProduct feed ID
fieldsstring–Comma-separated fields to return
limitnumber–Number of results to return

No output schema declared.

No examples provided.

get_form_leads ~67

Get leads submitted through a lead generation form.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
form_idstringyesLead form ID
limitnumber–Number of results to return

No output schema declared.

No examples provided.

get_image ~41

Get details of a specific ad image by ID.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
image_idstringyesImage ID

No output schema declared.

No examples provided.

get_lead ~41

Get details of a specific lead by ID.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
lead_idstringyesLead ID

No output schema declared.

No examples provided.

get_lead_form ~43

Get details of a specific lead generation form.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
form_idstringyesLead form ID

No output schema declared.

No examples provided.

get_product ~38

Get details of a specific product.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
product_idstringyesProduct ID

No output schema declared.

No examples provided.

get_product_set ~41

Get details of a specific product set.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
set_idstringyesProduct set ID

No output schema declared.

No examples provided.

get_reach_estimate ~86

Get estimated audience reach for a given targeting specification. Useful for planning campaigns before creating them.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
targeting_specstringyesJSON string of targeting spec (same format as ad set targeting)

No output schema declared.

No examples provided.

get_rf_prediction ~44

Get details of a specific reach & frequency prediction by ID.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
prediction_idstringyesPrediction ID

No output schema declared.

No examples provided.

get_rule ~39

Get details of a specific automated rule.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
rule_idstringyesRule ID

No output schema declared.

No examples provided.

get_saved_audience ~44

Get details of a specific saved audience by ID.

NameTypeReqDescription
audience_idstringyesSaved audience ID
fieldsstring–Comma-separated fields to return

No output schema declared.

No examples provided.

get_targeting_suggestions ~85

Get targeting suggestions based on existing targeting criteria. Meta suggests related interests, behaviors, and demographics.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
targeting_liststringyesJSON string of current targeting criteria to get suggestions for

No output schema declared.

No examples provided.

get_video ~41

Get details of a specific ad video by ID.

NameTypeReqDescription
fieldsstring–Comma-separated fields to return
video_idstringyesVideo ID

No output schema declared.

No examples provided.

list_account_users ~100

List users who have access to the ad account with their roles and permissions.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_ad_accounts ~63

List all ad accounts accessible by the current user. Returns paginated results.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_ads ~150

List ads in the ad account. Optionally filter by campaign, ad set, or status.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
adset_idstring–Filter by ad set ID
afterstring–Pagination cursor for next page
campaign_idstring–Filter by campaign ID
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)
statusstring–Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

No output schema declared.

No examples provided.

list_adsets ~134

List ad sets in the ad account. Optionally filter by campaign or status.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
campaign_idstring–Filter by campaign ID
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)
statusstring–Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

No output schema declared.

No examples provided.

list_block_lists ~99

List publisher block lists for the ad account. Returns paginated results.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_budget_schedules ~95

List budget schedules attached to a campaign or ad set. Returns paginated results.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitinteger–Number of results (default 25)
parent_idstringyesCampaign or ad set ID that owns the budget schedules
parent_typestring–Type of parent object

No output schema declared.

No examples provided.

list_business_ad_accounts ~66

List ad accounts owned by the configured business. Requires META_BUSINESS_ID env var.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_business_instagram_accounts ~67

List Instagram accounts owned by the configured business. Requires META_BUSINESS_ID env var.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_business_pages ~65

List Facebook Pages owned by the configured business. Requires META_BUSINESS_ID env var.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_business_users ~63

List users of the configured business. Requires META_BUSINESS_ID env var.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_businesses ~62

List all businesses accessible by the current user. Returns paginated results.

NameTypeReqDescription
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_campaigns ~180

List campaigns in the ad account. Supports filtering by status and objective. Returns paginated results.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
beforestring–Pagination cursor for previous page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)
objectivestring–Filter by objective: OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC, OUTCOME_APP_PROMOTION
statusstring–Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

No output schema declared.

No examples provided.

list_canvases ~98

List Instant Experience (Canvas) creatives in the ad account.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_catalogs ~91

List product catalogs for the ad account.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results to return

No output schema declared.

No examples provided.

list_creatives ~93

List ad creatives in the ad account.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_custom_audiences ~95

List custom audiences in the ad account.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

list_experiments ~98

List A/B test experiments (ad studies) for the ad account.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results to return

No output schema declared.

No examples provided.

list_feeds ~64

List product feeds for a catalog.

NameTypeReqDescription
afterstring–Pagination cursor for next page
catalog_idstringyesProduct catalog ID
fieldsstring–Comma-separated fields to return
limitnumber–Number of results to return

No output schema declared.

No examples provided.

list_images ~93

List ad images uploaded to the ad account.

NameTypeReqDescription
account_idstring–Ad account ID to query (e.g. 'act_123' or '123'). Falls back to META_AD_ACCOUNT_ID env var if omitted.
afterstring–Pagination cursor for next page
fieldsstring–Comma-separated fields to return
limitnumber–Number of results (default 25)

No output schema declared.

No examples provided.

Install

How do I install the io.github.mikusnuz/meta-ads MCP server?

io.github.mikusnuz/meta-ads runs locally as an npm package, launched with npx -y @mikusnuz/meta-ads-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · @mikusnuz/meta-ads-mcp

# add to Claude Code
claude mcp add mikusnuz-meta-ads -- npx -y @mikusnuz/meta-ads-mcp
Common questions

What is the io.github.mikusnuz/meta-ads MCP server?

io.github.mikusnuz/meta-ads is an MCP server listed in the public MCP registry as io.github.mikusnuz/meta-ads. MCP server for Meta Marketing API, Facebook & Instagram ad campaign management. This page covers its npm package (@mikusnuz/meta-ads-mcp).

Is the io.github.mikusnuz/meta-ads MCP server safe to use?

io.github.mikusnuz/meta-ads scores 78 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.mikusnuz/meta-ads MCP server expose?

io.github.mikusnuz/meta-ads exposes 134 tools: list_campaigns, get_campaign, create_campaign, update_campaign, delete_campaign, and 129 more. Their descriptions and schemas cost roughly 13,506 tokens of context every time the server is loaded.

Is the io.github.mikusnuz/meta-ads MCP server still maintained?

io.github.mikusnuz/meta-ads is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the io.github.mikusnuz/meta-ads MCP server under?

io.github.mikusnuz/meta-ads declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.