Skip to main content
Glama
Green-pep

meta-ads-mcp-patched

by Green-pep

meta-ads-mcp-patched

Patched fork of @mikusnuz/meta-ads-mcp v1.3.0 (MIT, upstream author mikusnuz — original docs in README.upstream.md). The fork exists because the upstream tool schemas lag behind what the Meta Marketing API v25 actually requires; every gap below was reproduced with a live API call before patching.

Patches over upstream 1.3.0

Tool

Change

create_campaign

+ bid_strategy (enum), bid_amount, is_adset_budget_sharing_enabled (bool, false preserved — required by Meta for ABO campaigns)

update_campaign

+ bid_strategy, bid_amount (lets an agent move a campaign off a bid cap)

create_adset

+ promoted_object (JSON string — required for LEAD_GENERATION / OFFSITE_CONVERSIONS), bid_amount

upload_image

+ file_path (local file → base64 bytes upload; url now optional, exactly one required), + name

upload_video

+ file_path (local file → multipart source upload; file_url now optional, exactly one required)

list_lead_forms, create_lead_form

Page-scoped calls now resolve the Page Access Token internally (derived from the configured token via /{page_id}?fields=access_token, cached per page, never surfaced in output) instead of failing with #190

get_lead_form, get_form_leads

+ optional page_id to ride the Page token when Meta rejects the account token

create_adset, update_adset (v1.3.2)

+ dsa_beneficiary, dsa_payor — mandatory for any EU-delivering ad set since the DSA (#100 subcode 3858081 without them)

create_lead_form (v1.3.2)

+ context_card (form headline/intro), privacy_policy_link_text, block_display_for_non_targeted_viewer (false preserved); follow_up_action_url now also merges into thank_you_page.website_url when absent (Meta requires it for VIEW_WEBSITE and ignores the top-level param)

AdsClient

request() accepts a per-call token override; new getPageToken / getAsPage / postAsPage / postForm (multipart) helpers

Everything else is upstream dist/ output, byte-identical. Patches are applied directly to the unminified ESM in dist/ (upstream ships no source in the npm tarball).

Related MCP server: meta-ads-mcp

Usage

Same contract as upstream — stdio MCP server, env-configured:

META_ADS_ACCESS_TOKEN  (required)
META_AD_ACCOUNT_ID     (required, numeric — no act_ prefix)
META_APP_ID / META_APP_SECRET / META_BUSINESS_ID / META_PIXEL_ID (optional)

Run: npx -y github:Green-pep/meta-ads-mcp-patched#v1.3.1

Release procedure

  1. Apply the change in dist/, bump version in package.json (keep the 1.3.x base to track the upstream pin).

  2. Update the patch table above.

  3. Commit, tag v1.3.x, push with tags.

  4. Repoint the consumer (MCP catalog args) at the new tag.

Upstream status

Fork base pinned at upstream 1.3.0. The intent is to offer these patches upstream (mikusnuz/meta-ads-mcp) and retire this fork if they land.

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    An MCP server for programmatic management of Meta (Facebook/Instagram) advertising campaigns through AI assistants. It enables campaign creation, ad set management, creative upload, analytics, audience management, and conversion tracking.
    212
    4
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server to manage Meta Ads (Facebook/Instagram) campaigns, ad sets, insights, and audiences from Claude Code using natural language.
    9
    10
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    MCP server for Meta/Facebook Marketing API allowing you to view and manage ad accounts, campaigns, ad sets, ads, and creatives, as well as fetch insights and upload ad images.
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    MCP server for Meta Ads providing 30 tools for account discovery, campaign management, targeting research, and insights. Designed with LLM-friendly outputs and productivity features like cloning and bulk operations.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • MCP server for Appcircle mobile CI/CD platform.

  • Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.

  • Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Green-pep/meta-ads-mcp-patched'

If you have feedback or need assistance with the MCP directory API, please join our Discord server