
Facebook_ads
MCP server giving AI clients read access to Facebook ad accounts, campaigns
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/facebook_ads/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"facebook_ads": {
"url": "https://gateway.pipeworx.io/facebook_ads/mcp"
}
}
}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.