fb_list_ad_accounts

Pack: facebook_ads · Endpoint: https://gateway.pipeworx.io/facebook_ads/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/fb_list_ad_accounts for the schema, then POST the same URL with its arguments for the data.

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

Parameters

NameTypeRequiredDescription
fieldsstringnoComma-separated fields (default: “id,name,account_status,currency,balance”)
limitnumbernoMax results (default 25)

Example call

Arguments

{
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/facebook_ads/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fb_list_ad_accounts","arguments":{"limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('fb_list_ad_accounts', {
  "limit": 10
});

More examples

{
  "fields": "id,name,account_status,currency,balance,timezone_name",
  "limit": 25
}

Response shape

FieldTypeDescription
dataarrayList of ad accounts
pagingobjectPagination info
errorstringError code if connection failed
messagestringError message if connection failed
Full JSON Schema
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "description": "List of ad accounts",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Ad account ID"
          },
          "name": {
            "type": "string",
            "description": "Account name"
          },
          "account_status": {
            "type": "number",
            "description": "Account status code"
          },
          "currency": {
            "type": "string",
            "description": "Account currency"
          },
          "balance": {
            "type": "number",
            "description": "Account balance"
          }
        }
      }
    },
    "paging": {
      "type": "object",
      "description": "Pagination info",
      "properties": {
        "cursors": {
          "type": "object"
        },
        "next": {
          "type": "string"
        }
      }
    },
    "error": {
      "type": "string",
      "description": "Error code if connection failed"
    },
    "message": {
      "type": "string",
      "description": "Error message if connection failed"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

Regenerated from source · build September 22, 2026