# Meta Ads

> Meta Ads is a freemium MCP server for marketing and seo. Meta Ads reporting and preview-first changes for Facebook and Instagram ads. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $39 a month
- **Platforms:** CLI, API
- **Website:** https://www.getmcpads.com/tools/meta-ads
- **Repository:** https://github.com/get-mcp-ads/meta-ads-mcp-server
- **MCP Registry name:** com.getmcpads/meta-ads
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add meta-ads --env META_ACCESS_TOKEN='<META_ACCESS_TOKEN>' -- npx -y @getmcpads/meta-ads-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/meta-ads-mcp-server"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/meta-ads-mcp-server"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "meta-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/meta-ads-mcp-server"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/meta-ads-mcp-server"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "meta-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/meta-ads-mcp-server"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
      }
    }
  }
}
```

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/meta-ads-2
