io.github.mikusnuz/meta-ads

@mikusnuz/meta-ads-mcp

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

94 397/wk 2 tools GitHub npm

No known CVEs

MIT license

Actively maintained

Last commit 23d ago

Works with most clients

Transport: stdio, sse

2 tools · ~77 tok

Grade A · 0.0% of 200K ctx

MCPpedia last refreshed this data 2d ago

Edit this pageView history

io.github.mikusnuz/meta-ads is an MCP server that MCP server for Meta Marketing API — Facebook & Instagram ad campaign management. Its tool list has not been published yet over stdio and sse, requires no API key, and scores 88/100 on MCPpedia's security, maintenance and efficiency rubric.

Marketing

Step 1

Install in your client

Config is the same across clients - only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "meta-ads": {
      "env": {
        "META_APP_ID": "your-app-id",
        "META_PIXEL_ID": "your-pixel-id",
        "META_APP_SECRET": "your-app-secret",
        "META_BUSINESS_ID": "your-business-id",
        "META_AD_ACCOUNT_ID": "123456789",
        "META_ADS_ACCESS_TOKEN": "your-access-token"
      },
      "args": [
        "-y",
        "@mikusnuz/meta-ads-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-mikusnuz-meta-ads)](https://mcppedia.org/s/io-github-mikusnuz-meta-ads)

Read me

What io.github.mikusnuz/meta-ads does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.

npx -y '@mikusnuz/meta-ads-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories - click any category to see the underlying evidence.

Score breakdown

88/100across 5 weighted dimensions

How we score →

0255075100

−12

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @mikusnuz/meta-ads-mcp against OSV.dev.

Inventory

Tools (2)

Click any tool to inspect its schema.

~77 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience - it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.mikusnuz/meta-ads safe to use?: io.github.mikusnuz/meta-ads has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under MIT.
How do I install io.github.mikusnuz/meta-ads?: io.github.mikusnuz/meta-ads supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.mikusnuz/meta-ads do?: io.github.mikusnuz/meta-ads provides 2 tools: create_lookalike_audience, Installation. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.mikusnuz/meta-ads?: io.github.mikusnuz/meta-ads is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is io.github.mikusnuz/meta-ads actively maintained?: io.github.mikusnuz/meta-ads is actively maintained - last commit was 23 days ago. It has 94 GitHub stars.

Similar servers

Others in marketing

View all →

Seo94

Free Google Search Console MCP: your real GSC, Google Analytics and keyword data for AI agents.

622 2

Mcp Server Typescript93

DataForSEO API modelcontextprotocol server

261 9

Mailcheap92

Newsletters where you pay for the emails you send, not for dormant subscribers, at a fraction of the price of beehiiv and the like. Open source: self-host it, or use mailcheap.ai.

1.7k 8

io.github.nirholas/xactions92

X/Twitter automation MCP: scrape, post, schedule, analyze, engage. No API key required.

655 6

MCP Security Weekly

Get CVE alerts and security updates for io.github.mikusnuz/meta-ads and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "meta-ads": { "env": { "META_APP_ID": "your-app-id", "META_PIXEL_ID": "your-pixel-id", "META_APP_SECRET": "your-app-secret", "META_BUSINESS_ID": "your-business-id", "META_AD_ACCOUNT_ID": "123456789", "META_ADS_ACCESS_TOKEN": "your-access-token" }, "args": [ "-y", "@mikusnuz/meta-ads-mcp" ], "command": "npx" } } }

When to Use

Use this MCP when you need to:

"Create a new Facebook ad campaign" — use create_campaign, create_adset, create_ad, and create_creative to build a full funnel

"Check how my ads are performing today" — use get_account_insights or get_campaign_insights with today's date range

"Pause all campaigns with ROAS below 2" — use list_campaigns + get_campaign_insights to find underperformers, then update_campaign to pause

"Set up A/B test between two ad creatives" — use create_experiment to run a controlled test between ad sets

"Create a lookalike audience from my customers" — use create_custom_audience, add_users_to_audience, then create_lookalike_audience

"Upload ad images and create a carousel ad" — use upload_image for each image, then create_creative with carousel format

"Get a detailed performance report for last 30 days" — use create_async_report for large date ranges, then get_async_report to retrieve

"Search the Facebook Ad Library for competitor ads" — use search_ad_library to find public ad data

"Set up automated rules to pause underperforming ads" — use create_rule with conditions like CPA > threshold

"Manage my product catalog for dynamic ads" — use create_catalog, create_feed, and upload_feed to set up dynamic product ads

What's New in v1.6.0

create_adset accepts bid_amount; creation and updates accept dsa_beneficiary and dsa_payor. For EU-targeted ads, supply each required value or configure the corresponding account default. The payer does not automatically copy the beneficiary.

Ad and ad-set lists use campaign/ad-set edges when scoped. Combined campaign/ad-set filters and explicit account IDs are checked for consistency.

create_adset and update_adset accept destination_type, attribution_spec, adset_schedule, pacing_type, and validate_only. Existing calls still perform their requested writes; set validate_only: true to ask Meta to validate without mutation. A successful validation does not create an ad set.

Hourly schedules accept minute ranges and days (Sunday = 0); specify timezone_type as USER or ADVERTISER. Scheduling adds day_parting pacing. Meta validates effective lifetime budgeting, objective eligibility, and attribution restrictions. No budget or status is changed automatically.

create_custom_audience accepts a JSON rule, pixel_id, and retention_days for rule-based audiences. Audience creation is a real write, not a dry run.

What's New in v1.5.0

Conversion tools validate the existing events JSON input and send it as the required data array. Use test_event_code to verify receipt in Events Manager; offline events use a dataset ID and action_source=physical_store for store events.

Creative creation accepts top-level destination_spec, wamo_whatsapp_identity_spec, and degrees_of_freedom_spec JSON objects. Dynamic creatives also accept object_story_spec for Page identity. To opt out of the v26 Shops destination default, set destination_spec to {"destination_type":"WEBSITE_AND_SHOP_OPT_OUT"}.

Includes complete async-report result retrieval, token extension, and budget schedule fixes since v1.4.1. Some detailed Insights breakdowns require an Ads Manager

Frequently Asked Questions

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

io.github.mikusnuz/meta-ads has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under MIT.

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

io.github.mikusnuz/meta-ads supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.mikusnuz/meta-ads do?

io.github.mikusnuz/meta-ads provides 2 tools: create_lookalike_audience, Installation. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.mikusnuz/meta-ads?

io.github.mikusnuz/meta-ads is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.

Is io.github.mikusnuz/meta-ads actively maintained?

io.github.mikusnuz/meta-ads is actively maintained - last commit was 23 days ago. It has 94 GitHub stars.