Meta Ads MCP server
{
"mcpServers": {
"getmcpads-meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server@latest"
],
"env": {
"META_ACCESS_TOKEN": "<meta_access_token>"
}
}
}
}{
"mcpServers": {
"getmcpads-meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server@latest"
],
"env": {
"META_ACCESS_TOKEN": "<meta_access_token>"
}
}
}
}{
"mcpServers": {
"getmcpads-meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server@latest"
],
"env": {
"META_ACCESS_TOKEN": "<meta_access_token>"
}
}
}
}{
"servers": {
"getmcpads-meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server@latest"
],
"env": {
"META_ACCESS_TOKEN": "${input:meta_access_token}"
}
}
},
"inputs": [
{
"id": "meta_access_token",
"type": "promptString",
"description": "Meta access token",
"password": true
}
]
}{
"mcpServers": {
"getmcpads-meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server@latest"
],
"env": {
"META_ACCESS_TOKEN": "<meta_access_token>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @getmcpads/meta-ads-mcp-serverversion 1.0.2
What it does
An MCP server that connects to Meta's Ads Marketing API, giving Claude and other AI clients access to read Facebook and Instagram advertising data and optionally make changes. You run it locally, keeping your access token on your machine with no third-party proxying.
- Analyze campaign performance across 190 metrics with automatic handling of incompatible metric/breakdown combinations that would normally fail.
- Preview and apply changes to ad campaigns—adjusting status, budgets, schedules, or creating new campaigns—with a confirmation step before any write executes.
- Query ads data by 56 breakdowns and 90 dimensions, checking compatibility before making API calls to avoid rejected requests.
Tools this server exposes
| Tool | Does |
|---|---|
| meta_get_node_fields | Reach Graph API fields not yet modeled by the server for forward compatibility. |
| meta_list_edge_raw | Retrieve raw edge data from the Graph API without schema modeling. |
| meta_get_insights_raw | Fetch raw insights data for forward compatibility with unmapped Graph fields. |
| meta_validate_query | Check if a metric and breakdown combination is valid before making an API call. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.