Pipeboard Meta Ads MCP Server: Manage Facebook and Instagram Ads from Claude

• Lists the ad accounts you can reach

  Returns the ad accounts linked to your Meta login, with spend and balance in normal currency units rather than cents.

  Try: “Which Meta ad accounts do I have access to?”

  Network · get_ad_accounts

• Shows details for one ad account

  Returns details for one ad account such as status, currency and spend cap. You can ask for extra fields like funding source or minimum daily budget.

  Try: “Show the spend cap and currency for act_123456.”

  Network · get_account_info

• Lists Facebook pages tied to an account

  Returns the Facebook pages connected to an ad account, which you need when you create ads.

  Try: “Which pages can I run ads from in act_123456?”

  Network · get_account_pages

• Finds pages in an account by name

  Searches an account's pages by a word in their name, or returns all of them if you give no search term.

  Try: “Find the page named 'Acme Coffee' in act_123456.”

  Network · search_pages_by_name

• Lists campaigns in an account

  Lists campaigns for an ad account. You can filter by status such as ACTIVE, PAUSED or ARCHIVED and set how many to return.

  Try: “List the active campaigns in act_123456.”

  Network · get_campaigns

• Shows one campaign's settings

  Returns the settings of a single campaign, including its objective, status and budget fields.

  Try: “Show the details of campaign 120200000000.”

  Network · get_campaign_details

• Creates a campaign, paused by default

  Creates a new Facebook or Instagram campaign with one of the outcome-based objectives, budget mode, bid strategy, spend cap and special ad categories. The status defaults to PAUSED, so nothing runs until you turn it on.

  Try: “Create a paused traffic campaign called 'Spring sale' in act_123456.”

  Write · create_campaign

• Changes a campaign's name, status or budget

  Edits an existing campaign. You can rename it, switch it on or off, change budgets, bid strategy or spend cap, and move budgets from campaign level to ad set level.

  Try: “Pause campaign 120200000000 and set its daily budget to 50 dollars.”

  Write · update_campaign

• Lists ad sets in an account or campaign

  Lists ad sets for an account, optionally only those inside one campaign.

  Try: “List the ad sets in campaign 120200000000.”

  Network · get_adsets

• Shows one ad set's settings

  Returns the settings of one ad set, including targeting, budget and schedule.

  Try: “Show the targeting of ad set 120300000000.”

  Network · get_adset_details

• Creates an ad set with targeting and budget

  Creates an ad set inside a campaign with an optimization goal, budget, schedule and targeting. Which goals are valid depends on the campaign objective and destination.

  Try: “Create an ad set in campaign 120200000000 targeting women 25 to 40 in Canada with a 20 dollar daily budget.”

  Write · create_adset

• Changes an ad set's budget, bid or limits

  Edits an existing ad set. You can change its name, budgets, bid strategy and frequency caps, and turn it on or off.

  Try: “Cap ad set 120300000000 at 3 impressions per person per week.”

  Write · update_adset

• Lists ads in an account

  Lists ads for an account, optionally filtered by campaign or ad set.

  Try: “List the ads in ad set 120300000000.”

  Network · get_ads

• Shows one ad's settings

  Returns the settings and status of a single ad.

  Try: “Show the details of ad 120400000000.”

  Network · get_ad_details

• Shows the creatives used by an ad

  Returns the creative details attached to one ad. You need the ad ID, so list ads first.

  Try: “What creative is ad 120400000000 using?”

  Network · get_ad_creatives

• Shows one creative by ID

  Returns the full details of a single ad creative when you already have its ID.

  Try: “Show creative 120500000000.”

  Network · get_creative_details

• Fetches an ad's image so the assistant can see it

  Downloads the image an ad is currently serving and hands it back for the assistant to look at.

  Try: “Look at the image in ad 120400000000 and suggest better copy.”

  Network · get_ad_image

• Fetches an image from its hash

  Downloads an ad image from its hash when you have no ad, for example one returned by an earlier upload.

  Try: “Show me the image with hash abc123 in act_123456.”

  Network · get_image_by_hash

• Gets a video's source link and status

  Returns the source URL, thumbnail, processing status and basic details of an ad video.

  Try: “Is video 120600000000 finished processing?”

  Network · get_ad_video

• Creates an ad from an existing creative

  Creates a new ad in an ad set using a creative that already exists. The status defaults to PAUSED.

  Try: “Create a paused ad in ad set 120300000000 using creative 120500000000.”

  Write · create_ad

• Changes an ad's name, status or creative

  Edits an ad. You can rename it, switch it on or off, change its bid or tracking, or swap in a different creative.

  Try: “Pause ad 120400000000.”

  Write · update_ad

• Uploads an image for use in ads

  Uploads an image to an ad account from base64 data or a link and returns the image hash to use in creatives. When you give a link, the server fetches it.

  Try: “Upload https://example.com/banner.png to act_123456.”

  Write · upload_ad_image

• Works out crop boxes for ad placements

  Calculates centered crop coordinates for an image size so it fits each placement ratio. It runs the maths only and does not call Meta.

  Try: “Compute crops for a 1600 by 900 image.”

  Read · compute_image_crops

• Builds a creative from an image, video or post

  Creates an ad creative from an uploaded image hash, a video, or an existing page post. It supports several modes, including multiple headlines and descriptions for testing.

  Try: “Create a creative with image hash abc123, headline 'Spring sale' and a Shop now button.”

  Write · create_ad_creative

• Renames a creative or changes its testing options

  Updates only a creative's name and its optimization settings. Meta does not allow editing text, image or link on an existing creative, so you create a new one for that.

  Try: “Rename creative 120500000000 to 'Spring v2'.”

  Write · update_ad_creative

• Pulls performance numbers

  Returns performance data for an account, campaign, ad set or ad over a date range, such as spend, clicks and conversions.

  Try: “Show spend and results by campaign for the last 7 days in act_123456.”

  Network · get_insights

• Schedules a budget boost for a busy period

  Adds a scheduled budget increase to a campaign for a time window, either as an amount or a multiplier.

  Try: “Raise campaign 120200000000's budget 1.5 times from Friday to Sunday.”

  Write · create_budget_schedule

• Searches interest targeting options

  Searches Meta's interest targeting options by keyword and returns IDs, names and audience size.

  Try: “Find interests related to 'trail running'.”

  Network · search_interests

• Suggests more interests from ones you have

  Given interests you already use, returns related interests you could target.

  Try: “Suggest interests similar to Basketball and Soccer.”

  Network · get_interest_suggestions

• Estimates how many people a targeting mix reaches

  Estimates the audience size for a combination of location, age, interests and behaviors using Meta's delivery estimate.

  Try: “Estimate the audience for women 25 to 40 in Canada interested in yoga.”

  Network · estimate_audience_size

• Lists behavior targeting options

  Returns the behavior targeting options Meta offers, with IDs and audience size ranges.

  Try: “List available behavior targeting options.”

  Network · search_behaviors

• Lists demographic targeting options

  Returns demographic options such as life events, industries, income or family status, depending on the class you pick.

  Try: “List the life event targeting options.”

  Network · search_demographics

• Finds locations to target

  Searches countries, regions, cities, zip codes and other places and returns their targeting keys.

  Try: “Find the targeting key for Toronto.”

  Network · search_geo_locations

• Gives a link to sign in to Meta

  Starts a short-lived local page for signing in with Meta and returns the sign-in link. It is for the self-run server and is on unless the operator turns it off.

  Try: “Give me a link to log in to Meta Ads.”

  Network · get_login_link

• Searches the public Facebook Ads Library

  Searches Meta's public Ads Library for ads that mention your terms in the countries you pick, with fields like spend ranges and delivery dates. It is on unless the operator turns it off.

  Try: “Search the Ads Library in the US for ads mentioning 'running shoes'.”

  Network · search_ads_archive

Watch out for

• It can start ads that spend real money

  update_campaign, update_adset and update_ad can switch ads on and change budgets, so a wrong change can start spending from your ad account. Create items paused, and check each change before you approve it. github.com

• The token-in-URL option puts a secret in the address

  The README offers a Pipeboard token inside the server URL. URLs end up in logs, history and screenshots, so prefer the normal sign-in unless a client needs the token. github.com

• Your ad data passes through Pipeboard

  The hosted server is run by Pipeboard, not Meta. Review its terms and privacy policy before linking an account with client data. github.com

• Older versions of the self-run server had serious bugs

  Three advisories hit every version of the meta-ads-mcp package before the fix: GHSA-9gw6-46qc-99vr (leaked the operator Meta token to unauthenticated HTTP callers) affects versions below 1.0.109, and GHSA-2v2f-mvfg-ph56 (token header bypass) and GHSA-45gf-fjxp-cjpq (SSRF in upload_ad_image) affect versions below 1.0.115. The 1.0.128 release is past all three fixes. Update if you run your own copy. osv.dev

• The license is source-available, not open source

  It uses the Business Source License 1.1 and becomes Apache 2.0 in 2029. You may not offer it as a competing hosted service. github.com

Security advisories