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:
- A Meta Business account
- Access to Meta Ads Manager
- A Meta App with Marketing API access
- An access token with appropriate permissions
2. Get Your Access Token
- Go to Meta for Developers
- Create a new app or select an existing one
- Add the Marketing API product to your app
- Generate an access token with the following permissions:
ads_readads_managementbusiness_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