Facebook Ads

liveSaaSProductivity

Facebook Ads API — list ad accounts, campaigns, ad sets, and pull performance insights (impressions, clicks, spend) via OAuth.

5tools
0msauth
free tier50 calls/day

Tools

fb_list_ad_accounts

List all Facebook ad accounts you have access to. Returns account IDs, names, and status.

No parameters required.

▶Try it
fb_list_campaigns

List campaigns in a Facebook ad account (e.g., account_id: '123456789'). Returns campaign names, IDs, status, and objectives.

No parameters required.

▶Try it
fb_get_campaign

Get detailed campaign info: name, budget, status, schedule, and targeting. Requires account_id and campaign_id.

No parameters required.

▶Try it
fb_campaign_insights

Get campaign performance metrics: impressions, clicks, spend, CTR, CPC, conversions, ROAS. Requires account_id and campaign_id.

No parameters required.

▶Try it
fb_list_adsets

List ad sets in a campaign (e.g., account_id: '123456789', campaign_id: '987654321'). Returns names, IDs, status, budgets, and targeting.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/facebook_ads/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/facebook_ads/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"fb_list_ad_accounts","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("fb_list_ad_accounts", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("facebook ads api — list ad accounts, campaigns, ad sets, and pull performance insights (impressions, clicks, spend) via oauth");