Meta Ads
Meta Ads reporting and preview-first changes for Facebook and Instagram ads
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 2.1.2
- Listing updated
- 3 days ago
About Meta Ads
Meta Ads is a freemium MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
Every write passes through a preview before it takes effect, and anything created starts paused. That is the safety model of this Meta Ads server, which exposes 42 read tools and 24 write tools. The writes are off unless META_ENABLE_WRITES is set to 1, and even then calls only preview until confirm: true is passed.
There are two ways to use it. The open-source stdio package runs locally with your own Meta access token (ads_read at minimum) and sends requests straight to Meta. A hosted version, getmcpads, connects with a Facebook sign-in, lets you tick the ad accounts to share and adds a creative gallery, hourly alerts on spend, CPA or ROAS, scheduled Google Sheets exports and bulk launches from Google Drive, Dropbox, Figma, Frame.io and Keepeek. Reporting covers 191 metrics and 143 dimensions with breakdowns by placement, age or country.
The README requires a recent Node.js 22, 24 or 26 release, and the registry entry lists Graph API v26.0 as the default.
Install
Run in a terminal
claude mcp add meta-ads --env META_ACCESS_TOKEN='<META_ACCESS_TOKEN>' -- npx -y @getmcpads/meta-ads-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"meta-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"meta-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/meta-ads-mcp-server"
],
"env": {
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
}
}
}
}Configuration
META_ACCESS_TOKENMeta access token with at least the ads_read permission.RequiredMETA_ENABLE_WRITESSet to 1 to expose 24 write tools. Default calls preview; confirm:true applies changes.META_API_VERSIONGraph API version. Defaults to v26.0.
What it does
- Read reporting
- Spend, results and creatives by campaign, ad set and ad, with 191 metrics and 143 dimensions.
- Preview before change
- Pause, resume, rename and budget or schedule changes show a preview first.
- Created paused
- New campaigns, ad sets and ads start paused.
- Opt-in writes
- 24 write tools exist only when META_ENABLE_WRITES is set.
- Hosted extras
- Creative gallery, hourly alerts and scheduled Sheets exports on the hosted plan.
- Bulk launches
- Builds image, video, carousel and other ads from files into one approved proposal.
Good for
- Compare campaign spend and results by placement
- Pause underperforming ad sets after a preview
- Launch many creatives from a shared drive as paused ads
- Get an alert when CPA passes a threshold
Pricing
Freemium, from $39 a month
Free plan for 1 ad account (200 requests a month); Pro $39/month, Team $99/month; open-source servers can be self-hosted
Prices change. Check getmcpads.com before you buy.
Meta Ads FAQ
Can it change my campaigns without asking?
No. Writes are disabled by default, and applying a change needs confirm: true after a preview.
What token does it need?
A Meta access token with at least the ads_read permission for the local package.
What does the hosted version cost?
Free for 1 ad account with 200 requests a month, Pro $39 and Team $99 a month.
Which assistants are supported?
The hosted pages list Claude, ChatGPT, Claude Code, Codex, Cursor and others.
Is Meta Ads free?
Meta Ads has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.
How do I add Meta Ads to Claude Code?
Run this command in your terminal: claude mcp add meta-ads --env META_ACCESS_TOKEN='<META_ACCESS_TOKEN>' -- npx -y @getmcpads/meta-ads-mcp-server
What are the best alternatives to Meta Ads?
The closest alternatives to Meta Ads are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.
Alternatives to Meta Ads

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data