Meta Ads (Facebook & Instagram)
MCP serverDev toolsGive your AI access to Meta Ads so it can read and manage your advertising for you. Once added, it can work with your campaigns, ad sets, ads, audiences, pages, and Business Manager. That means you can ask for updates or changes in plain language instead of doing them by hand.
Use Meta Ads (Facebook & Instagram) in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add Meta Ads (Facebook & Instagram) and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the meta ads list accounts tool from Meta Ads (Facebook & Instagram)
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
Details
Available today. Use it from your connected AI after setup.
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
After adding it, provide your Meta Ads account access when prompted. Then ask your AI to review a campaign or make a change to see it in action.
What your AI can do with it
- Review your Meta Ads campaigns
- Create and edit ad sets
- Update individual ads
- Look up and manage audiences
- Check on your Pages
- Work across Business Manager
Install Meta Ads (Facebook & Instagram)
The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.
Claude Code
claude mcp add --transport http --scope user meta-ads-facebook-instagram 'https://api.mcp.ai/p_meta_ads'Run it once in your project, then open /mcp to approve any sign-in the server asks for.
Claude Desktop
https://api.mcp.ai/p_meta_adsAdd a custom connector in Settings, paste this address, and approve the sign-in.
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=meta-ads-facebook-instagram&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9tZXRhX2FkcyJ9Open the link and Cursor adds the server at that address.
ChatGPT
https://api.mcp.ai/p_meta_adsIn Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.
Codex
codex mcp add meta-ads-facebook-instagram --url 'https://api.mcp.ai/p_meta_ads'Run it once, then sign in with codex mcp login meta-ads-facebook-instagram if the server asks for an account.
From the project's README
As published by mcp-dir/meta_ads-mcp in README.md.
Meta Ads (Facebook & Instagram) para Claude, ChatGPT e agentes de IA
Leitura e gestão de campanhas Meta Ads, ad sets, ads, audiências, páginas e Business Manager. Você fornece um long-lived access_token e o Facebook App ID (FB_API_ID).
- 📊 38 ferramentas
- ✏️ Leitura e escrita
- 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
- 🔑 Login via magic-link (sem senha)
English version · Documentação completa · Skill pra agentes
Instalar em 1 clique
Claude (Web e Desktop)
A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):
Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Meta Ads (Facebook & Instagram) e URL https://api.mcp.ai/p_meta_ads.
Cursor
➕ Instalar Meta Ads (Facebook & Instagram) no Cursor
VS Code (Copilot Chat)
➕ Instalar Meta Ads (Facebook & Instagram) no VS Code
ChatGPT, Manus, OpenClaw e mais 40+ clientes
Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:
https://api.mcp.ai/p_meta_ads
Detalhes por cliente: INSTALL.md.
Exemplos de uso
Liste minhas contas de anúncio do Meta Ads
Quanto gastei hoje no Facebook Ads e qual o ROAS?
Mostre as campanhas ativas e o orçamento diário
38 ferramentas disponíveis
| Tool | Descrição |
|---|---|
meta_ads_list_accounts | 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. |
meta_ads_status | Validate Facebook token, check expiry date, list connected ad accounts and scopes. |
meta_ads_campaigns | List Meta Ads campaigns. Returns: id, name, status, objective, budget, dates. Set include_paused=true to also show paused campaigns. |
meta_ads_today | Today's ad performance dashboard. |
meta_ads_roas | 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). |
meta_ads_ads | List ads with creatives (image, video, copy) and performance insights. |
meta_ads_realtime | Hourly realtime dashboard for today. |
meta_ads_adset_detail | Get detailed ad set info: targeting, budget, schedule, billing, optimization goal, delivery status. |
meta_ads_pages_list | 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, shar… |
meta_ads_pages_insights | 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, shar… |
meta_ads_pages_posts | 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, shar… |
meta_ads_pages_post_insights | 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, shar… |
meta_ads_business_list | Read Facebook Business Manager data. |
meta_ads_business_accounts | Read Facebook Business Manager data. |
meta_ads_business_pages | Read Facebook Business Manager data. |
meta_ads_business_users | Read Facebook Business Manager data. |
meta_ads_business_pixels | Read Facebook Business Manager data. |
meta_ads_media_list_images | List uploaded media in the ad account. |
meta_ads_media_list_videos | List uploaded media in the ad account. |
meta_ads_audience | List Custom Audiences in the ad account. |
meta_ads_campaign_write_create | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_write_update | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_write_pause | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_write_activate | Create, update, pause or activate Meta Ads campaigns. |
meta_ads_campaign_delete | Permanently delete a Meta Ads campaign. |
meta_ads_adset_write_create | Create or update Meta Ads ad sets. |
meta_ads_adset_write_update | Create or update Meta Ads ad sets. |
meta_ads_adset_delete | Permanently delete a Meta Ads ad set. |
meta_ads_creative_write_create_creative | Create ad creatives and ads (final step to launch). |
meta_ads_creative_write_create_ad | Create ad creatives and ads (final step to launch). |
meta_ads_creative_write_update_ad | Create ad creatives and ads (final step to launch). |
meta_ads_creative_delete | Permanently delete a Meta Ads ad. |
meta_ads_media_write_upload_image | Upload images and videos to Meta Ads account. |
meta_ads_media_write_upload_video | Upload images and videos to Meta Ads account. |
meta_ads_media_write_get_upload_command | Upload images and videos to Meta Ads account. |
meta_ads_audience_write_create | Manage Custom Audiences for targeting. |
meta_ads_audience_write_add_users | Manage Custom Audiences for targeting. |
meta_ads_audience_delete | Permanently delete a Custom Audience. |
Detalhe de cada tool: docs/ferramentas.md
Preços
Grátis.
Privacidade & LGPD
- Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
- Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.
Perguntas frequentes
O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.
Posso usar com agente próprio (não Claude/Cursor)?
Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_meta_ads.
Suporte
Licença
MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_meta_ads é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.
Tools it offers (44)
What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.
meta_ads_list_accountsmeta_ads_statusmeta_ads_campaignsmeta_ads_todaymeta_ads_roasmeta_ads_adsmeta_ads_realtimemeta_ads_adset_detailmeta_ads_pages_listmeta_ads_pages_insightsmeta_ads_pages_postsmeta_ads_pages_post_insightsmeta_ads_business_listmeta_ads_business_accountsmeta_ads_business_pagesmeta_ads_business_usersmeta_ads_business_pixelsmeta_ads_media_list_imagesmeta_ads_media_list_videosmeta_ads_audiencemeta_ads_campaign_write_createmeta_ads_campaign_write_updatemeta_ads_campaign_write_pausemeta_ads_campaign_write_activatemeta_ads_campaign_deletemeta_ads_adset_write_createmeta_ads_adset_write_updatemeta_ads_adset_deletemeta_ads_creative_write_create_creativemeta_ads_creative_write_create_ad
Signals
- Last commit
- Aug 2026
Advanced
- Delivery
- meta_ads-mcp MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
- Item type
- mcp-server
- Key
io-github-mcp-dir-meta-ads-mcp- Source
- github.com/mcp-dir/meta_ads-mcp
- Hosted endpoint
https://api.mcp.ai/p_meta_ads
github.com/mcp-dir/meta_ads-mcp