meta-ads-mcp-patched

meta-ads-mcp-patched

An MCP server for managing Meta Ads campaigns, ad sets, lead forms, and media uploads, patched to support Meta Marketing API v25 requirements.

Category
Visit Server

README

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).

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.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured