Labsco
MCP SERVER

Meta Ads MCP

by pipeboard-co

Run Facebook and Instagram advertising from the conversation — build the campaign, size the audience, upload the creative, and read what it did.

Marketing Automation & AdvertisingVerified
Summary
The whole campaign, from targeting research to the performance read, happens in one place.

What it takes off you is Ads Manager's click path: the objects are addressable in the order you actually work in them — find the audience, build the campaign and its ad sets, upload the creative, then read insights back at whichever level the question is about. Meta's own constraints stay visible rather than being smoothed over, including the one where creative content cannot be edited after the fact and a new creative has to be made instead.

What it is

A Meta Ads API surface covering the whole object hierarchy — accounts, campaigns, ad sets, ads, creatives — plus targeting research, creative upload and performance reporting. Every write asks for confirmation first, and new campaigns start paused.

What you get
  • The ad accounts a user can reach, and one account's details with amounts in currency units rather than cents
  • Campaigns created with an ODAX objective, campaign- or ad-set-level budgets, bid strategy, spend cap and special ad categories — and updated afterwards, including a migration from campaign budgets to ad-set budgets
  • Ad sets created and updated with optimization goal, billing event, bid strategy and constraints, schedule, frequency caps, targeting and dynamic creative
  • Ads created against an existing creative, and updated for name, status, bid, tracking specs or a different creative
  • Creatives built from an uploaded image hash, a video id or an existing page post, across six modes, with headlines, descriptions, call-to-action type and asset customization rules
  • Images uploaded from a data URL, raw base64 or a remote URL, and crop coordinates computed for a set of aspect ratios
  • An ad's image or video pulled back for inspection, by ad id, image hash or video id, with processing status for a video still transcoding
  • Interests, behaviours, demographics and geographic locations searched as targeting options, interest suggestions from a starting list, and an audience size estimate for a full targeting spec
  • Performance insights at account, campaign, ad set or ad level, with breakdowns, action breakdowns, attribution windows and a time range
  • The Facebook Ads Library archive searched by terms, countries and ad type
  • A budget schedule that raises budget over a window you name, given as Unix timestamps
  • The pages on an account, and a page search by name
Requirements

The quickest path is the hosted server at https://meta-ads.mcp.pipeboard.co/, which authenticates with a Pipeboard API token and needs no local install or Meta developer app. To run it yourself: uv, and a Meta Ads access token — every call takes one or falls back to a cached token, and the login-link tool only mints one if you have registered your own Facebook app. The code is under the Business Source License 1.1: free to use, modify and redistribute, but not to resell as a competing hosted service, and it becomes Apache 2.0 in 2029.

Setup effort

One command plus a key — uvx meta-ads-mcp, then supply credentials