MCP server for Meta Ads API -- manage campaigns, ad sets, ads, and Business Manager accounts
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"meta-ads-mcp-python","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Meta Ads MCP A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for analysing Meta Ads campaigns through an AI interface. Retrieve performance data, visualize ad creatives, and surface insights for Facebook, Instagram, and other Meta platforms. > **Read-only:** All tools are strictly read-only. No tool creates, modifies, or deletes any data. > **Independent project:** This is an open-source project using Meta's public APIs. Not affiliated with or endorsed by Meta. For an officially approved Meta app, see [Pipeboard](https://pipeboard.co). --- ## Quick Start (Remote MCP) The fastest way to get started is the [Pipeboard remote MCP](https://pipeboard.co) — no local setup required. Remote MCP URL: `https://mcp.pipeboard.co/meta-ads-mcp` With token auth: `https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN` Get your token at [pipeboard.co/api-tokens](https://pipeboard.co/api-tokens). ### Claude (Pro/Max) 1. Go to [claude.ai/settings/integrations](https://claude.ai/settings/integrations) 2. Click **Add Integration**, set the URL to `https://mcp.pipeboard.co/meta-ads-mcp` 3. Click **Connect** and follow the prompts. ### Cursor Add to `~/.cursor/mcp.json`: ```json { "mcpServers": { "meta-ads-remote": { "url": "https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN" } } } ``` ### Other MCP Clients Use the remote URL above. Full setup guides: [pipeboard.co](https://pipeboard.co) --- ## Local Installation > For advanced users. The remote MCP is recommended for most cases. **Requirements:** Python 3.12+, a Meta Developer App (App ID + Secret), and [uv](https://github.com/astral-sh/uv). ```bash pip install meta-ads-mcp ``` ### Authentication Copy `.env.example` to `.env` and set one of: ``` PIPEBOARD_API_TOKEN=your_token # Recommended — no Meta app required META_APP_ID=your_app_id # Direct Meta app credentials META_APP_SECRET=your_app_secret ``` ### Run ```bash meta-ad…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.