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

Just Meta Ads Manager

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_facebook
Every site

One 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/mcp
Set it up in your client

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

Read 4
  • 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

    NameTypeRequired
    accountIdstring
    AdAccount.id.
    Yes
    datePresetstring
    "last_30d" (default), "last_7d", "this_month", "maximum", …
    No
    sincestring
    YYYY-MM-DD, with until, overrides datePreset.
    No
    untilstringNo

    Returns AdStats | null

    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;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/adsmanager_facebook/getAccountInsights

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listAdAccounts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/listAds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    accountIdstring
    AdAccount.id.
    Yes
    datePresetstring
    "last_30d" (default), "last_7d", "this_month", "maximum", …
    No
    sincestring
    YYYY-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/listCampaigns

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.adsmanager_facebook.listCampaigns({ accountId: "act_1" });

Use it from code