Skip to content
Agentmart
Submit a tool

Meta Ads (Facebook & Instagram)

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

Connector by mcp-dir · GitHub account verified by the MCP Registry

IndexedMITRemote (HTTP)
Write a review

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mcp-dir-meta-ads-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://api.mcp.ai/p_meta_ads Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
23 read · 17 write · 4 delete
Secrets
None asked for
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 44

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 23 · Look things up without changing anything.

  • connect
  • meta_ads_ads
  • meta_ads_adset_detail
  • meta_ads_audience
  • meta_ads_business_accounts
  • meta_ads_business_list
  • meta_ads_business_pages
  • meta_ads_business_pixels
  • meta_ads_business_users
  • meta_ads_campaigns
  • meta_ads_list_accounts
  • meta_ads_media_list_images
Show 11 more tools
  • meta_ads_media_list_videos
  • meta_ads_pages_insights
  • meta_ads_pages_list
  • meta_ads_pages_post_insights
  • meta_ads_pages_posts
  • meta_ads_realtime
  • meta_ads_roas
  • meta_ads_status
  • meta_ads_today
  • show_version
  • toolkit_info

Write 17 · Create, change, send or run things.

  • authenticate
  • marketplace
  • meta_ads_adset_write_create
  • meta_ads_adset_write_update
  • meta_ads_audience_write_add_users
  • meta_ads_audience_write_create
  • meta_ads_campaign_write_activate
  • meta_ads_campaign_write_create
  • meta_ads_campaign_write_pause
  • meta_ads_campaign_write_update
  • meta_ads_creative_write_create_ad
  • meta_ads_creative_write_create_creative
Show 5 more tools
  • meta_ads_creative_write_update_ad
  • meta_ads_media_write_get_upload_command
  • meta_ads_media_write_upload_image
  • meta_ads_media_write_upload_video
  • report_bug

Delete 4 · Delete, drop, revoke or wipe things.

  • meta_ads_adset_delete
  • meta_ads_audience_delete
  • meta_ads_campaign_delete
  • meta_ads_creative_delete

Network hosts it talks to 1

  • api.mcp.ai · found in remote endpoint, install command

Files it touches

  • Any path the agent passes to its tools

Tools (44)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • authenticateAuthenticate

    MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

  • connectConnection Statusread-only

    Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

  • marketplaceMarketplace

    The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential…

  • meta_ads_adsread-only

    List ads with creatives (image, video, copy) and performance insights. Includes spend, revenue, ROAS, actions.

  • meta_ads_adset_deletecan change or delete data

    Permanently delete a Meta Ads ad set. Irreversible. Bulk support: accepts adset_ids for batched execution.

  • meta_ads_adset_detailread-only

    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

    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. BUDGET (most common create failure): the ad set REQUIRES daily_budget or lifetime_budget, UNLESS the parent campaign already carries the budget (campaign budget optimization) — in which case the ad set must NOT send one. lifetime_budget also requires end_time. optimization_goal must match the campa…

  • meta_ads_adset_write_update

    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. BUDGET (most common create failure): the ad set REQUIRES daily_budget or lifetime_budget, UNLESS the parent campaign already carries the budget (campaign budget optimization) — in which case the ad set must NOT send one. lifetime_budget also requires end_time. optimization_goal must match the campa…

  • meta_ads_audienceread-only

    List Custom Audiences in the ad account.

  • meta_ads_audience_deletecan change or delete data

    Permanently delete a Custom Audience. Irreversible. Bulk support: accepts audience_ids for batched execution.

  • meta_ads_audience_write_add_users

    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. For destructive delete use meta_ads_audience_delete. [Flattened action: add_users] Bulk support: accepts audience_ids for batched execution.

  • meta_ads_audience_write_create

    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. For destructive delete use meta_ads_audience_delete. [Flattened action: create] Bulk support: accepts audience_ids for batched execution.

  • meta_ads_business_accountsread-only

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

  • meta_ads_business_listread-only

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

  • meta_ads_business_pagesread-only

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

Show 29 more tools
  • meta_ads_business_pixelsread-only

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

  • meta_ads_business_usersread-only

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

  • meta_ads_campaign_deletecan change or delete data

    Permanently delete a Meta Ads campaign. Irreversible. Bulk support: accepts campaign_ids for batched execution.

  • meta_ads_campaign_write_activate

    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, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_AWARENESS, OUTCOME_APP_PROMOTION. Budgets are in cents (e.g. 5000 = $50.00). A budget HERE means campaign budget optimization: the ad sets under it must then NOT carry their own budget. Leave the campaign budget empty to budget per ad set instead. For destructive …

  • meta_ads_campaign_write_create

    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, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_AWARENESS, OUTCOME_APP_PROMOTION. Budgets are in cents (e.g. 5000 = $50.00). A budget HERE means campaign budget optimization: the ad sets under it must then NOT carry their own budget. Leave the campaign budget empty to budget per ad set instead. For destructive …

  • meta_ads_campaign_write_pause

    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, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_AWARENESS, OUTCOME_APP_PROMOTION. Budgets are in cents (e.g. 5000 = $50.00). A budget HERE means campaign budget optimization: the ad sets under it must then NOT carry their own budget. Leave the campaign budget empty to budget per ad set instead. For destructive …

  • meta_ads_campaign_write_update

    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, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_AWARENESS, OUTCOME_APP_PROMOTION. Budgets are in cents (e.g. 5000 = $50.00). A budget HERE means campaign budget optimization: the ad sets under it must then NOT carry their own budget. Leave the campaign budget empty to budget per ad set instead. For destructive …

  • meta_ads_campaignsread-only

    List Meta Ads campaigns. Returns: id, name, status, objective, budget, dates. Set include_paused=true to also show paused campaigns.

  • meta_ads_creative_deletecan change or delete data

    Permanently delete a Meta Ads ad. Irreversible. Bulk support: accepts ad_ids for batched execution.

  • meta_ads_creative_write_create_ad

    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_hash (from upload_image) OR video_id (from upload_video) + page_id + message. call_to_action_type: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, GET_QUOTE, CONTACT_US, SUBSCRIBE, BOOK_NOW, etc. For destructive delete use meta_ads_creative_delete. [Flattened action: create_ad] Bulk support: accepts page_id…

  • meta_ads_creative_write_create_creative

    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_hash (from upload_image) OR video_id (from upload_video) + page_id + message. call_to_action_type: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, GET_QUOTE, CONTACT_US, SUBSCRIBE, BOOK_NOW, etc. For destructive delete use meta_ads_creative_delete. [Flattened action: create_creative] Bulk support: accepts p…

  • meta_ads_creative_write_update_ad

    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_hash (from upload_image) OR video_id (from upload_video) + page_id + message. call_to_action_type: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, GET_QUOTE, CONTACT_US, SUBSCRIBE, BOOK_NOW, etc. For destructive delete use meta_ads_creative_delete. [Flattened action: update_ad] Bulk support: accepts page_id…

  • meta_ads_list_accountsread-only

    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_imagesread-only

    List uploaded media in the ad account. Actions: list_images, list_videos. [Flattened action: list_images]

  • meta_ads_media_list_videosread-only

    List uploaded media in the ad account. Actions: list_images, list_videos. [Flattened action: list_videos]

  • meta_ads_media_write_get_upload_command

    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 video files (keeps file out of AI context). upload_image accepts the file in four ways (use exactly one): image_url/file_url (public URL), upload_id (uploaded via the command this tool hands you), file_base64, or upload_code. Call upload_image with NO file to get a ready-made upload command for a f…

  • meta_ads_media_write_upload_image

    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 video files (keeps file out of AI context). upload_image accepts the file in four ways (use exactly one): image_url/file_url (public URL), upload_id (uploaded via the command this tool hands you), file_base64, or upload_code. Call upload_image with NO file to get a ready-made upload command for a f…

  • meta_ads_media_write_upload_video

    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 video files (keeps file out of AI context). upload_image accepts the file in four ways (use exactly one): image_url/file_url (public URL), upload_id (uploaded via the command this tool hands you), file_base64, or upload_code. Call upload_image with NO file to get a ready-made upload command for a f…

  • meta_ads_pages_insightsread-only

    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: insights] Bulk support: accepts page_ids, post_ids for batched execution.

  • meta_ads_pages_listread-only

    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: list] Bulk support: accepts page_ids, post_ids for batched execution.

  • meta_ads_pages_post_insightsread-only

    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: post_insights] Bulk support: accepts page_ids, post_ids for batched execution.

  • meta_ads_pages_postsread-only

    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: posts] Bulk support: accepts page_ids, post_ids for batched execution.

  • meta_ads_realtimeread-only

    Hourly realtime dashboard for today. Shows per-ad breakdown with hourly stats, campaign/adset/creative details, plus _summary.

  • meta_ads_roasread-only

    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, ROAS, plus _summary.

  • meta_ads_statusread-only

    Validate Facebook token, check expiry date, list connected ad accounts and scopes.

  • meta_ads_todayread-only

    Today's ad performance dashboard. Returns per-ad: spend, revenue, ROAS, CPA, impressions, clicks, CTR. Plus _summary aggregate across all ads.

  • report_bugReport Bug

    Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

  • show_versionShow Versionread-only

    Show the current MCP platform and adapter versions.

  • toolkit_infoToolkit Inforead-only

    Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Signals

Stars
0
Forks
0
Open issues
0
Last commit
Aug 21, 2026 (2 months ago)
Last release
Aug 21, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.mcp-dir/meta_ads-mcp
Version
0.1.0
Auth
Auth not stated
License
MIT
Repository
github.com/mcp-dir/meta_ads-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from mcp-dir

Cite this page

Meta Ads (Facebook & Instagram) MCP server. Agent Mart. https://agentmart.dev/connectors/mcp-dir-meta-ads-mcp (last updated 2026-10-24)