Serveur MCP

Meta Ads (Facebook & Instagram)

io.github.mcp-dir/meta_ads-mcp
Marketing et publicité Réseaux sociaux Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Reads and manages Meta advertising campaigns, ad sets, ads, creatives, audiences, business accounts, pages, pixels, budgets, targeting, and performance insights.

authenticate
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.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'token': {'type': 'string'}}}
connect
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
marketplace
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/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'default': 10}, 'query': {'type': 'string', 'default': ''}, 'action': {'enum': ['search', 'describe', 'install', 'uninstall', 'subscribe', 'cancel', 'resume', 'report_bug', 'request_mcp', 'list_tools', 'invoke', 'search_prompts', 'get_prompt', 'publish_prompt'], 'type': 'string', 'default': 'search'}, 'mcp_id': {'type': 'string', 'default': ''}, 'message': {'type': 'string', 'default': ''}, 'tool_id': {'type': 'string', 'default': ''}, 'arguments': {'type': 'string', 'default': '{}'}, 'immediate': {'type': 'boolean', 'default': False}, 'tier_slug': {'type': 'string', 'default': ''}, 'prompt_body': {'type': 'string', 'default': ''}, 'prompt_slug': {'type': 'string', 'default': ''}, 'prompt_tool': {'type': 'string', 'default': ''}, 'prompt_vars': {'type': 'string', 'default': '{}'}, 'conversation': {'type': 'string', 'default': '[]'}, 'prompt_title': {'type': 'string', 'default': ''}, 'request_name': {'type': 'string', 'default': ''}, 'cancel_reason': {'enum': ['too_expensive', 'missing_features', 'switched_service', 'unused', 'customer_service', 'too_complex', 'low_quality', 'other'], 'type': 'string'}, 'cancel_comment': {'type': 'string', 'default': ''}, 'prompt_targets': {'type': 'array', 'items': {'enum': ['claude', 'chatgpt', 'cursor', 'lovable'], 'type': 'string'}, 'default': []}, 'report_context': {'type': 'string', 'default': ''}, 'prompt_category': {'type': 'string', 'default': ''}, 'request_details': {'type': 'string', 'default': ''}, 'prompt_description': {'type': 'string', 'default': ''}}}
meta_ads_ads
List ads with creatives (image, video, copy) and performance insights. Includes spend, revenue, ROAS, actions.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'since': {'type': 'string'}, 'until': {'type': 'string'}, 'account': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'include_paused': {'type': 'boolean', 'default': False}}}
meta_ads_adset_delete
Permanently delete a Meta Ads ad set. Irreversible. Bulk support: accepts adset_ids for batched execution.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['adset_id'], 'properties': {'adset_id': {'type': 'string'}, 'adset_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
meta_ads_adset_detail
Get detailed ad set info: targeting, budget, schedule, billing, optimization goal, delivery status. Fills the gap between campaigns and ads.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'include_paused': {'type': 'boolean', 'default': False}}}
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 campaign objective: OUTCOME_TRAFFIC → LINK_CLICKS / LANDING_PAGE_VIEWS / IMPRESSIONS; OUTCOME_AWARENESS → REACH / IMPRESSIONS; OUTCOME_ENGAGEMENT → POST_ENGAGEMENT / THRUPLAY / PAGE_LIKES / CONVERSATIONS; OUTCOME_LEADS → LEAD_GENERATION / QUALITY_LEAD / OFFSITE_CONVERSIONS; OUTCOME_SALES → OFFSITE_CONVERSIONS / VALUE; OUTCOME_APP_PROMOTION → APP_INSTALLS. OFFSITE_CONVERSIONS/VALUE need promoted_object with the pixel: {"pixel_id":"123","custom_event_type":"PURCHASE"}. LEAD_GENERATION needs {"page_id":"123"}. destination_type is only for non-website destinations (MESSENGER, WHATSAPP, PHONE_CALL); omit it for regular website traffic. For destructive delete use meta_ads_adset_delete. [Flattened action: create] Bulk support: accepts adset_ids, campaign_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'adset_id': {'type': 'string'}, 'end_time': {'type': 'string'}, 'adset_ids': {'type': 'array', 'items': {'type': 'string'}}, 'targeting': {'type': 'string'}, 'bid_amount': {'type': 'number'}, 'start_time': {'type': 'string'}, 'campaign_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'bid_strategy': {'enum': ['LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_BID_CAP', 'COST_CAP', 'LOWEST_COST_WITH_MIN_ROAS'], 'type': 'string'}, 'campaign_ids': {'type': 'array', 'items': {'type': 'string'}}, 'daily_budget': {'type': 'number'}, 'billing_event': {'enum': ['IMPRESSIONS', 'LINK_CLICKS', 'POST_ENGAGEMENT', 'THRUPLAY', 'PAGE_LIKES', 'APP_INSTALLS'], 'type': 'string'}, 'lifetime_budget': {'type': 'number'}, 'promoted_object': {'type': 'string'}, 'destination_type': {'enum': ['MESSENGER', 'WHATSAPP', 'PHONE_CALL', 'APP', 'INSTAGRAM_DIRECT', 'ON_AD', 'ON_POST', 'ON_VIDEO', 'ON_PAGE', 'ON_EVENT'], 'type': 'string'}, 'optimization_goal': {'enum': ['LINK_CLICKS', 'LANDING_PAGE_VIEWS', 'IMPRESSIONS', 'REACH', 'POST_ENGAGEMENT', 'THRUPLAY', 'PAGE_LIKES', 'CONVERSATIONS', 'LEAD_GENERATION', 'QUALITY_LEAD', 'OFFSITE_CONVERSIONS', 'VALUE', 'APP_INSTALLS'], 'type': 'string'}}}
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 campaign objective: OUTCOME_TRAFFIC → LINK_CLICKS / LANDING_PAGE_VIEWS / IMPRESSIONS; OUTCOME_AWARENESS → REACH / IMPRESSIONS; OUTCOME_ENGAGEMENT → POST_ENGAGEMENT / THRUPLAY / PAGE_LIKES / CONVERSATIONS; OUTCOME_LEADS → LEAD_GENERATION / QUALITY_LEAD / OFFSITE_CONVERSIONS; OUTCOME_SALES → OFFSITE_CONVERSIONS / VALUE; OUTCOME_APP_PROMOTION → APP_INSTALLS. OFFSITE_CONVERSIONS/VALUE need promoted_object with the pixel: {"pixel_id":"123","custom_event_type":"PURCHASE"}. LEAD_GENERATION needs {"page_id":"123"}. destination_type is only for non-website destinations (MESSENGER, WHATSAPP, PHONE_CALL); omit it for regular website traffic. For destructive delete use meta_ads_adset_delete. [Flattened action: update] Bulk support: accepts adset_ids, campaign_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'adset_id': {'type': 'string'}, 'end_time': {'type': 'string'}, 'adset_ids': {'type': 'array', 'items': {'type': 'string'}}, 'targeting': {'type': 'string'}, 'bid_amount': {'type': 'number'}, 'start_time': {'type': 'string'}, 'campaign_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'bid_strategy': {'enum': ['LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_BID_CAP', 'COST_CAP', 'LOWEST_COST_WITH_MIN_ROAS'], 'type': 'string'}, 'campaign_ids': {'type': 'array', 'items': {'type': 'string'}}, 'daily_budget': {'type': 'number'}, 'billing_event': {'enum': ['IMPRESSIONS', 'LINK_CLICKS', 'POST_ENGAGEMENT', 'THRUPLAY', 'PAGE_LIKES', 'APP_INSTALLS'], 'type': 'string'}, 'lifetime_budget': {'type': 'number'}, 'promoted_object': {'type': 'string'}, 'destination_type': {'enum': ['MESSENGER', 'WHATSAPP', 'PHONE_CALL', 'APP', 'INSTAGRAM_DIRECT', 'ON_AD', 'ON_POST', 'ON_VIDEO', 'ON_PAGE', 'ON_EVENT'], 'type': 'string'}, 'optimization_goal': {'enum': ['LINK_CLICKS', 'LANDING_PAGE_VIEWS', 'IMPRESSIONS', 'REACH', 'POST_ENGAGEMENT', 'THRUPLAY', 'PAGE_LIKES', 'CONVERSATIONS', 'LEAD_GENERATION', 'QUALITY_LEAD', 'OFFSITE_CONVERSIONS', 'VALUE', 'APP_INSTALLS'], 'type': 'string'}}}
meta_ads_audience
List Custom Audiences in the ad account.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
meta_ads_audience_delete
Permanently delete a Custom Audience. Irreversible. Bulk support: accepts audience_ids for batched execution.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['audience_id'], 'properties': {'audience_id': {'type': 'string'}, 'audience_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
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.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'users': {'type': 'array', 'items': {'type': 'object', 'properties': {'fn': {'type': 'string'}, 'ln': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}}}}, 'account': {'type': 'string'}, 'audience_id': {'type': 'string'}, 'description': {'type': 'string'}, 'audience_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
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.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'users': {'type': 'array', 'items': {'type': 'object', 'properties': {'fn': {'type': 'string'}, 'ln': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}}}}, 'account': {'type': 'string'}, 'audience_id': {'type': 'string'}, 'description': {'type': 'string'}, 'audience_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
meta_ads_business_accounts
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'business_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'business_ids': {'type': 'array', 'items': {'type': 'string'}}}}
meta_ads_business_list
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'business_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'business_ids': {'type': 'array', 'items': {'type': 'string'}}}}
meta_ads_business_pages
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'business_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'business_ids': {'type': 'array', 'items': {'type': 'string'}}}}
meta_ads_business_pixels
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'business_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'business_ids': {'type': 'array', 'items': {'type': 'string'}}}}
meta_ads_business_users
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'business_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'business_ids': {'type': 'array', 'items': {'type': 'string'}}}}
meta_ads_campaign_delete
Permanently delete a Meta Ads campaign. Irreversible. Bulk support: accepts campaign_ids for batched execution.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'campaign_ids': {'type': 'array', 'items': {'type': 'string'}}}}
meta_ads_campaigns
List Meta Ads campaigns. Returns: id, name, status, objective, budget, dates. Set include_paused=true to also show paused campaigns.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'include_paused': {'type': 'boolean', 'default': False}}}
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 delete use meta_ads_campaign_delete. [Flattened action: activate] Bulk support: accepts campaign_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'objective': {'enum': ['OUTCOME_TRAFFIC', 'OUTCOME_ENGAGEMENT', 'OUTCOME_LEADS', 'OUTCOME_SALES', 'OUTCOME_AWARENESS', 'OUTCOME_APP_PROMOTION'], 'type': 'string'}, 'campaign_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'bid_strategy': {'enum': ['LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_BID_CAP', 'COST_CAP', 'LOWEST_COST_WITH_MIN_ROAS'], 'type': 'string'}, 'campaign_ids': {'type': 'array', 'items': {'type': 'string'}}, 'daily_budget': {'type': 'number'}, 'lifetime_budget': {'type': 'number'}, 'special_ad_categories': {'type': 'array', 'items': {'type': 'string'}}}}
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 delete use meta_ads_campaign_delete. [Flattened action: create] Bulk support: accepts campaign_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'objective': {'enum': ['OUTCOME_TRAFFIC', 'OUTCOME_ENGAGEMENT', 'OUTCOME_LEADS', 'OUTCOME_SALES', 'OUTCOME_AWARENESS', 'OUTCOME_APP_PROMOTION'], 'type': 'string'}, 'campaign_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'bid_strategy': {'enum': ['LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_BID_CAP', 'COST_CAP', 'LOWEST_COST_WITH_MIN_ROAS'], 'type': 'string'}, 'campaign_ids': {'type': 'array', 'items': {'type': 'string'}}, 'daily_budget': {'type': 'number'}, 'lifetime_budget': {'type': 'number'}, 'special_ad_categories': {'type': 'array', 'items': {'type': 'string'}}}}
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 delete use meta_ads_campaign_delete. [Flattened action: pause] Bulk support: accepts campaign_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'objective': {'enum': ['OUTCOME_TRAFFIC', 'OUTCOME_ENGAGEMENT', 'OUTCOME_LEADS', 'OUTCOME_SALES', 'OUTCOME_AWARENESS', 'OUTCOME_APP_PROMOTION'], 'type': 'string'}, 'campaign_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'bid_strategy': {'enum': ['LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_BID_CAP', 'COST_CAP', 'LOWEST_COST_WITH_MIN_ROAS'], 'type': 'string'}, 'campaign_ids': {'type': 'array', 'items': {'type': 'string'}}, 'daily_budget': {'type': 'number'}, 'lifetime_budget': {'type': 'number'}, 'special_ad_categories': {'type': 'array', 'items': {'type': 'string'}}}}
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 delete use meta_ads_campaign_delete. [Flattened action: update] Bulk support: accepts campaign_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string'}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'objective': {'enum': ['OUTCOME_TRAFFIC', 'OUTCOME_ENGAGEMENT', 'OUTCOME_LEADS', 'OUTCOME_SALES', 'OUTCOME_AWARENESS', 'OUTCOME_APP_PROMOTION'], 'type': 'string'}, 'campaign_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'bid_strategy': {'enum': ['LOWEST_COST_WITHOUT_CAP', 'LOWEST_COST_WITH_BID_CAP', 'COST_CAP', 'LOWEST_COST_WITH_MIN_ROAS'], 'type': 'string'}, 'campaign_ids': {'type': 'array', 'items': {'type': 'string'}}, 'daily_budget': {'type': 'number'}, 'lifetime_budget': {'type': 'number'}, 'special_ad_categories': {'type': 'array', 'items': {'type': 'string'}}}}
meta_ads_creative_delete
Permanently delete a Meta Ads ad. Irreversible. Bulk support: accepts ad_ids for batched execution.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ad_id'], 'properties': {'ad_id': {'type': 'string'}, 'ad_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
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_ids, video_ids, adset_ids, creative_ids, ad_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'link': {'type': 'string'}, 'name': {'type': 'string'}, 'ad_id': {'type': 'string'}, 'ad_ids': {'type': 'array', 'items': {'type': 'string'}}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'message': {'type': 'string'}, 'page_id': {'type': 'string'}, 'adset_id': {'type': 'string'}, 'page_ids': {'type': 'array', 'items': {'type': 'string'}}, 'video_id': {'type': 'string'}, 'adset_ids': {'type': 'array', 'items': {'type': 'string'}}, 'video_ids': {'type': 'array', 'items': {'type': 'string'}}, 'image_hash': {'type': 'string'}, 'creative_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'creative_ids': {'type': 'array', 'items': {'type': 'string'}}, 'call_to_action_type': {'type': 'string'}}}
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 page_ids, video_ids, adset_ids, creative_ids, ad_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'link': {'type': 'string'}, 'name': {'type': 'string'}, 'ad_id': {'type': 'string'}, 'ad_ids': {'type': 'array', 'items': {'type': 'string'}}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'message': {'type': 'string'}, 'page_id': {'type': 'string'}, 'adset_id': {'type': 'string'}, 'page_ids': {'type': 'array', 'items': {'type': 'string'}}, 'video_id': {'type': 'string'}, 'adset_ids': {'type': 'array', 'items': {'type': 'string'}}, 'video_ids': {'type': 'array', 'items': {'type': 'string'}}, 'image_hash': {'type': 'string'}, 'creative_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'creative_ids': {'type': 'array', 'items': {'type': 'string'}}, 'call_to_action_type': {'type': 'string'}}}
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_ids, video_ids, adset_ids, creative_ids, ad_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'link': {'type': 'string'}, 'name': {'type': 'string'}, 'ad_id': {'type': 'string'}, 'ad_ids': {'type': 'array', 'items': {'type': 'string'}}, 'status': {'enum': ['ACTIVE', 'PAUSED'], 'type': 'string'}, 'account': {'type': 'string'}, 'message': {'type': 'string'}, 'page_id': {'type': 'string'}, 'adset_id': {'type': 'string'}, 'page_ids': {'type': 'array', 'items': {'type': 'string'}}, 'video_id': {'type': 'string'}, 'adset_ids': {'type': 'array', 'items': {'type': 'string'}}, 'video_ids': {'type': 'array', 'items': {'type': 'string'}}, 'image_hash': {'type': 'string'}, 'creative_id': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'creative_ids': {'type': 'array', 'items': {'type': 'string'}}, 'call_to_action_type': {'type': 'string'}}}
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. Use the ad_account_id in `account` on the other tools.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'auth_account': {'type': 'string'}}}
meta_ads_media_list_images
List uploaded media in the ad account. Actions: list_images, list_videos. [Flattened action: list_images]
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
meta_ads_media_list_videos
List uploaded media in the ad account. Actions: list_images, list_videos. [Flattened action: list_videos]
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
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 file on the user's machine. Facebook CDN links (*.fbcdn.net) are signed, expiring and pinned to the browser that opened them — they do NOT work as image_url from the server; upload the file instead. For listing already-uploaded media use meta_ads_media. [Flattened action: get_upload_command] Bulk support: accepts upload_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'title': {'type': 'string'}, 'account': {'type': 'string'}, 'file_url': {'type': 'string'}, 'file_name': {'type': 'string'}, 'file_path': {'type': 'string'}, 'image_url': {'type': 'string'}, 'upload_id': {'type': 'string'}, 'video_url': {'type': 'string'}, 'upload_ids': {'type': 'array', 'items': {'type': 'string'}}, 'file_base64': {'type': 'string'}, 'upload_code': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
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 file on the user's machine. Facebook CDN links (*.fbcdn.net) are signed, expiring and pinned to the browser that opened them — they do NOT work as image_url from the server; upload the file instead. For listing already-uploaded media use meta_ads_media. [Flattened action: upload_image] Bulk support: accepts upload_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'title': {'type': 'string'}, 'account': {'type': 'string'}, 'file_url': {'type': 'string'}, 'file_name': {'type': 'string'}, 'file_path': {'type': 'string'}, 'image_url': {'type': 'string'}, 'upload_id': {'type': 'string'}, 'video_url': {'type': 'string'}, 'upload_ids': {'type': 'array', 'items': {'type': 'string'}}, 'file_base64': {'type': 'string'}, 'upload_code': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
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 file on the user's machine. Facebook CDN links (*.fbcdn.net) are signed, expiring and pinned to the browser that opened them — they do NOT work as image_url from the server; upload the file instead. For listing already-uploaded media use meta_ads_media. [Flattened action: upload_video] Bulk support: accepts upload_ids for batched execution.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'title': {'type': 'string'}, 'account': {'type': 'string'}, 'file_url': {'type': 'string'}, 'file_name': {'type': 'string'}, 'file_path': {'type': 'string'}, 'image_url': {'type': 'string'}, 'upload_id': {'type': 'string'}, 'video_url': {'type': 'string'}, 'upload_ids': {'type': 'array', 'items': {'type': 'string'}}, 'file_base64': {'type': 'string'}, 'upload_code': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
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, shares post_insights — detailed insights for a specific post [Flattened action: insights] Bulk support: accepts page_ids, post_ids for batched execution.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'period': {'enum': ['day', 'week', 'days_28'], 'type': 'string', 'default': 'day'}, 'page_id': {'type': 'string'}, 'post_id': {'type': 'string'}, 'page_ids': {'type': 'array', 'items': {'type': 'string'}}, 'post_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
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, shares post_insights — detailed insights for a specific post [Flattened action: list] Bulk support: accepts page_ids, post_ids for batched execution.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'period': {'enum': ['day', 'week', 'days_28'], 'type': 'string', 'default': 'day'}, 'page_id': {'type': 'string'}, 'post_id': {'type': 'string'}, 'page_ids': {'type': 'array', 'items': {'type': 'string'}}, 'post_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
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, shares post_insights — detailed insights for a specific post [Flattened action: post_insights] Bulk support: accepts page_ids, post_ids for batched execution.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'period': {'enum': ['day', 'week', 'days_28'], 'type': 'string', 'default': 'day'}, 'page_id': {'type': 'string'}, 'post_id': {'type': 'string'}, 'page_ids': {'type': 'array', 'items': {'type': 'string'}}, 'post_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
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, shares post_insights — detailed insights for a specific post [Flattened action: posts] Bulk support: accepts page_ids, post_ids for batched execution.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'period': {'enum': ['day', 'week', 'days_28'], 'type': 'string', 'default': 'day'}, 'page_id': {'type': 'string'}, 'post_id': {'type': 'string'}, 'page_ids': {'type': 'array', 'items': {'type': 'string'}}, 'post_ids': {'type': 'array', 'items': {'type': 'string'}}, 'auth_account': {'type': 'string'}}}
meta_ads_realtime
Hourly realtime dashboard for today. Shows per-ad breakdown with hourly stats, campaign/adset/creative details, plus _summary.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
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). 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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'level': {'enum': ['ad', 'adset', 'campaign', 'account'], 'type': 'string', 'default': 'ad'}, 'since': {'type': 'string'}, 'until': {'type': 'string'}, 'account': {'type': 'string'}, 'auth_account': {'type': 'string'}}}
meta_ads_status
Validate Facebook token, check expiry date, list connected ad accounts and scopes.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'auth_account': {'type': 'string'}}}
meta_ads_today
Today's ad performance dashboard. Returns per-ad: spend, revenue, ROAS, CPA, impressions, clicks, CTR. Plus _summary aggregate across all ads.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'account': {'type': 'string'}, 'auth_account': {'type': 'string'}, 'include_zero': {'type': 'boolean', 'default': False}}}
report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message'], 'properties': {'context': {'type': 'string', 'default': ''}, 'message': {'type': 'string'}, 'conversation': {'type': 'string', 'default': '[]'}}}
show_version
Show the current MCP platform and adapter versions.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ajouté
authenticate
17 September 2026 12:44
Ajouté
marketplace
17 September 2026 12:44
Ajouté
toolkit_info
17 September 2026 12:44
Ajouté
connect
17 September 2026 12:44
Ajouté
report_bug
17 September 2026 12:44
Ajouté
show_version
17 September 2026 12:44
Ajouté
meta_ads_audience_delete
17 September 2026 12:44
Ajouté
meta_ads_audience_write_add_users
17 September 2026 12:44
Ajouté
meta_ads_audience_write_create
17 September 2026 12:44
Ajouté
meta_ads_media_write_get_upload_command
17 September 2026 12:44
Ajouté
meta_ads_media_write_upload_video
17 September 2026 12:44
Ajouté
meta_ads_media_write_upload_image
17 September 2026 12:44
Ajouté
meta_ads_creative_delete
17 September 2026 12:44
Ajouté
meta_ads_creative_write_update_ad
17 September 2026 12:44
Ajouté
meta_ads_creative_write_create_ad
17 September 2026 12:44
Ajouté
meta_ads_creative_write_create_creative
17 September 2026 12:44
Ajouté
meta_ads_adset_delete
17 September 2026 12:44
Ajouté
meta_ads_adset_write_update
17 September 2026 12:44
Ajouté
meta_ads_adset_write_create
17 September 2026 12:44
Ajouté
meta_ads_campaign_delete
17 September 2026 12:44
Ajouté
meta_ads_campaign_write_activate
17 September 2026 12:44
Ajouté
meta_ads_campaign_write_pause
17 September 2026 12:44
Ajouté
meta_ads_campaign_write_update
17 September 2026 12:44
Ajouté
meta_ads_campaign_write_create
17 September 2026 12:44
Ajouté
meta_ads_audience
17 September 2026 12:44
Ajouté
meta_ads_media_list_videos
17 September 2026 12:44
Ajouté
meta_ads_media_list_images
17 September 2026 12:44
Ajouté
meta_ads_business_pixels
17 September 2026 12:44
Ajouté
meta_ads_business_users
17 September 2026 12:44
Ajouté
meta_ads_business_pages
17 September 2026 12:44