# Meta Ads (Facebook & Instagram) — MCP server on mcp.ai
> 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).

By: mcp.ai · official
Page: https://mcp.ai/meta_ads

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_meta_ads?ms=1788961500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/meta_ads/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/meta_ads/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/meta_ads/skill.md
Postman collection (v2.1): https://mcp.ai/meta_ads/postman.json

## Tools
- meta_ads_list_accounts(auth_account?: string) — Listar conexões Meta (logins) + ad accounts dentro de cada uma
- meta_ads_status(auth_account?: string) — Validar token, expiry, ad accounts conectados e scopes
- meta_ads_campaigns(auth_account?: string, account?: string, include_paused?: boolean) — Listar campanhas: id, nome, status, objective, orçamento, datas
- meta_ads_campaign_write(auth_account?: string, account?: string, action: string, campaign_id?: string, name?: string, objective?: string, daily_budget?: number, lifetime_budget?: number, bid_strategy?: string, status?: string, special_ad_categories?: string[]) — Criar, atualizar, pausar ou ativar campanhas. Orçamentos em centavos.
- meta_ads_campaign_delete(auth_account?: string, campaign_id: string) — Deletar campanha (irreversível)
- meta_ads_adset_detail(auth_account?: string, account?: string, include_paused?: boolean) — Detalhes de ad sets: targeting, orçamento, schedule, billing, optimization
- meta_ads_adset_write(auth_account?: string, account?: string, action: string, adset_id?: string, campaign_id?: string, name?: string, daily_budget?: number, lifetime_budget?: number, billing_event?: string, optimization_goal?: string, targeting?: string, destination_type?: string, promoted_object?: string, bid_amount?: number, bid_strategy?: string, start_time?: string, end_time?: string, status?: string) — Criar ou atualizar ad sets. targeting como JSON string.
- meta_ads_adset_delete(auth_account?: string, adset_id: string) — Deletar ad set (irreversível)
- meta_ads_ads(auth_account?: string, account?: string, include_paused?: boolean, since?: string, until?: string) — Listar ads com creatives e insights (spend, revenue, ROAS, actions)
- meta_ads_today(auth_account?: string, account?: string, include_zero?: boolean) — Dashboard de hoje por ad: spend, revenue, ROAS, CPA, impressões, clicks, CTR + _summary
- meta_ads_realtime(auth_account?: string, account?: string) — Realtime hourly de hoje por ad + _summary
- meta_ads_roas(auth_account?: string, account?: string, since?: string, until?: string, level?: string) — ROAS por período via /insights (inclui ads em qualquer status). Default level=ad.
- meta_ads_creative_write(auth_account?: string, account?: string, action: string, name?: string, page_id?: string, message?: string, link?: string, image_hash?: string, video_id?: string, call_to_action_type?: string, adset_id?: string, creative_id?: string, ad_id?: string, status?: string) — Criar creative, criar ad ou atualizar ad
- meta_ads_creative_delete(auth_account?: string, ad_id: string) — Deletar ad (irreversível)
- meta_ads_pages(auth_account?: string, action: string, page_id?: string, post_id?: string, period?: string) — Pages: list / insights / posts / post_insights
- meta_ads_business(auth_account?: string, action: string, business_id?: string) — Business Manager: list / accounts / pages / users / pixels
- meta_ads_media(auth_account?: string, account?: string, action: string) — Listar imagens ou vídeos enviados
- meta_ads_media_write(auth_account?: string, account?: string, action: string, image_url?: string, file_url?: string, upload_id?: string, file_base64?: string, file_name?: string, video_url?: string, title?: string, file_path?: string) — Upload de imagens/vídeos ou curl command para vídeos grandes locais
- meta_ads_audience(auth_account?: string, account?: string) — Listar Custom Audiences
- meta_ads_audience_write(auth_account?: string, account?: string, action: string, audience_id?: string, name?: string, description?: string, users?: object[]) — Criar audience ou adicionar usuários (PII SHA-256 hashed automaticamente)
- meta_ads_audience_delete(auth_account?: string, audience_id: string) — Deletar Custom Audience (irreversível)

## Example prompts
- "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"

## Links
Docs: https://mcp.ai/docs/mcps/meta_ads
Website: https://mcp.ai/mcps/meta_ads