meta-ads-mcp

# Meta Ads MCP A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for interacting with Meta Ads. Analyze, manage and optimize Meta advertising campaigns through an AI interface. Use an LLM to retrieve performance data, visualize ad creatives, and provide strategic insights for your ads on Facebook, Instagram, and other Meta platforms. > **DISCLAIMER:** This is an unofficial third-party tool and is not associated with, endorsed by, or affiliated with Meta in any way. This project is maintained independently and uses Meta's public APIs according to their terms of service. Meta, Facebook, Instagram, and other Meta brand names are trademarks of their respective owners. [](https://github.com/user-attachments/assets/3e605cee-d289-414b-814c-6299e7f3383e) [](https://lobehub.com/mcp/nictuku-meta-ads-mcp) mcp-name: co.pipeboard/meta-ads-mcp ## Community & Support - [Discord](https://discord.gg/YzMwQ8zrjr). Join the community. - [Email Support](mailto:info@pipeboard.co). Email us for support. ## Table of Contents - [🚀 Getting started with Remote MCP (Recommended for Marketers)](#getting-started-with-remote-mcp-recommended) - [Local Installation (Technical Users Only)](#local-installation-technical-users-only) - [Features](#features) - [Configuration](#configuration) - [Available MCP Tools](#available-mcp-tools) - [Licensing](#licensing) - [Privacy and Security](#privacy-and-security) - [Testing](#testing) - [Troubleshooting](#troubleshooting) ## Getting started with Remote MCP (Recommended) The fastest and most reliable way to get started is to **[🚀 Get started with our Meta Ads Remote MCP](https://pipeboard.co)**. Our cloud service uses streamable HTTP transport for reliable, scalable access to Meta Ads data. No technical setup required - just connect and start analyzing your ad campaigns with AI! ### For Claude Pro/Max Users 1. Go to [claude.ai/settings/integrations](https://claude.ai/settings/integrations) (requires Claude Pro or Max) 2. Click "Add Integration" and enter: - **Name**: "Pipeboard Meta Ads" (or any name you prefer) - **Integration URL**: `https://mcp.pipeboard.co/meta-ads-mcp` 3. Click "Connect" next to the integration and follow the prompts to: - Login to Pipeboard - Connect your Facebook Ads account That's it! You can now ask Claude to analyze your Meta ad campaigns, get performance insights, and manage your advertising. #### Advanced: Direct Token Authentication (Claude) For direct token-based authentication without the interactive flow, use this URL format when adding the integration: ``` https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN ``` Get your token at [pipeboard.co/api-tokens](https://pipeboard.co/api-tokens). ### For Cursor Users Add the following to your `~/.cursor/mcp.json`. Once you enable the remote MCP, click on "Needs login" to finish the login process. ```json { "mcpServers": { "meta-ads-remote": { "url": "https://mcp.pipeboard.co/meta-ads-mcp" } } } ``` #### Advanced: Direct Token Authentication (Cursor) If you prefer to authenticate without the interactive login flow, you can include your Pipeboard API token directly in the URL: ```json { "mcpServers": { "meta-ads-remote": { "url": "https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN" } } } ``` Get your token at [pipeboard.co/api-tokens](https://pipeboard.co/api-tokens). ### For Other MCP Clients Use the Remote MCP URL: `https://mcp.pipeboard.co/meta-ads-mcp` **[📖 Get detailed setup instructions for your AI client here](https://pipeboard.co)** #### Advanced: Direct Token Authentication (Other Clients) For MCP clients that support token-based authentication, you can append your Pipeboard API token to the URL: ``` https://mcp.pipeboard.co/meta-ads-mcp?token=YOUR_PIPEBOARD_TOKEN ``` This bypasses the interactive login flow and authenticates immediately. Get your token at [pipeboard.co/api-tokens](https://pipeboard.co/api-tokens). ## Local Installation (Advanced Technical Users Only) 🚀 **We strongly recommend using [Remote MCP](https://pipeboard.co) instead** - it's faster, more reliable, and requires no technical setup. Meta Ads MCP also supports a local streamable HTTP transport, allowing you to run it as a standalone HTTP API for web applications and custom integrations. See **[Streamable HTTP Setup Guide](STREAMABLE_HTTP_SETUP.md)** for complete instructions. ## Features - **AI-Powered Campaign Analysis**: Let your favorite LLM analyze your campaigns and provide actionable insights on performance - **Strategic Recommendations**: Receive data-backed suggestions for optimizing ad spend, targeting, and creative content - **Automated Monitoring**: Ask any MCP-compatible LLM to track performance metrics and alert you about sign