io.github.mikusnuz/meta-ads

NPM · @MIKUSNUZ/META-ADS-MCP · SCANNED AUG 3

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

Available components

+14 this week 67 67 Trust /100

Trust breakdown (6 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 →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 112 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

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 (excellent).Pass
Tool/resource definitions use about 8658 tokens (~68/item across 126 items; 123 tools + 3 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

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

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @mikusnuz/meta-ads-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add mikusnuz-meta-ads -- npx -y @mikusnuz/meta-ads-mcp

# add to Codex CLI

codex mcp add mikusnuz-meta-ads -- npx -y @mikusnuz/meta-ads-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mikusnuz-meta-ads": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add mikusnuz-meta-ads --command npx --arg -y --arg @mikusnuz/meta-ads-mcp

# ~/.hermes/config.yaml

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

// mcp.json

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

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.

2 Aug 26 +41
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Security disclosure: fail → unverified ▼ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
31 Jul 26 −27
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 53

First indexed and scored.

Show 2 earlier entries Hide earlier entries

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 3 Aug 2026 · Analysed npm/@mikusnuz/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 123 exposed · ~8,605 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.

Tool Tokens

get_campaign_adsets ~69

Get all ad sets belonging to a specific campaign.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
campaign_id	string	yes	Campaign ID
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

get_campaign_insights ~187

Get performance insights for a specific campaign.

Input Output Examples

Name	Type	Req	Description
breakdowns	string	—	Breakdown dimensions: age,gender,country,region,placement,device_platform
campaign_id	string	yes	Campaign ID
date_preset	string	—	Date preset: TODAY,YESTERDAY,LAST_7D,LAST_14D,LAST_30D,THIS_MONTH,LAST_MONTH,THIS_QUARTER,LAST_QUARTER,THIS_YEAR,LAST_YEAR
fields	string	—	Comma-separated insight fields
filtering	string	—	JSON string for filtering
level	string	—	Aggregation level: campaign, adset, ad
time_increment	string	—	Time granularity: all_days, 1, 7, monthly
time_range	string	—	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.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
campaign_id	string	yes	Campaign ID
fields	string	—	Comma-separated fields to return
limit	number	—	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.

Input Output Examples

Name	Type	Req	Description
canvas_id	string	yes	Canvas ID
fields	string	—	Comma-separated fields to return

No output schema declared.

No examples provided.

get_catalog ~40

Get details of a specific product catalog.

Input Output Examples

Name	Type	Req	Description
catalog_id	string	yes	Product catalog ID
fields	string	—	Comma-separated fields to return

No output schema declared.

No examples provided.

get_creative ~42

Get details of a specific ad creative by ID.

Input Output Examples

Name	Type	Req	Description
creative_id	string	yes	Creative ID
fields	string	—	Comma-separated fields to return

No output schema declared.

No examples provided.

get_delivery_estimate ~46

Get delivery estimate for an ad including estimated daily reach and cost.

Input Output Examples

Name	Type	Req	Description
ad_id	string	yes	Ad ID
optimization_goal	string	—	Optimization goal to estimate for

No output schema declared.

No examples provided.

get_experiment ~46

Get details of a specific experiment (ad study).

Input Output Examples

Name	Type	Req	Description
experiment_id	string	yes	Experiment (ad study) ID
fields	string	—	Comma-separated fields to return

No output schema declared.

No examples provided.

get_experiment_results ~48

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

Input Output Examples

Name	Type	Req	Description
experiment_id	string	yes	Experiment (ad study) ID
fields	string	—	Comma-separated fields to return

No output schema declared.

No examples provided.

get_feed_uploads ~66

Get upload history for a product feed.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
feed_id	string	yes	Product feed ID
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

get_form_leads ~67

Get leads submitted through a lead generation form.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
form_id	string	yes	Lead form ID
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

get_image ~41

Get details of a specific ad image by ID.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
image_id	string	yes	Image ID

No output schema declared.

No examples provided.

get_lead ~41

Get details of a specific lead by ID.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
lead_id	string	yes	Lead ID

No output schema declared.

No examples provided.

get_lead_form ~43

Get details of a specific lead generation form.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
form_id	string	yes	Lead form ID

No output schema declared.

No examples provided.

get_product ~38

Get details of a specific product.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
product_id	string	yes	Product ID

No output schema declared.

No examples provided.

get_product_set ~41

Get details of a specific product set.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
set_id	string	yes	Product set ID

No output schema declared.

No examples provided.

get_reach_estimate ~49

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

Input Output Examples

Name	Type	Req	Description
targeting_spec	string	yes	JSON 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.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
prediction_id	string	yes	Prediction ID

No output schema declared.

No examples provided.

get_rule ~39

Get details of a specific automated rule.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
rule_id	string	yes	Rule ID

No output schema declared.

No examples provided.

get_saved_audience ~44

Get details of a specific saved audience by ID.

Input Output Examples

Name	Type	Req	Description
audience_id	string	yes	Saved audience ID
fields	string	—	Comma-separated fields to return

No output schema declared.

No examples provided.

get_targeting_suggestions ~48

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

Input Output Examples

Name	Type	Req	Description
targeting_list	string	yes	JSON 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.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return
video_id	string	yes	Video ID

No output schema declared.

No examples provided.

list_account_users ~63

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

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	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.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_ads ~113

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

Input Output Examples

Name	Type	Req	Description
adset_id	string	—	Filter by ad set ID
after	string	—	Pagination cursor for next page
campaign_id	string	—	Filter by campaign ID
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)
status	string	—	Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

No output schema declared.

No examples provided.

list_adsets ~97

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

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
campaign_id	string	—	Filter by campaign ID
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)
status	string	—	Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

No output schema declared.

No examples provided.

list_block_lists ~62

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

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_budget_schedules ~63

List ad budget schedules for the ad account. Returns paginated results.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

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.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	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.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	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.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_campaigns ~143

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

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
before	string	—	Pagination cursor for previous page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)
objective	string	—	Filter by objective: OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC, OUTCOME_APP_PROMOTION
status	string	—	Filter by status: ACTIVE, PAUSED, DELETED, ARCHIVED

No output schema declared.

No examples provided.

list_canvases ~61

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

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_catalogs ~54

List product catalogs for the ad account.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

list_creatives ~56

List ad creatives in the ad account.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_custom_audiences ~58

List custom audiences in the ad account.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_experiments ~61

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

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

list_feeds ~64

List product feeds for a catalog.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
catalog_id	string	yes	Product catalog ID
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

list_images ~56

List ad images uploaded to the ad account.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_lead_forms ~67

List lead generation forms for a Facebook Page.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return
page_id	string	yes	Facebook Page ID

No output schema declared.

No examples provided.

list_offline_event_sets ~58

List offline conversion data sets for the ad account.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

list_product_sets ~64

List product sets within a catalog.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
catalog_id	string	yes	Product catalog ID
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

list_products ~74

List products within a catalog.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
catalog_id	string	yes	Product catalog ID
fields	string	—	Comma-separated fields to return
filter	string	—	JSON string of filter rules
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

list_rf_predictions ~63

List reach & frequency predictions for the ad account. Returns paginated results.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_rules ~53

List automated rules for the ad account.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results to return

No output schema declared.

No examples provided.

list_saved_audiences ~65

List saved audiences in the ad account. Saved audiences are reusable targeting presets.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_system_users ~64

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

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

list_videos ~57

List ad videos uploaded to the ad account.

Input Output Examples

Name	Type	Req	Description
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)

No output schema declared.

No examples provided.

refresh_token ~42

Refresh a long-lived access token to extend its expiration. Returns a new long-lived token.

Input Output Examples

Name	Type	Req	Description
long_lived_token	string	yes	Long-lived access token to refresh

No output schema declared.

No examples provided.

remove_business_user ~40

Remove a user from the configured business. Requires META_BUSINESS_ID env var.

Input Output Examples

Name	Type	Req	Description
user_id	string	yes	User ID to remove from the business

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug