# Facebook_ads

> Facebook_ads is a freemium MCP server for marketing and seo. MCP server giving AI clients read access to Facebook ad accounts, campaigns. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/facebook_ads
- **Repository:** https://github.com/pipeworx-io/mcp-facebook_ads
- **MCP Registry name:** io.github.pipeworx-io/facebook_ads
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

The Pipeworx Facebook Ads pack lets an AI client read data from Meta advertising accounts through five tools: listing ad accounts, listing campaigns and ad sets, fetching campaign details, and pulling campaign metrics such as impressions, clicks, spend, CTR, CPC, conversions and ROAS. According to its listing, access runs through OAuth against a connected Facebook account.

The server is hosted on the Pipeworx gateway as a streamable HTTP endpoint and can also be run locally via an npm stdio bridge that forwards calls to the same endpoint. The README says the hosted endpoint also lists shared gateway-wide meta-tools such as ask_pipeworx alongside the pack's own tools, and that the npm bridge lists only the pack's tools unless an environment flag is set.

The pack suits marketers, analysts and developers who want an assistant to summarise or query campaign performance without building their own Marketing API integration. The README describes it as an independent, unofficial integration not endorsed by Meta.

## Features

- **Ad account listing:** Returns the Facebook ad accounts the connected user can access, with IDs, names and status.
- **Campaign and ad set browsing:** Lists campaigns with status and objectives, and ad sets within a campaign with budgets and targeting.
- **Campaign detail lookup:** Fetches a campaign's name, budget, status, schedule and targeting by account and campaign ID.
- **Performance metrics:** Retrieves impressions, clicks, spend, CTR, CPC, conversions and ROAS for a given campaign.
- **Hosted or local connection:** Available as a remote streamable HTTP endpoint or a local npx stdio bridge.

## Good for

- Ask an AI assistant for spend and ROAS across a campaign
- Review which ad sets in a campaign have which budgets and targeting
- Pull a quick inventory of ad accounts and their status
- Compare campaign CTR and CPC without opening Ads Manager

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http facebook_ads https://gateway.pipeworx.io/facebook_ads/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/facebook_ads/mcp
```

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

```json
{
  "mcpServers": {
    "facebook_ads": {
      "url": "https://gateway.pipeworx.io/facebook_ads/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "facebook_ads": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/facebook_ads/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "facebook_ads": {
      "serverUrl": "https://gateway.pipeworx.io/facebook_ads/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "facebook_ads": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/facebook_ads/mcp"
    }
  }
}
```

## Tools

- `fb_list_ad_accounts`: List all Facebook ad accounts you have access to. Returns account IDs, names, and status.
- `fb_list_campaigns`: List campaigns in a Facebook ad account. Returns campaign names, IDs, status, and objectives.
- `fb_get_campaign`: Get detailed campaign info: name, budget, status, schedule, and targeting.
- `fb_campaign_insights`: Get campaign performance metrics: impressions, clicks, spend, CTR, CPC, conversions, ROAS.
- `fb_list_adsets`: List ad sets in a campaign. Returns names, IDs, status, budgets, and targeting.

## FAQ

### Does it need an API key?

The README says calls work anonymously but are capped daily. A free Pipeworx account raises the cap, and the key is passed as an optional PIPEWORX_API_KEY environment variable.

### Which tools does it provide?

Five pack tools: fb_list_ad_accounts, fb_list_campaigns, fb_get_campaign, fb_campaign_insights and fb_list_adsets. The hosted endpoint also lists shared gateway meta-tools.

### How is access authorised?

The listing says access is via OAuth to a connected Facebook account. The README says the account must be connected at pipeworx.io before the pack can be used over HTTP.

### Is Facebook_ads free?

Facebook_ads has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Facebook_ads to Claude Code?

Run this command in your terminal: claude mcp add --transport http facebook_ads https://gateway.pipeworx.io/facebook_ads/mcp

### What are the best alternatives to Facebook_ads?

The closest alternatives to Facebook_ads are Linkedin_ads, Google_ads, Meta Ads MCP by InsightfulPipe, Meta Ads MCP Server by AdKit and Meta Ads MCP by AdPlug.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Linkedin_ads](https://ai-powered.com/mcp/linkedin-ads-3): Linkedin_ads is a freemium MCP server for marketing and seo.
- [Google_ads](https://ai-powered.com/mcp/google-ads-7): Google_ads is a freemium MCP server for marketing and seo.
- [Meta Ads MCP by InsightfulPipe](https://ai-powered.com/mcp/meta-ads-mcp-by-insightfulpipe): Meta Ads MCP by InsightfulPipe is an MCP server for marketing and seo.
- [Meta Ads MCP Server by AdKit](https://ai-powered.com/mcp/meta-ads-mcp-server-by-adkit): Meta Ads MCP Server by AdKit is an MCP server for marketing and seo.
- [Meta Ads MCP by AdPlug](https://ai-powered.com/mcp/meta-ads-mcp-by-adplug): Meta Ads MCP by AdPlug is a freemium MCP server for marketing and seo.
- [Meta Ads](https://ai-powered.com/mcp/meta-ads-2): Meta Ads is a freemium MCP server for marketing and seo.
- [Ad Radar](https://ai-powered.com/mcp/ad-radar-2): Ad Radar is a freemium MCP server for marketing and seo.
- [Ads Editor: Meta Ads and Google Ads](https://ai-powered.com/mcp/ads-editor-meta-ads-and-google-ads): Ads Editor: Meta Ads and Google Ads is an MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/facebook-ads
