Skip to content
MCP server

Facebook_ads

MCP server giving AI clients read access to Facebook ad accounts, campaigns

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Facebook_ads

Facebook_ads is a freemium MCP server for marketing and seo. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/facebook_ads/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "facebook_ads": {
      "url": "https://gateway.pipeworx.io/facebook_ads/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous and free registered tiers; paid credits and subscriptions for metered use

Prices change. Check pipeworx.io before you buy.

Facebook_ads 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.

How AIPoweredBot checks servers