Meta Ads MCP Server

Connect AI assistants to Meta advertising data. Analyze Facebook and Instagram ad performance, audiences, and creative insights.

Overview

The Meta Ads MCP Server provides AI-powered access to your Facebook and Instagram advertising data. Query campaign performance, analyze audience insights, and get creative recommendations through natural language conversations.

Available Tools

Campaign Management

  • List all ad accounts and campaigns
  • Get campaign details and performance metrics
  • Analyze campaign performance over time

Performance Analytics

  • Track impressions, clicks, conversions, and spend
  • Analyze ad set and ad-level performance
  • Compare performance across different time periods
  • Identify top-performing creatives

Audience Insights

  • Analyze audience demographics
  • Get audience performance metrics
  • Identify high-performing audience segments

Creative Analysis

  • Analyze ad creative performance
  • Compare different creative formats
  • Get recommendations for creative optimization

Getting Started

1. Set Up Meta Ads API Access

To use this server, you'll need:

  1. A Meta Business account
  2. Access to Meta Ads Manager
  3. A Meta App with Marketing API access
  4. An access token with appropriate permissions

2. Get Your Access Token

  1. Go to Meta for Developers
  2. Create a new app or select an existing one
  3. Add the Marketing API product to your app
  4. Generate an access token with the following permissions:
    • ads_read
    • ads_management
    • business_management

3. Connect to Claude or Cursor

Add the server configuration to your Claude Desktop or Cursor MCP settings:

{
  "mcpServers": {
    "metaAdsServer": {
      "command": "/FULL/PATH/TO/.venv/bin/python",
      "args": ["/FULL/PATH/TO/meta_ads_server.py"],
      "env": {
        "META_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN",
        "META_AD_ACCOUNT_ID": "YOUR_AD_ACCOUNT_ID"
      }
    }
  }
}

Example Queries

Once connected, you can ask questions like:

  • "Show me my top performing campaigns from the last 30 days"
  • "Analyze my Facebook ad performance compared to Instagram"
  • "What are my best performing ad creatives this month?"
  • "Compare my campaign ROAS across different audiences"
  • "Show me campaigns with declining performance and suggest optimizations"

Connection Details

Connection URL:

https://mcp.leonhoulier.com/meta-ads/mcp

Resources