Meta Ads Mcp

Get the authenticated user's identity, team, plan permissions, and Facebook token status. Call this first to verify authentication and get context.

No parameter schema in public metadata yet.

Retrieve full configuration details for a single Facebook campaign by its ID, including objective, status, spending cap, and bid strategy. Use get_by_ids for multiple campaigns.

Retrieve configuration details for up to 50 Facebook campaigns in a single request by their IDs. More efficient than calling get_by_id for each campaign individually.

List all Facebook campaigns in an ad account with optional filtering by status, objective, or date range. Returns campaign-level configuration including objective, buying type, and budget settings.

Pause a currently active Facebook campaign, stopping delivery of all its ad sets and ads simultaneously. Only applicable to campaigns with ACTIVE status. Can be reactivated without recreating the campaign structure.

Activate an existing Facebook campaign by setting its status to ACTIVE. Use this tool when a paused campaign should resume delivery without changing its objective, budget strategy, or structure. Provide the ad account ID and the target entity ID. This is a write operation that...

Set the exact budget value for an existing Facebook campaign in the ad account currency. Use this tool for campaign-level budgets, which are typically used in CBO (Campaign Budget Optimization). Provide account_id, entity_id, the final target budget value, and optionally apply...

Increase the budget of an existing Facebook campaign by a positive delta. This tool does not set a final budget target; it only adds to the current campaign budget. Use it when the user wants to raise budget by a percentage or by a concrete increase amount. The value is interp...

Decrease the budget of an existing Facebook campaign by a positive delta. This tool does not set a final budget target; it only subtracts from the current campaign budget. Use it when the user wants to reduce budget by a percentage or by a concrete decrease amount. The value i...

Add text to a Facebook campaign name. Use this tool when you need to prepend or append text to an existing campaign name, not when you need to remove or replace existing text. Provide account_id, entity_id, text, and optionally position and separator. This tool works only for...

Remove specific text from a Facebook campaign name. Use this tool when you need to delete existing text from the beginning, end, or any position in the name, not when you need to prepend new text or replace one substring with another. Provide account_id, entity_id, text, and o...

Replace one substring with another inside a Facebook campaign name. Use this tool when you need a targeted rename operation, not when you only need to prepend, append, or remove text. Provide account_id, entity_id, text_name_from, and text_name_to. This tool works only for cam...

Retrieve full configuration details for a single Facebook ad set, including audience targeting, daily or lifetime budget, bid strategy, optimization goal, and schedule. Use get_by_ids for multiple ad sets.

Retrieve configuration details for up to 50 Facebook ad sets in a single request by their IDs. More efficient than calling get_by_id for each ad set individually.

List all Facebook ad sets in an ad account with optional filtering by status, date range, or custom conditions. Returns ad set configuration including targeting, budgets, and optimization settings.

List all Facebook ad sets within a specific campaign. Returns targeting, budget, and bidding configuration for each ad set. Use get_insights for performance data instead of configuration.

Pause a currently active Facebook ad set, stopping delivery of all ads within it. Only applicable to ad sets with ACTIVE status. Ads within the ad set are also paused. The ad set can be reactivated later.

Retrieve activity for a specific Facebook ad set. This tool queries the parent ad account activity log and filters it to the requested ad set, so use it to answer questions like what happened to this ad set, when it happened, and who triggered it. Prefer event_time as the true...

Activate an existing Facebook ad set by setting its status to ACTIVE. Use this tool to resume delivery for an ad set that already has its budget, schedule, and targeting configured. Provide the ad account ID and the target entity ID. This is a write operation that updates stat...

Set the exact budget value for an existing Facebook ad set in the ad account currency. Use this tool for ad set-level budgets, which are typically used in ABO (Ad Set Budget Optimization). Provide account_id, entity_id, the final target budget value, and optionally apply_to. T...

Increase the budget of an existing Facebook ad set by a positive delta. This tool does not set a final budget target; it only adds to the current ad set budget. Use it when the user wants to raise budget by a percentage or by a concrete increase amount. The value is interprete...

Decrease the budget of an existing Facebook ad set by a positive delta. This tool does not set a final budget target; it only subtracts from the current ad set budget. Use it when the user wants to reduce budget by a percentage or by a concrete decrease amount. The value is in...

Set an exact bid value for an existing Facebook ad set. Use this tool when you want to set the target bid directly, not adjust it by a delta. Provide account_id, entity_id, value, and optionally apply_to. This tool works only for ad sets. value is the final bid in account curr...

Decrease the bid of an existing Facebook ad set by a positive delta. Use this tool when you want to lower the current bid by a percentage, currency amount, or Facebook bid representation, not when you want to set an exact final bid directly. Provide account_id, entity_id, valu...

Increase the spending limits of an existing Facebook ad set by delta amounts. This tool does not set final target limits; it adds to the current minimum and maximum spending limits. Provide account_id, entity_id, minimum_value, maximum_value, measuring_unit, and optionally app...

Decrease the spending limits of an existing Facebook ad set by delta amounts. This tool does not set final target limits; it subtracts from the current minimum and maximum spending limits. Provide account_id, entity_id, minimum_decrease, maximum_decrease, measuring_unit, and o...

Add text to a Facebook ad set name. Use this tool when you need to prepend or append text to an existing ad set name, not when you need to remove or replace existing text. Provide account_id, entity_id, text, and optionally position and separator. This tool works only for ad s...

Remove specific text from a Facebook ad set name. Use this tool when you need to delete existing text from the beginning, end, or any position in the name, not when you need to prepend new text or replace one substring with another. Provide account_id, entity_id, text, and opt...

Replace one substring with another inside a Facebook ad set name. Use this tool when you need a targeted rename operation, not when you only need to prepend, append, or remove text. Provide account_id, entity_id, text_name_from, and text_name_to. This tool works only for ad se...

Retrieve full configuration details for a single Facebook ad by its ID, including status, creative, bidding, and targeting inherited from its parent ad set. Use get_by_ids to fetch multiple ads at once.

Retrieve configuration details for up to 50 Facebook ads in a single request by their IDs. More efficient than calling get_by_id for each ad individually.

List all Facebook ads belonging to an ad account. Supports filtering by effective status, date range, and custom field conditions. Use get_by_adset or get_by_campaign when you need ads from a specific parent entity.

List all Facebook ads across all ad sets within a specific campaign. Useful for getting a complete view of ads under a campaign without querying each ad set separately.

List all Facebook ads within a specific ad set. Returns ad configuration data including creative, status, and bidding. Use get_insights if you need performance metrics instead of configuration.

Pause a currently active Facebook ad to stop delivery immediately without deleting it. Only applicable to ads with ACTIVE status. The ad can be reactivated later. Use delete only if the ad is no longer needed.

Activate an existing Facebook ad by setting its delivery status to ACTIVE. Use this tool when an ad already exists and should resume serving without changing its creative, budget, or targeting. Provide the ad account ID and the target entity ID. This is a write operation that...

Add text to a Facebook ad name. Use this tool when you need to prepend or append text to an existing ad name, not when you need to remove or replace existing text. Provide account_id, entity_id, text, and optionally position and separator. This tool works only for ads. entity_...

Remove specific text from a Facebook ad name. Use this tool when you need to delete existing text from the beginning, end, or any position in the name, not when you need to prepend new text or replace one substring with another. Provide account_id, entity_id, text, and optiona...

Replace one substring with another inside a Facebook ad name. Use this tool when you need a targeted rename operation, not when you only need to prepend, append, or remove text. Provide account_id, entity_id, text_name_from, and text_name_to. This tool works only for ads. enti...

Retrieve aggregated performance metrics for a Facebook campaign, combining data from all its ad sets and ads. Includes spend, ROAS, reach, impressions, and conversions. Supports time breakdowns and date presets.

Retrieve performance metrics for a specific Facebook ad set, including spend, reach, impressions, and conversions. Aggregates data from all ads within the ad set. Supports breakdowns and date presets.

Retrieve performance metrics for a specific Facebook ad, including spend, impressions, clicks, CTR, CPM, and ROAS. Supports breakdown dimensions (age, gender, placement) and custom date ranges or presets like last_7d.

Retrieve aggregated performance metrics across all campaigns for a Facebook ad account over a specified date range. Supports level parameter (account, campaign, adset, ad) and breakdown dimensions for granular analysis.

List all Facebook ad accounts accessible to the authenticated user. Returns each account's ID, name, status, and currency. Use this tool first to discover available accounts before making account-specific API calls.

Retrieve comprehensive details for a Facebook ad account, including its current status (ACTIVE, DISABLED, etc.), currency, timezone, billing information, spending limits, and business ownership. Useful for account health checks.

Retrieve the Facebook ad account activity log. Use this tool to answer questions like what changed, when it changed, and who performed the action. Prefer event_time as the actual action timestamp. Each activity item may include event_type, translated_event_type, actor_name, ob...

Retrieve full configuration details for a single Facebook ad creative by its ID, including all media assets, text elements, call-to-action, and tracking parameters. Use get_by_ids for multiple creatives.

Retrieve configuration details for up to 50 Facebook ad creatives in a single batch request. Uses Facebook's multi-ID lookup endpoint, which is more efficient than individual requests.

Retrieve the ad creative linked to a specific Facebook ad. Provide account_id and ad_id to fetch the single creative object attached to that ad, including media asset references and copy fields when available.