Skip to content
MCP server

Meta Ads

Meta Ads reporting and preview-first changes for Facebook and Instagram ads

Runs locallyStatus and history
Install
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-server

Add 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.Required
  • META_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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data