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

remove_from_block_list ~52

Remove publisher URLs from an existing block list.

Input Output Examples

Name	Type	Req	Description
list_id	string	yes	Block list ID
urls	string	yes	JSON array of URLs to remove (e.g. '["example.com"]')

No output schema declared.

No examples provided.

remove_users_from_audience ~83

Remove users from a custom audience. Payload format is the same as add_users_to_audience.

Input Output Examples

Name	Type	Req	Description
audience_id	string	yes	Audience ID
payload	string	yes	JSON string: {schema: ['EMAIL','PHONE',...], data: [['hash1','hash2',...], ...]}. All PII must be SHA-256 hashed.

No output schema declared.

No examples provided.

search_ad_library ~160

Search the Meta Ad Library for ads. Allows searching by keywords, countries, and ad type. Useful for competitive research and transparency.

Input Output Examples

Name	Type	Req	Description
ad_reached_countries	string	yes	Comma-separated country codes where ads were shown (e.g. 'US,GB,KR')
ad_type	string	—	Ad type filter: ALL, POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, etc.
after	string	—	Pagination cursor for next page
fields	string	—	Comma-separated fields to return
limit	number	—	Number of results (default 25)
order_by	string	—	Sort order for results
search_terms	string	yes	Keywords to search for in ads

No output schema declared.

No examples provided.

search_locations ~91

Search for geographic locations (countries, regions, cities, zip codes) for ad targeting.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Number of results (default 25)
location_types	string	—	Comma-separated location types: country, region, city, zip, geo_market, electoral_district
q	string	yes	Search query (e.g. 'New York', 'California', 'United States')

No output schema declared.

No examples provided.

search_targeting ~116

Search for targeting options (interests, behaviors, demographics, etc.) by keyword. Use this to find valid targeting IDs for ad set targeting specs.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Number of results (default 25)
q	string	yes	Search query (e.g. 'fitness', 'technology', 'cooking')
type	string	—	Targeting type filter: adinterest, adgeolocation, adeducationschool, adeducationmajor, adworkemployer, adworkposition, adlocale, etc.

No output schema declared.

No examples provided.

search_targeting_map ~49

Map targeting IDs to their full details (names, types, paths). Useful for resolving IDs obtained from other endpoints.

Input Output Examples

Name	Type	Req	Description
targeting_list	string	yes	JSON array of targeting IDs to look up

No output schema declared.

No examples provided.

send_conversion_event ~50

Send a server-side conversion event via the Conversions API (pixel).

Input Output Examples

Name	Type	Req	Description
events	string	yes	JSON array of events: [{event_name, event_time, user_data, custom_data, action_source}]

No output schema declared.

No examples provided.

send_offline_event ~46

Send an offline conversion event to an offline event set.

Input Output Examples

Name	Type	Req	Description
event_set_id	string	yes	Offline event set ID
events	string	yes	JSON array of offline events

No output schema declared.

No examples provided.

update_ad ~89

Update an existing ad. Only provided fields will be modified.

Input Output Examples

Name	Type	Req	Description
ad_id	string	yes	Ad ID to update
creative	string	—	New creative spec as JSON string
name	string	—	New ad name
status	string	—	New status: ACTIVE, PAUSED, DELETED, ARCHIVED
tracking_specs	string	—	New tracking specs as JSON string

No output schema declared.

No examples provided.

update_ad_account ~80

Update the configured ad account settings. Only provided fields will be modified.

Input Output Examples

Name	Type	Req	Description
name	string	—	New account name
spend_cap	string	—	Account spend cap in currency cents (e.g. '100000' = $1000.00)
timezone_name	string	—	New timezone (e.g. 'America/New_York')

No output schema declared.

No examples provided.

update_adset ~154

Update an existing ad set. Only provided fields will be modified.

Input Output Examples

Name	Type	Req	Description
adset_id	string	yes	Ad set ID to update
bid_amount	string	—	New bid amount in currency cents
daily_budget	string	—	New daily budget in currency cents
end_time	string	—	New end time (ISO 8601)
lifetime_budget	string	—	New lifetime budget in currency cents
name	string	—	New ad set name
start_time	string	—	New start time (ISO 8601)
status	string	—	New status: ACTIVE, PAUSED, DELETED, ARCHIVED
targeting	string	—	New targeting spec as JSON string

No output schema declared.

No examples provided.

update_audience ~54

Update an existing custom audience. Only provided fields will be modified.

Input Output Examples

Name	Type	Req	Description
audience_id	string	yes	Audience ID to update
description	string	—	New audience description
name	string	—	New audience name

No output schema declared.

No examples provided.

update_budget_schedule ~74

Update an existing budget schedule. Only provided fields will be modified.

Input Output Examples

Name	Type	Req	Description
budget_value	string	—	New budget amount in account currency cents
schedule_id	string	yes	Budget schedule ID to update
time_end	string	—	New schedule end time
time_start	string	—	New schedule start time

No output schema declared.

No examples provided.

update_campaign ~122

Update an existing campaign. Only provided fields will be modified.

Input Output Examples

Name	Type	Req	Description
campaign_id	string	yes	Campaign ID to update
daily_budget	string	—	New daily budget in currency cents
lifetime_budget	string	—	New lifetime budget in currency cents
name	string	—	New campaign name
start_time	string	—	New start time (ISO 8601)
status	string	—	New status: ACTIVE, PAUSED, DELETED, ARCHIVED
stop_time	string	—	New stop time (ISO 8601)

No output schema declared.

No examples provided.

update_catalog ~35

Update an existing product catalog.

Input Output Examples

Name	Type	Req	Description
catalog_id	string	yes	Product catalog ID
name	string	—	New catalog name

No output schema declared.

No examples provided.

update_creative ~59

Update an existing ad creative. Only name and url_tags can be modified after creation.

Input Output Examples

Name	Type	Req	Description
creative_id	string	yes	Creative ID to update
name	string	—	New creative name
url_tags	string	—	New URL tags

No output schema declared.

No examples provided.

update_experiment ~51

Update an existing experiment (ad study).

Input Output Examples

Name	Type	Req	Description
description	string	—	New experiment description
experiment_id	string	yes	Experiment (ad study) ID
name	string	—	New experiment name

No output schema declared.

No examples provided.

update_product ~100

Update an existing product in a catalog.

Input Output Examples

Name	Type	Req	Description
availability	string	—	Product availability: in stock, out of stock, etc.
description	string	—	Product description
image_url	string	—	Product image URL
name	string	—	Product name
price	string	—	Product price (e.g. '9.99 USD')
product_id	string	yes	Product ID
url	string	—	Product URL

No output schema declared.

No examples provided.

update_product_set ~50

Update an existing product set.

Input Output Examples

Name	Type	Req	Description
filter	string	—	JSON string of updated filter rules
name	string	—	New product set name
set_id	string	yes	Product set ID

No output schema declared.

No examples provided.

update_rule ~91

Update an existing automated rule.

Input Output Examples

Name	Type	Req	Description
evaluation_spec	string	—	JSON string defining updated rule conditions
execution_spec	string	—	JSON string defining updated rule actions
name	string	—	New rule name
rule_id	string	yes	Rule ID
schedule_spec	string	—	JSON string defining updated rule schedule
status	string	—	Rule status: ENABLED, DISABLED

No output schema declared.

No examples provided.

upload_feed ~45

Upload/trigger a feed file upload for a product feed.

Input Output Examples

Name	Type	Req	Description
feed_id	string	yes	Product feed ID
url	string	yes	URL of the feed file to upload

No output schema declared.

No examples provided.

upload_image ~40

Upload an ad image from a public URL. Returns image hash for use in ad creatives.

Input Output Examples

Name	Type	Req	Description
url	string	yes	Public URL of the image to upload

No output schema declared.

No examples provided.

upload_video ~59

Upload an ad video from a public URL. Returns video ID for use in ad creatives.

Input Output Examples

Name	Type	Req	Description
description	string	—	Video description
file_url	string	yes	Public URL of the video to upload
title	string	—	Video title

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