Meta Ads Manager MCP server for AI agents
Let Claude, ChatGPT or your own agent read Meta Ads Manager: 4 typed functions through one MCP server. No Meta Ads Manager API key needed.
- Functions
- 4
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Meta Ads Manager alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/adsmanager_facebookOne MCP server for Meta Ads Manager and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getAccountInsightsReads one ad account totals (spend, impressions, clicks, reach, CTR, CPC, CPM) for a date range, as the Ads Manager summary row shows them.Arguments
Name Type Required accountIdstringAdAccount.id.Yes datePresetstring"last_30d" (default), "last_7d", "this_month", "maximum", …No sincestringYYYY-MM-DD, with until, overrides datePreset.No untilstringNo Returns
AdStats | nullinterface AdStats { spend: number | null; // in the account's currency impressions: number | null; clicks: number | null; reach: number | null; ctr: number | null; // percent cpc: number | null; cpm: number | null; dateStart: string | null; // YYYY-MM-DD dateStop: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/getAccountInsightsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.adsmanager_facebook.getAccountInsights({ accountId: "act_1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.adsmanager_facebook.getAccountInsights({"accountId": "act_1"}))curl -X POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/getAccountInsights \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"accountId":"act_1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.adsmanager_facebook.getAccountInsights({ accountId: "act_1" });listAdAccountsLists every ad account the signed-in caller can see in Ads Manager, with currency, status and lifetime spend.Arguments
None.
Returns
AdAccount[]interface AdAccount { id: string; // "act_<digits>", pass this as accountId accountId: string; name: string | null; currency: string | null; status: number | null; // Meta's account_status: 1 active, 2 disabled, … amountSpent: number | null; // lifetime, in the currency's minor unit as Meta reports it timezone: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/listAdAccountsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.adsmanager_facebook.listAdAccounts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.adsmanager_facebook.listAdAccounts())curl -X POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/listAdAccounts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.adsmanager_facebook.listAdAccounts();listAdsLists the account ads (optionally one campaign), as on the Ads tab, each with status and its stats for the range.Arguments
Name Type Required argsAdsListArgsYes interface AdAccount { id: string; // "act_<digits>", pass this as accountId accountId: string; name: string | null; currency: string | null; status: number | null; // Meta's account_status: 1 active, 2 disabled, … amountSpent: number | null; // lifetime, in the currency's minor unit as Meta reports it timezone: string | null; } interface AdsStatsArgs { accountId: string; // AdAccount.id datePreset?: string; // "last_30d" (default), "last_7d", "this_month", "maximum", … since?: string; // YYYY-MM-DD, with until, overrides datePreset until?: string; } interface AdsListArgs extends AdsStatsArgs { campaignId?: string; // listAds only: just this campaign's ads }Returns
AdsAd[]interface AdStats { spend: number | null; // in the account's currency impressions: number | null; clicks: number | null; reach: number | null; ctr: number | null; // percent cpc: number | null; cpm: number | null; dateStart: string | null; // YYYY-MM-DD dateStop: string | null; } interface AdsAd { id: string; name: string; status: string | null; effectiveStatus: string | null; campaignId: string | null; adsetId: string | null; stats: AdStats | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/listAdsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.adsmanager_facebook.listAds({ accountId: "act_1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.adsmanager_facebook.listAds({"accountId": "act_1"}))curl -X POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/listAds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"accountId":"act_1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.adsmanager_facebook.listAds({ accountId: "act_1" });listCampaignsLists the account campaigns, as on the Campaigns tab, each with status, objective and its stats for the range.Arguments
Name Type Required accountIdstringAdAccount.id.Yes datePresetstring"last_30d" (default), "last_7d", "this_month", "maximum", …No sincestringYYYY-MM-DD, with until, overrides datePreset.No untilstringNo Returns
AdsCampaign[]interface AdStats { spend: number | null; // in the account's currency impressions: number | null; clicks: number | null; reach: number | null; ctr: number | null; // percent cpc: number | null; cpm: number | null; dateStart: string | null; // YYYY-MM-DD dateStop: string | null; } interface AdsCampaign { id: string; name: string; status: string | null; effectiveStatus: string | null; objective: string | null; stats: AdStats | null; // null = no delivery in the range }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/listCampaignsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.adsmanager_facebook.listCampaigns({ accountId: "act_1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.adsmanager_facebook.listCampaigns({"accountId": "act_1"}))curl -X POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/listCampaigns \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"accountId":"act_1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.adsmanager_facebook.listCampaigns({ accountId: "act_1" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/adsmanager_facebook/<function> - OpenAPI
/v1/sites/adsmanager_facebook/openapi.json