Skip to main content
Glama
mcp-dir

Meta Ads (Facebook & Instagram)

by mcp-dir

Meta Ads (Facebook & Instagram)

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):

➕ Abrir no Claude e conectar

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.


Related MCP server: Meta Marketing API MCP Server

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to manage Facebook and Instagram advertising via the Meta Marketing API. It provides comprehensive tools for campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
    26 npm
    200
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Facebook and Instagram advertising data through the Meta Marketing API. It supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
    991 npm
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    A Model Context Protocol server for the Meta (Facebook) Ads API, providing 54 tools to manage ad accounts, campaigns, ad sets, ads, creatives, media, insights, targeting, and more via the Meta Graph API.
    35
    144 npm
    14
    MIT
  • F
    license
    C
    quality
    D
    maintenance
    Enables managing Facebook ads campaigns, ad sets, ads, creatives, insights, and audience targeting via Meta's Marketing API.
    39
    -