MCP server

Meta Ads (Facebook & Instagram)

io.github.mcp-dir/meta_ads-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read and manage Meta Ads campaigns, ad sets, ads, audiences, pages and Business Manager. You provide

Working at last checkAbout 11,325 tokens per request once connected44 tools

Source

https://api.mcp.ai/p_meta_ads

At a glance

Type: MCP server
Publisher: Not verified
Status: Working at last check
Tools: 44
Token cost: About 11,325 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http meta-ads-mcp https://api.mcp.ai/p_meta_ads

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.meta-ads-mcp]
url = "https://api.mcp.ai/p_meta_ads"

Gemini CLI

{"mcpServers":{"meta-ads-mcp":{"httpUrl":"https://api.mcp.ai/p_meta_ads"}}}

Cursor

{"mcpServers":{"meta-ads-mcp":{"url":"https://api.mcp.ai/p_meta_ads"}}}

VS Code

{"servers":{"meta-ads-mcp":{"type":"http","url":"https://api.mcp.ai/p_meta_ads"}}}

Antigravity

agy mcp add meta-ads-mcp https://api.mcp.ai/p_meta_ads

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"meta-ads-mcp","server_url":"https://api.mcp.ai/p_meta_ads","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"meta-ads-mcp","server_url":"https://api.mcp.ai/p_meta_ads"}

Tools

meta_ads_ads ~119 tokens
List ads with creatives (image, video, copy) and performance insights. Includes spend, revenue, ROAS, actions.
meta_ads_adset_delete Deletes data · ~114 tokens
Permanently delete a Meta Ads ad set. Irreversible. Bulk support: accepts adset_ids for batched execution.
meta_ads_adset_detail ~115 tokens
Get detailed ad set info: targeting, budget, schedule, billing, optimization goal, delivery status. Fills the gap between campaigns and ads.
meta_ads_adset_write_create ~793 tokens
Create or update Meta Ads ad sets. Actions: create — new ad set linked to a campaign (targeting, budget, schedule) update — change fields on existing ad set Targeting is a JSON object: { "geo_locations": { "countries": ["BR"] }, "age_min": 18, "age_max": 65, "genders": [1, 2] } Budgets in cents.
meta_ads_adset_write_update ~793 tokens
Create or update Meta Ads ad sets. Actions: create — new ad set linked to a campaign (targeting, budget, schedule) update — change fields on existing ad set Targeting is a JSON object: { "geo_locations": { "countries": ["BR"] }, "age_min": 18, "age_max": 65, "genders": [1, 2] } Budgets in cents.
meta_ads_audience ~71 tokens
List Custom Audiences in the ad account.
meta_ads_audience_delete Deletes data · ~119 tokens
Permanently delete a Custom Audience. Irreversible. Bulk support: accepts audience_ids for batched execution.
meta_ads_audience_write_add_users ~281 tokens
Manage Custom Audiences for targeting. Actions: create — create a new custom audience add_users — upload hashed user data (email, phone, first/last name). PII is SHA-256 hashed before upload. Users format: array of { email, phone?, fn?, ln? }. Data is normalized and hashed automatically. Fo
meta_ads_audience_write_create ~279 tokens
Manage Custom Audiences for targeting. Actions: create — create a new custom audience add_users — upload hashed user data (email, phone, first/last name). PII is SHA-256 hashed before upload. Users format: array of { email, phone?, fn?, ln? }. Data is normalized and hashed automatically. Fo
meta_ads_business_accounts ~170 tokens
Read Facebook Business Manager data. Actions: list — list Business Managers accounts — ad accounts owned by a BM pages — pages owned by a BM users — business users and system users pixels — pixels owned by a BM [Flattened action: accounts] Bulk support: accepts business_ids for batched e
meta_ads_business_list ~168 tokens
Read Facebook Business Manager data. Actions: list — list Business Managers accounts — ad accounts owned by a BM pages — pages owned by a BM users — business users and system users pixels — pixels owned by a BM [Flattened action: list] Bulk support: accepts business_ids for batched execu
meta_ads_business_pages ~169 tokens
Read Facebook Business Manager data. Actions: list — list Business Managers accounts — ad accounts owned by a BM pages — pages owned by a BM users — business users and system users pixels — pixels owned by a BM [Flattened action: pages] Bulk support: accepts business_ids for batched exec
meta_ads_business_pixels ~169 tokens
Read Facebook Business Manager data. Actions: list — list Business Managers accounts — ad accounts owned by a BM pages — pages owned by a BM users — business users and system users pixels — pixels owned by a BM [Flattened action: pixels] Bulk support: accepts business_ids for batched exe
meta_ads_business_users ~169 tokens
Read Facebook Business Manager data. Actions: list — list Business Managers accounts — ad accounts owned by a BM pages — pages owned by a BM users — business users and system users pixels — pixels owned by a BM [Flattened action: users] Bulk support: accepts business_ids for batched exec
meta_ads_campaign_delete Deletes data · ~119 tokens
Permanently delete a Meta Ads campaign. Irreversible. Bulk support: accepts campaign_ids for batched execution.
meta_ads_campaign_write_activate ~444 tokens
Create, update, pause or activate Meta Ads campaigns. Actions: create — new campaign (name, objective, budget required) update — change name, budget, status pause — shortcut to pause a campaign activate — shortcut to activate a campaign Objectives: OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OU
meta_ads_campaign_write_create ~442 tokens
Create, update, pause or activate Meta Ads campaigns. Actions: create — new campaign (name, objective, budget required) update — change name, budget, status pause — shortcut to pause a campaign activate — shortcut to activate a campaign Objectives: OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OU
meta_ads_campaign_write_pause ~442 tokens
Create, update, pause or activate Meta Ads campaigns. Actions: create — new campaign (name, objective, budget required) update — change name, budget, status pause — shortcut to pause a campaign activate — shortcut to activate a campaign Objectives: OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OU
meta_ads_campaign_write_update ~442 tokens
Create, update, pause or activate Meta Ads campaigns. Actions: create — new campaign (name, objective, budget required) update — change name, budget, status pause — shortcut to pause a campaign activate — shortcut to activate a campaign Objectives: OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OU
meta_ads_campaigns ~112 tokens
List Meta Ads campaigns. Returns: id, name, status, objective, budget, dates. Set include_paused=true to also show paused campaigns.
meta_ads_creative_delete Deletes data · ~111 tokens
Permanently delete a Meta Ads ad. Irreversible. Bulk support: accepts ad_ids for batched execution.
meta_ads_creative_write_create_ad ~435 tokens
Create ad creatives and ads (final step to launch). Actions: create_creative — create ad creative with image/video + copy (requires page_id) create_ad — create ad linking creative to ad set update_ad — update ad fields (name, status, creative) For create_creative: provide image_has
meta_ads_creative_write_create_creative ~439 tokens
Create ad creatives and ads (final step to launch). Actions: create_creative — create ad creative with image/video + copy (requires page_id) create_ad — create ad linking creative to ad set update_ad — update ad fields (name, status, creative) For create_creative: provide image_has
meta_ads_creative_write_update_ad ~435 tokens
Create ad creatives and ads (final step to launch). Actions: create_creative — create ad creative with image/video + copy (requires page_id) create_ad — create ad linking creative to ad set update_ad — update ad fields (name, status, creative) For create_creative: provide image_has
meta_ads_list_accounts ~119 tokens
List Meta (Facebook) connections AND the ad accounts inside each — returns `connections[]` (OAuth logins) and `ad_accounts[]` with id (act_XXX), name, currency, timezone, status. Use the ad_account_id in `account` on the other tools.
meta_ads_media_list_images ~93 tokens
List uploaded media in the ad account. Actions: list_images, list_videos. [Flattened action: list_images]
meta_ads_media_list_videos ~93 tokens
List uploaded media in the ad account. Actions: list_images, list_videos. [Flattened action: list_videos]
meta_ads_media_write_get_upload_command ~434 tokens
Upload images and videos to Meta Ads account. Actions: upload_image — upload an image. Returns the image hash you need for create_creative. upload_video — upload video from URL (Meta fetches it). Returns video_id. get_upload_command — get a curl command for uploading large local
meta_ads_media_write_upload_image ~430 tokens
Upload images and videos to Meta Ads account. Actions: upload_image — upload an image. Returns the image hash you need for create_creative. upload_video — upload video from URL (Meta fetches it). Returns video_id. get_upload_command — get a curl command for uploading large local
meta_ads_media_write_upload_video ~430 tokens
Upload images and videos to Meta Ads account. Actions: upload_image — upload an image. Returns the image hash you need for create_creative. upload_video — upload video from URL (Meta fetches it). Returns video_id. get_upload_command — get a curl command for uploading large local
meta_ads_pages_insights ~231 tokens
Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shares post_insights — detailed insights for a specific post [Flattened action
meta_ads_pages_list ~229 tokens
Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shares post_insights — detailed insights for a specific post [Flattened action
meta_ads_pages_post_insights ~234 tokens
Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shares post_insights — detailed insights for a specific post [Flattened action
meta_ads_pages_posts ~229 tokens
Read Facebook Pages data. Actions: list — all pages the user manages (name, fan_count, followers) insights — page engagement metrics (follows, views) for a specific page posts — recent posts with likes, comments, shares post_insights — detailed insights for a specific post [Flattened action
meta_ads_realtime ~95 tokens
Hourly realtime dashboard for today. Shows per-ad breakdown with hourly stats, campaign/adset/creative details, plus _summary.
meta_ads_roas ~188 tokens
ROAS (Return on Ad Spend) for a date range using Meta's /insights endpoint — includes spend from ads in ANY status (ACTIVE/PAUSED/DISABLED/ARCHIVED). Defaults to current month, level=ad. For account totals use level=account; for per-campaign view use level=campaign. Returns per-row spend, revenue, R
meta_ads_status ~74 tokens
Validate Facebook token, check expiry date, list connected ad accounts and scopes.
meta_ads_today ~113 tokens
Today's ad performance dashboard. Returns per-ad: spend, revenue, ROAS, CPA, impressions, clicks, CTR. Plus _summary aggregate across all ads.

Browse

Related MCP servers

Hermoso
AI marketing agent and AI ad generator: 928 tools, usable alone. No markup on models.
Run1Ads: live Meta ads consultant
Live Meta ads consultant for e-commerce. Checks ads, Pixel and store hourly, then gives the one fix.
oriiion
Your marketing, a message away
Pollen — Managed Agent-Readiness Layer
Manage your Pollen account: sync, enrich, fix, and publish your store's catalog for AI agents.
CorpusIQ
One governed MCP endpoint for 40+ business systems. Read-only, source-cited answers.
Socialbridge
Unified social-media data across 10 networks: profiles, posts, search, comments, cross-search.
Mako Metrics
Competitor Meta ads intelligence reports. List plans, create orders, Stripe checkout for humans.
XCut AI – Viral Content Research
Find viral posts, outliers, hooks and ads on Instagram, TikTok, YouTube and Facebook, then write.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.mcp-dir/meta_ads-mcp.svg)](https://aptlynx.net/servers/io.github.mcp-dir/meta_ads-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents