Meta Ads

v1.0.0Marketing & SEOstable

A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.

meta-ads-mcpmcpai-integration
Share:
923
Stars
0
Downloads
0
Weekly
0/5

What is Meta Ads?

Meta Ads is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that allows ai models to access, analyze, and manage meta advertising campaigns, enabling llms to retrieve performance data, visualize ad creatives, and provide strategic...

A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.

This server falls under the Marketing & SEO and Analytics categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol server that allows AI models to acc

Use Cases

A Model Context Protocol server that allows AI models to access, analyze, and ma
pipeboard-co

Maintainer

LicenseNOASSERTION
Languagepython
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx meta-ads-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Meta Ads

Meta Ads MCP connects AI models to the Meta advertising platform, exposing 42 tools that cover the full campaign lifecycle — from creating campaigns, ad sets, and creatives to retrieving performance insights and managing budgets. It works via a hosted remote MCP endpoint (no local install required) or through the Pipeboard CLI, and authenticates using a Pipeboard API token linked to your Meta Ads account. Marketers and growth teams use it to let LLMs like Claude draft, analyze, and optimize Facebook and Instagram campaigns through natural language.

Prerequisites

  • A Meta Business Manager account with at least one ad account
  • A Pipeboard account and API token from pipeboard.co/api-tokens
  • An MCP-compatible client such as Claude Desktop, Claude.ai, or Cursor
  • For CLI use: Homebrew (macOS) or a supported package manager to install the Pipeboard CLI
1

Get a Pipeboard API token

Sign up or log in at pipeboard.co, then navigate to pipeboard.co/api-tokens and generate a new token. Copy it — you will use it in either the remote MCP setup or the CLI.

2

Connect via Remote MCP (recommended)

In Claude.ai, go to Settings → Integrations and add the remote MCP URL. No local installation is required. Cursor and other clients use a similar URL-based approach in their MCP config files.

https://meta-ads.mcp.pipeboard.co/
3

Alternatively, install the Pipeboard CLI

If you prefer a local CLI workflow, install Pipeboard via Homebrew and export your API token as an environment variable.

brew install pipeboard-co/tap/pipeboard
export PIPEBOARD_API_TOKEN=<your-token>
4

Authenticate with your Meta Ads account

On first connection, the server will prompt you to complete a Meta OAuth flow so it can access your ad accounts. After authentication, your account IDs become available to the AI.

5

Verify the connection in your MCP client

Ask the AI to list your ad accounts or campaigns. If the server is connected correctly it will return real data from your Meta Ads account.

Meta Ads Examples

Client configuration (Claude Desktop via remote MCP)

Add the remote MCP URL to your Claude Desktop settings. Some clients support a token header for direct authentication.

{
  "mcpServers": {
    "meta-ads": {
      "type": "http",
      "url": "https://meta-ads.mcp.pipeboard.co/",
      "headers": {
        "Authorization": "Bearer YOUR_PIPEBOARD_API_TOKEN"
      }
    }
  }
}

Prompts to try

Once connected, use natural language to manage your Meta campaigns:

- "Show me the performance of all active campaigns in my ad account act_123456 for the last 7 days"
- "Create a new awareness campaign with a $100 daily budget targeting users interested in fitness in California"
- "Which ad creatives had the lowest cost-per-click this month? Pause the bottom 3."
- "Increase the budget of my top-performing ad set by 20%"
- "Search for targeting interests related to home improvement and suggest the top 5 by audience size"

Troubleshooting Meta Ads

The AI reports 'no ad accounts found' after authentication

Ensure the Meta user account you authenticated with has at least Advertiser-level access to the ad account in Meta Business Manager. Check under Business Settings → Ad Accounts → People.

API token error or 401 Unauthorized from the MCP endpoint

Regenerate your Pipeboard API token at pipeboard.co/api-tokens and update it in your client config. Tokens can expire or be revoked if you change your Pipeboard password.

Campaign creation fails with a permissions error

Meta requires specific permissions for ad creation (ads_management, ads_read). Re-run the OAuth flow and ensure you accept all requested permission scopes on the Meta permissions screen.

Frequently Asked Questions about Meta Ads

What is Meta Ads?

Meta Ads is a Model Context Protocol (MCP) server that model context protocol server that allows ai models to access, analyze, and manage meta advertising campaigns, enabling llms to retrieve performance data, visualize ad creatives, and provide strategic insights for facebook and instagram platforms. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Meta Ads?

Follow the installation instructions on the Meta Ads GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Meta Ads?

Meta Ads works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Meta Ads free to use?

Yes, Meta Ads is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.

Browse More Marketing & SEO MCP Servers

Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "meta-ads-mcp": { "command": "npx", "args": ["-y", "meta-ads-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Meta Ads?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides