Research & Benchmarks Optimization AI Ads Analytics Why Madgicx? About Us Blog Careers Case Studies Events Glossary Guides Answers Pricing Login Try for Free
MCP docs menu

Facebook Ads MCP Ad Tools

Tools for managing Facebook ads including delivery control and naming.

Tools for reading, starting, and pausing Facebook ads, plus managing ad names. Ads inherit delivery settings from their parent ad set and contain the creative assets shown to users.

get_ad

Retrieve full configuration details for a single Facebook ad, including status, creative, and targeting inherited from its parent ad set.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
ad_id string Facebook Ad ID to retrieve

get_ads

Retrieve configuration details for up to 50 Facebook ads in a single request. More efficient than calling get_ad individually.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
ad_ids number[] List of ad IDs to retrieve (max 50)

list_ads_by_account

List all Facebook ads in an ad account with optional filtering by effective status, date range, and custom conditions.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)

list_ads_by_campaign

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

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
campaign_id string Campaign ID to list ads for

Example

Show me all ads in campaign 120211556789

list_ads_by_adset

List all Facebook ads within a specific ad set. Returns ad configuration data including creative, status, and bidding.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
adset_id string Ad set ID to list ads for

pause_ad

Pause a currently active Facebook ad to stop delivery immediately without deleting it. The ad can be reactivated later.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
object_id string Ad ID to pause

Active Ads Only

Only ads with ACTIVE status can be paused.


start_ad

Activate a paused Facebook ad by setting its delivery status to ACTIVE. The ad resumes serving without changing its creative, budget, or targeting.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Ad ID to activate

Paused Ads Only

Only ads with PAUSED status can be started. The parent campaign and ad set must also be active.


add_text_to_ad_name

Add text to a Facebook ad name by prepending or appending. Does not modify budget, status, targeting, or creatives.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Ad ID to update
text string Text to add (1-100 characters)
position "prefix" | "suffix" Where to add text: "prefix" (beginning) or "suffix" (end). Default: "prefix"
separator string | undefined Separator between added text and original name (max 5 characters, default: " ")

remove_text_from_ad_name

Remove specific text from a Facebook ad name.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Ad ID to update
text string Text to remove (1-100 characters)
position "prefix" | "suffix" | "anywhere" Where to remove text from. Default: "anywhere"
case_sensitive boolean | undefined Whether removal is case-sensitive (default: false)

replace_text_in_ad_name

Replace one substring with another in a Facebook ad name.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Ad ID to update
text_name_from string Text to find and replace (must be non-blank)
text_name_to string Replacement text (must be non-blank)

Example

Replace "v1" with "v2" in ad 120211556789 name
Official Meta Business Partner

Connect your AI assistant to your ad accounts. The 7-day free trial includes both MCPs.

Sign in with your Madgicx login, add the server addresses and ask in plain words. Meta changes wait for your confirmation, and the Google Ads MCP only reads.

Try for Free ($0 Trial)
200,000+ advertisers
$10B+ annual ad spend visibility
4.6 / 5 on G2, from 220+ reviews