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 Campaign Tools

Tools for managing Facebook advertising campaigns.

Tools for reading, starting, and pausing Facebook advertising campaigns, plus managing budgets and campaign names.

get_campaign

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

Parameters

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

Example

Natural Language

Show me the details of campaign 120211556789

Direct Query

{
  "tool": "get_campaign",
  "arguments": {
    "account_id": "act_123456789",
    "campaign_id": "120211556789"
  }
}

get_campaigns

Retrieve configuration details for up to 50 Facebook campaigns in a single request. More efficient than calling get_campaign for each individually.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
campaign_ids number[] List of campaign IDs to retrieve (max 50)
next_page_url string | undefined Pagination URL from a previous response

list_campaigns

List all Facebook campaigns in an ad account with optional filtering by status, objective, or date range.

Parameters

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

Example

Natural Language

Show me all my active campaigns
List campaigns in account act_123456789

Direct Query

{
  "tool": "list_campaigns",
  "arguments": {
    "account_id": "act_123456789"
  }
}

pause_campaign

Pause a currently active Facebook campaign, stopping delivery of all its ad sets and ads simultaneously. Can be reactivated without recreating the campaign structure.

Parameters

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

Active Campaigns Only

Only campaigns with ACTIVE status can be paused.

Example

Natural Language

Pause campaign 120211556789

Direct Query

{
  "tool": "pause_campaign",
  "arguments": {
    "account_id": "act_123456789",
    "object_id": "120211556789"
  }
}

start_campaign

Activate a paused Facebook campaign by setting its delivery status to ACTIVE. Use this to resume delivery without changing the campaign's configuration.

Parameters

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

Paused Campaigns Only

Only campaigns with PAUSED status can be started. May fail if the campaign has billing or policy issues.

Example

Start campaign 120211556789

set_campaign_budget

Set the budget for a Facebook campaign to a specific amount. Used for Campaign Budget Optimization (CBO) campaigns.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Campaign ID to update
amount number New budget amount in account currency (cents)

Example

Set campaign 120211556789 budget to $100/day

increase_campaign_budget

Increase the budget of a Facebook campaign by a specified amount or percentage.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Campaign ID to update
amount number Amount to increase the budget by

Example

Increase campaign 120211556789 budget by $20

decrease_campaign_budget

Decrease the budget of a Facebook campaign by a specified amount or percentage.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Campaign ID to update
amount number Amount to decrease the budget by

Example

Decrease campaign 120211556789 budget by $10

add_text_to_campaign_name

Add text to a Facebook campaign name by prepending or appending.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Campaign 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: " ")

Example

Add "[Q1]" prefix to campaign 120211556789 name

remove_text_from_campaign_name

Remove specific text from a Facebook campaign name.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Campaign 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)

Example

Remove "[OLD]" from campaign 120211556789 name

replace_text_in_campaign_name

Replace one substring with another in a Facebook campaign name.

Parameters

Parameter Type Description
account_id string Facebook Ad Account ID (e.g., act_123456789)
entity_id string Campaign 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 "Summer" with "Winter" in campaign 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