Labsco
MCP SERVER

Meta Ads Mcp Server

by hashcott

Pull Meta ad performance at account, campaign, ad set and ad level, and search Meta's interest, behavior, demographic and geo catalogs before a targeting spec is written.

Marketing Automation & AdvertisingVerified
Summary
Ads reporting and audience research answered in the client, without opening Ads Manager.

All 35 tools read: insights at every level of the hierarchy, creative and image lookups, activity logs, and the interest, behavior, demographic and geo catalogs a targeting spec draws on. None of them alters a campaign — creating and editing sit behind META_ADS_ENABLE_WRITE_TOOLS. The insight and record tools take an explicit fields list, so naming the metrics you want keeps a response to a workable size.

What it is

An MCP server over Meta's Graph API advertising endpoints — ad accounts, campaigns, ad sets, ads, creatives, activity logs and the targeting search catalogs

What you get
  • Performance insights at account, campaign, ad set and ad level, each taking demographic breakdowns, attribution windows and either a date preset or an explicit time range.
  • Hierarchy walks in both directions: campaigns by account, ad sets by account or by campaign, ads by account, campaign or ad set — all with status filters and pagination.
  • Creative inspection — creatives by account or by ad, image lookup by hash, ad video source and thumbnail, and placement previews returned as links or embed HTML.
  • Targeting research before anything is spent: keyword search over interests, suggestions from a seed list, behavior and demographic catalogs, geo search, and an audience-size estimate for a full targeting spec.
  • Change history for an account or an ad set — status changes, budget updates, targeting edits — covering one week by default.
  • meta_ads_compute_image_crops returns centered crop coordinates for the aspect-ratio keys Meta accepts, and meta_ads_fetch_pagination_url follows a paging URL when a response is cut short.
Requirements

A Meta ad account and a Facebook user whose token reaches it, supplied as META_ADS_ACCESS_TOKEN, together with META_ADS_ENABLE_WRITE_TOOLS, the flag for the write tools.

Setup effort

One command plus a key — npx meta-ads-mcp-server --access-token YOUR_META_ACCESS_TOKEN, then supply credentials