meta-mcp

Overview

The meta-mcp server provides full campaign lifecycle management, analytics, audience targeting, and creative optimization capabilities for Meta advertising platforms. It implements the MCP protocol to expose 25 comprehensive tools for managing campaigns, ad sets, audiences, and creatives. The server includes robust features like OAuth 2.0 authentication, automatic rate limiting, pagination support, and comprehensive error handling. It supports both token-based and advanced OAuth authentication methods, with special considerations for appsecret_proof requirements.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_insights

  Get detailed performance metrics for campaigns or ads

  Try:Get performance insights for my last 30 days of campaignsTry:Show impressions, clicks, and ROAS for campaign ID 123456
• create_campaign

  Create new advertising campaigns with full configuration

  Try:Create a new traffic campaign named 'Holiday Sale 2024' with $50 daily budgetTry:Set up a campaign for conversions targeting women 25-35 interested in fashion
• update_campaign

  Modify existing campaigns (name, budget, status, etc.)

  Try:Update my campaign budget to $100 dailyTry:Change campaign name to 'Black Friday Special'
• list_ad_sets

  List and filter ad sets within campaigns

  Try:Show all ad sets for my campaignsTry:List active ad sets in campaign ID 123456
• create_ad_set

  Create ad sets with detailed targeting, budgets, and optimization goals

  Try:Create an ad set targeting US users aged 25-45 interested in entrepreneurshipTry:Set up ad targeting women 30-50 in major US cities with business interests
• create_custom_audience

  Create custom audiences from various sources

  Try:Create a custom audience named 'Website Visitors' from my site trafficTry:Build an audience of people who engaged with my Instagram posts
• create_lookalike_audience

  Generate lookalike audiences from source audiences

  Try:Create a 5% lookalike audience based on my 'High Value Customers' audienceTry:Generate a lookalike audience targeting the US market from my email subscribers
• get_token_info

  Token validation and information retrieval

  Try:Check my access token status and permissionsTry:Validate if my token has ads_management access
• diagnose_campaign_readiness

  Check campaign status and identify ad set creation issues

  Try:Diagnose my campaign to see if it's ready for ad set creationTry:Check why my ad set creation failed
• list_ad_creatives

  List all ad creatives for an account

  Try:Show all my ad creatives and their performanceTry:List creatives from campaign ID 123456
• health_check

  Comprehensive authentication and server status check

  Try:Check the health of the Meta API connectionTry:Verify my authentication and server status
• get_ad_accounts

  List accessible Meta ad accounts

  Try:Show all my Meta ad accountsTry:List my business accounts with their IDs

Comparable tools

Installation

npm install -g meta-ads-mcp

git clone https://github.com/wipsoft/meta-mcp.git
cd meta-ads-mcp
npm install
npm run build

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

FAQ

What authentication methods are supported?

The server supports both token-based authentication and OAuth 2.0. For token-based, you only need META_ACCESS_TOKEN. For OAuth, you also need META_APP_ID, META_APP_SECRET, and optional META_BUSINESS_ID.

How do I test if the MCP server is working correctly?

Run `npm run health-check` to verify your connection, or use the `health_check` tool directly through your MCP client. This will check authentication and server status.

Compare meta-mcp with