Meta Ads

Meta Ads MCP Server for Cloudflare Workers

Available Tools

49 tools available in the Meta Ads MCP server. Each tool can be called by AI assistants to perform specific actions.

metaads_delete_audience

Delete a custom audience.

This permanently deletes the audience.

Args:

audienceId: Audience ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "audienceId"
  ],
  "properties": {
    "audienceId": {
      "type": "string",
      "description": "Audience ID to delete"
    }
  }
}

metaads_list_ad_accounts

List all ad accounts accessible to the authenticated user.

Returns a paginated list of ad accounts with their status, currency, and timezone.

Args:

limit: Number of accounts to return (1-100, default: 25)
after: Pagination cursor for next page
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of ad accounts with id, name, status, currency, timezone, etc.

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of accounts to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

metaads_get_ad_account

Get details for a specific ad account.

Args:

accountId: The ad account ID (with or without 'act_' prefix)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Ad account details including id, name, status, balance, currency, timezone, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID (e.g., \"act_123456789\" or \"123456789"
    }
  }
}

metaads_list_ads

List ads for an ad account.

Returns a paginated list of ads with their status, creative, and ad set.

Args:

accountId: The ad account ID (required)
limit: Number of ads to return (1-100, default: 25)
after: Pagination cursor for next page
adSetId: Filter by ad set ID
effectiveStatus: Filter by effective status (array of statuses)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of ads with id, name, status, creative, ad set, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of ads to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "adSetId": {
      "type": "string",
      "description": "Filter by ad set ID"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "effectiveStatus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by effective status"
    }
  }
}

metaads_get_ad

Get details for a specific ad.

Args:

adId: The ad ID (required)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Ad details including id, name, status, creative, tracking specs, etc.

{
  "type": "object",
  "required": [
    "adId"
  ],
  "properties": {
    "adId": {
      "type": "string",
      "description": "Ad ID"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

metaads_create_ad

Create a new ad.

Creates an ad with a creative linked to an ad set. Ads are created in PAUSED status by default.

Args:

accountId: The ad account ID (required)
adSetId: The ad set ID this ad belongs to (required)
name: Ad name (required)
creative: Creative specification (required) - JSON object with either:
- For new creative: { name: 'Creative Name', object_story_spec: { page_id: '...', link_data: { ... } } }
- For existing creative: { creative_id: 'existing_creative_id' }
status: Initial status (default: PAUSED)

Returns: The created ad with all fields.

{
  "type": "object",
  "required": [
    "accountId",
    "adSetId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Ad name"
    },
    "adSetId": {
      "type": "string",
      "description": "Ad set ID"
    },
    "creative": {
      "type": "object",
      "description": "Creative specification as JSON object"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_update_ad

Update an existing ad.

Update ad settings such as name, status, or creative.

Args:

adId: Ad ID to update (required)
name: New ad name
status: New status (ACTIVE, PAUSED, DELETED, ARCHIVED)
creative: New creative specification

Returns: The updated ad with all fields.

{
  "type": "object",
  "required": [
    "adId"
  ],
  "properties": {
    "adId": {
      "type": "string",
      "description": "Ad ID to update"
    },
    "name": {
      "type": "string",
      "description": "New ad name"
    },
    "creative": {
      "type": "object",
      "description": "New creative specification"
    }
  }
}

metaads_delete_ad

Delete an ad.

This permanently deletes the ad. Use update with status='ARCHIVED' for soft delete.

Args:

adId: Ad ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "adId"
  ],
  "properties": {
    "adId": {
      "type": "string",
      "description": "Ad ID to delete"
    }
  }
}

metaads_list_adsets

List ad sets for an ad account.

Returns a paginated list of ad sets with their targeting, budget, and optimization settings.

Args:

accountId: The ad account ID (required)
limit: Number of ad sets to return (1-100, default: 25)
after: Pagination cursor for next page
campaignId: Filter by campaign ID
effectiveStatus: Filter by effective status (array of statuses)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of ad sets with id, name, status, targeting, budget, optimization, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of ad sets to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "campaignId": {
      "type": "string",
      "description": "Filter by campaign ID"
    },
    "effectiveStatus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by effective status"
    }
  }
}

metaads_get_adset

Get details for a specific ad set.

Args:

adSetId: The ad set ID (required)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Ad set details including id, name, targeting, budget, optimization, schedule, etc.

{
  "type": "object",
  "required": [
    "adSetId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "adSetId": {
      "type": "string",
      "description": "Ad set ID"
    }
  }
}

metaads_upload_image

Upload an ad image.

Uploads an image to the ad account's image library. The returned hash can be used when creating ad creatives.

Args:

accountId: The ad account ID (required)
imageData: Base64 encoded image data (required)
name: Image name

Returns: The uploaded image with hash, url, dimensions, etc.

{
  "type": "object",
  "required": [
    "accountId",
    "imageData"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Image name"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "imageData": {
      "type": "string",
      "description": "Base64 encoded image data"
    }
  }
}

metaads_create_adset

Create a new ad set.

Creates an ad set with targeting, budget, and optimization settings. Ad sets are created in PAUSED status by default.

Args:

accountId: The ad account ID (required)
campaignId: The campaign ID this ad set belongs to (required)
name: Ad set name (required)
billingEvent: What you're charged for (required) - IMPRESSIONS, LINK_CLICKS, etc.
optimizationGoal: What to optimize for (required) - CONVERSIONS, LINK_CLICKS, etc.
targeting: Targeting specification (required) - JSON object with:
- geo_locations: { countries: ['US'], cities: [...] }
- age_min: Minimum age (13-65)
- age_max: Maximum age (13-65)
- genders: [1] for male, [2] for female, [1,2] for all
- interests: [{ id: '123', name: 'Interest' }]
- custom_audiences: [{ id: 'audience_id' }]
- publisher_platforms: ['facebook', 'instagram']
status: Initial status (default: PAUSED)
dailyBudget: Daily budget in cents
lifetimeBudget: Lifetime budget in cents
bidAmount: Bid amount in cents
bidStrategy: Bid strategy
startTime: Start time (ISO 8601)
endTime: End time (ISO 8601)

Returns: The created ad set with all fields.

{
  "type": "object",
  "required": [
    "accountId",
    "campaignId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Ad set name"
    },
    "endTime": {
      "type": "string",
      "description": "End time (ISO 8601)"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "bidAmount": {
      "type": "integer",
      "description": "Bid amount in cents"
    },
    "startTime": {
      "type": "string",
      "description": "Start time (ISO 8601)"
    },
    "targeting": {
      "type": "object",
      "description": "Targeting specification as JSON object"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    },
    "dailyBudget": {
      "type": "integer",
      "description": "Daily budget in cents"
    },
    "lifetimeBudget": {
      "type": "integer",
      "description": "Lifetime budget in cents"
    }
  }
}

metaads_update_adset

Update an existing ad set.

Update ad set settings such as name, status, targeting, budget, or optimization.

Args:

adSetId: Ad set ID to update (required)
name: New ad set name
status: New status (ACTIVE, PAUSED, DELETED, ARCHIVED)
targeting: New targeting specification
dailyBudget: New daily budget in cents
lifetimeBudget: New lifetime budget in cents
bidAmount: New bid amount in cents
bidStrategy: New bid strategy
optimizationGoal: New optimization goal
billingEvent: New billing event
startTime: New start time (ISO 8601)
endTime: New end time (ISO 8601)

Returns: The updated ad set with all fields.

{
  "type": "object",
  "required": [
    "adSetId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New ad set name"
    },
    "adSetId": {
      "type": "string",
      "description": "Ad set ID to update"
    },
    "endTime": {
      "type": "string",
      "description": "New end time (ISO 8601)"
    },
    "bidAmount": {
      "type": "integer",
      "description": "New bid amount in cents"
    },
    "startTime": {
      "type": "string",
      "description": "New start time (ISO 8601)"
    },
    "targeting": {
      "type": "object",
      "description": "New targeting specification"
    },
    "dailyBudget": {
      "type": "integer",
      "description": "New daily budget in cents"
    },
    "lifetimeBudget": {
      "type": "integer",
      "description": "New lifetime budget in cents"
    }
  }
}

metaads_delete_adset

Delete an ad set.

This permanently deletes the ad set. Use update with status='ARCHIVED' for soft delete.

Args:

adSetId: Ad set ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "adSetId"
  ],
  "properties": {
    "adSetId": {
      "type": "string",
      "description": "Ad set ID to delete"
    }
  }
}

metaads_list_audiences

List custom audiences for an ad account.

Returns a paginated list of custom audiences including website, app, and customer list audiences.

Args:

accountId: The ad account ID (required)
limit: Number of audiences to return (1-100, default: 25)
after: Pagination cursor for next page
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of audiences with id, name, subtype, approximate size, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of audiences to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_get_audience

Get details for a specific custom audience.

Args:

audienceId: The audience ID (required)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Audience details including name, subtype, size, data source, delivery status, etc.

{
  "type": "object",
  "required": [
    "audienceId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "audienceId": {
      "type": "string",
      "description": "Audience ID"
    }
  }
}

metaads_create_audience

Create a new custom audience.

Creates a custom audience that can be used for ad targeting.

Subtypes:

CUSTOM: Customer list audience (upload emails, phone numbers, etc.)
WEBSITE: Website visitors (requires pixel)
APP: App users
ENGAGEMENT: People who engaged with your content
LOOKALIKE: Similar to source audience

Args:

accountId: The ad account ID (required)
name: Audience name (required)
subtype: Audience subtype (required)
description: Audience description
customerFileSource: For CUSTOM subtype: 'USER_PROVIDED_ONLY', 'PARTNER_PROVIDED_ONLY', 'BOTH_USER_AND_PARTNER_PROVIDED'
pixelId: For WEBSITE subtype: pixel ID
rule: For WEBSITE subtype: JSON rule for matching visitors
prefill: For WEBSITE subtype: prefill with historical data (true/false)
retentionDays: How long to keep users in audience (1-180 days)
lookalikeSpec: For LOOKALIKE subtype: { origin_audience_id, ratio, country }

Returns: The created audience with all fields.

{
  "type": "object",
  "required": [
    "accountId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Audience name"
    },
    "rule": {
      "type": "string",
      "description": "JSON rule for website audiences"
    },
    "pixelId": {
      "type": "string",
      "description": "Pixel ID for website audiences"
    },
    "prefill": {
      "type": "boolean",
      "description": "Prefill with historical data"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "description": {
      "type": "string",
      "description": "Audience description"
    },
    "retentionDays": {
      "type": "integer",
      "maximum": 180,
      "minimum": 1,
      "description": "Retention days"
    },
    "customerFileSource": {
      "enum": [
        "USER_PROVIDED_ONLY",
        "PARTNER_PROVIDED_ONLY",
        "BOTH_USER_AND_PARTNER_PROVIDED",
        ""
      ],
      "type": "string",
      "description": "Customer file source"
    }
  }
}

metaads_update_audience

Update an existing custom audience.

Args:

audienceId: Audience ID to update (required)
name: New audience name
description: New description
optOutLink: Privacy opt-out link

Returns: The updated audience with all fields.

{
  "type": "object",
  "required": [
    "audienceId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New audience name"
    },
    "audienceId": {
      "type": "string",
      "description": "Audience ID to update"
    },
    "optOutLink": {
      "type": "string",
      "description": "Privacy opt-out link"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

metaads_add_users_to_audience

Add users to a custom audience.

Adds users to a CUSTOM subtype audience using hashed identifiers.

Schema types:

EMAIL, EMAIL_SHA256: Email addresses
PHONE, PHONE_SHA256: Phone numbers
FN: First name
LN: Last name
EXTERN_ID: External ID
MADID: Mobile Advertiser ID

Args:

audienceId: Audience ID (required)
schema: Array of identifier types in order (required)
data: Array of user data arrays matching schema (required)

Example: schema: ['EMAIL_SHA256', 'PHONE_SHA256'] data: [['hashed_email1', 'hashed_phone1'], ['hashed_email2', 'hashed_phone2']]

Returns: Result with audience_id, num_received, num_invalid_entries.

{
  "type": "object",
  "required": [
    "audienceId",
    "schema",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of user data arrays"
    },
    "schema": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of identifier types"
    },
    "audienceId": {
      "type": "string",
      "description": "Audience ID"
    }
  }
}

metaads_remove_users_from_audience

Remove users from a custom audience.

Removes users from a CUSTOM subtype audience.

Args:

audienceId: Audience ID (required)
schema: Array of identifier types in order (required)
data: Array of user data arrays matching schema (required)

Returns: Result with audience_id, num_received, num_invalid_entries.

{
  "type": "object",
  "required": [
    "audienceId",
    "schema",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of user data arrays"
    },
    "schema": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of identifier types"
    },
    "audienceId": {
      "type": "string",
      "description": "Audience ID"
    }
  }
}

metaads_list_businesses

List businesses accessible to the authenticated user.

Returns a paginated list of Business Manager accounts.

Args:

limit: Number of businesses to return (1-100, default: 25)
after: Pagination cursor for next page
format: Response format ('json' or 'markdown')

Returns: List of businesses with id, name, verification_status, etc.

{
  "type": "object",
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of businesses to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

metaads_get_business

Get details for a specific business.

Args:

businessId: The business ID (required)
format: Response format ('json' or 'markdown')

Returns: Business details including name, created_time, verification_status, primary_page, etc.

{
  "type": "object",
  "required": [
    "businessId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "businessId": {
      "type": "string",
      "description": "Business ID"
    }
  }
}

metaads_list_business_ad_accounts

List ad accounts owned by a business.

Returns a paginated list of ad accounts that belong to the specified business.

Args:

businessId: The business ID (required)
limit: Number of ad accounts to return (1-100, default: 25)
after: Pagination cursor for next page
format: Response format ('json' or 'markdown')

Returns: List of ad accounts with id, name, status, currency, etc.

{
  "type": "object",
  "required": [
    "businessId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of ad accounts to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "businessId": {
      "type": "string",
      "description": "Business ID"
    }
  }
}

metaads_list_campaigns

List campaigns for an ad account.

Returns a paginated list of campaigns with their status, objective, and budget.

Args:

accountId: The ad account ID (required)
limit: Number of campaigns to return (1-100, default: 25)
after: Pagination cursor for next page
effectiveStatus: Filter by effective status (array of statuses)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of campaigns with id, name, objective, status, budget, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of campaigns to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "effectiveStatus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by effective status"
    }
  }
}

metaads_get_campaign

Get details for a specific campaign.

Args:

campaignId: The campaign ID (required)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Campaign details including id, name, objective, status, budget, schedule, etc.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

metaads_get_creative

Get details for a specific ad creative.

Args:

creativeId: The creative ID (required)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Creative details including object_story_spec, asset_feed_spec, etc.

{
  "type": "object",
  "required": [
    "creativeId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "creativeId": {
      "type": "string",
      "description": "Creative ID"
    }
  }
}

metaads_create_campaign

Create a new campaign.

Creates a new advertising campaign with the specified objective and settings. Campaigns are created in PAUSED status by default for review before activation.

Args:

accountId: The ad account ID (required)
name: Campaign name (required)
objective: Campaign objective (required) - one of:
- OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES,
- OUTCOME_TRAFFIC, OUTCOME_APP_PROMOTION
status: Initial status (default: PAUSED)
specialAdCategories: Array of special ad categories (default: ['NONE'])
dailyBudget: Daily budget in cents (e.g., 1000 = $10.00)
lifetimeBudget: Lifetime budget in cents
bidStrategy: Bid strategy for the campaign
spendCap: Spend cap in cents
buyingType: 'AUCTION' or 'RESERVED' (default: AUCTION)
startTime: Campaign start time (ISO 8601 format)
stopTime: Campaign stop time (ISO 8601 format)

Returns: The created campaign with all fields.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Campaign name"
    },
    "spendCap": {
      "type": "integer",
      "description": "Spend cap in cents"
    },
    "stopTime": {
      "type": "string",
      "description": "Stop time (ISO 8601)"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "startTime": {
      "type": "string",
      "description": "Start time (ISO 8601)"
    },
    "buyingType": {
      "enum": [
        "AUCTION",
        "RESERVED"
      ],
      "type": "string",
      "description": "Buying type"
    },
    "dailyBudget": {
      "type": "integer",
      "description": "Daily budget in cents"
    },
    "lifetimeBudget": {
      "type": "integer",
      "description": "Lifetime budget in cents"
    },
    "specialAdCategories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Special ad categories"
    }
  }
}

metaads_update_campaign

Update an existing campaign.

Update campaign settings such as name, status, budget, or schedule.

Args:

campaignId: Campaign ID to update (required)
name: New campaign name
status: New status (ACTIVE, PAUSED, DELETED, ARCHIVED)
dailyBudget: New daily budget in cents
lifetimeBudget: New lifetime budget in cents
bidStrategy: New bid strategy
spendCap: New spend cap in cents
startTime: New start time (ISO 8601)
stopTime: New stop time (ISO 8601)

Returns: The updated campaign with all fields.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New campaign name"
    },
    "spendCap": {
      "type": "integer",
      "description": "New spend cap in cents"
    },
    "stopTime": {
      "type": "string",
      "description": "New stop time (ISO 8601)"
    },
    "startTime": {
      "type": "string",
      "description": "New start time (ISO 8601)"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID to update"
    },
    "dailyBudget": {
      "type": "integer",
      "description": "New daily budget in cents"
    },
    "lifetimeBudget": {
      "type": "integer",
      "description": "New lifetime budget in cents"
    }
  }
}

metaads_delete_campaign

Delete a campaign.

This permanently deletes the campaign. Use update with status='ARCHIVED' for soft delete.

Args:

campaignId: Campaign ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID to delete"
    }
  }
}

metaads_list_catalogs

List product catalogs for a business.

Returns a paginated list of product catalogs.

Args:

businessId: The business ID (required)
limit: Number of catalogs to return (1-100, default: 25)
after: Pagination cursor for next page
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of catalogs with id, name, vertical, product_count, etc.

{
  "type": "object",
  "required": [
    "businessId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of catalogs to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "businessId": {
      "type": "string",
      "description": "Business ID"
    }
  }
}

metaads_get_catalog

Get details for a specific product catalog.

Args:

catalogId: The catalog ID (required)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Catalog details including name, vertical, product_count, feed_count, etc.

{
  "type": "object",
  "required": [
    "catalogId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "catalogId": {
      "type": "string",
      "description": "Catalog ID"
    }
  }
}

metaads_list_product_sets

List product sets for a catalog.

Product sets are subsets of products used for dynamic ads targeting.

Args:

catalogId: The catalog ID (required)
limit: Number of product sets to return (1-100, default: 25)
after: Pagination cursor for next page
format: Response format ('json' or 'markdown')

Returns: List of product sets with id, name, product_count, filter, etc.

{
  "type": "object",
  "required": [
    "catalogId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of product sets to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "catalogId": {
      "type": "string",
      "description": "Catalog ID"
    }
  }
}

metaads_list_creatives

List ad creatives for an ad account.

Returns a paginated list of creatives with their specifications.

Args:

accountId: The ad account ID (required)
limit: Number of creatives to return (1-100, default: 25)
after: Pagination cursor for next page
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of creatives with id, name, object_story_spec, status, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of creatives to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_create_creative

Create a new ad creative.

Creates a standalone creative that can be used by multiple ads.

Args:

accountId: The ad account ID (required)
name: Creative name
objectStorySpec: Object story specification (for link/video/photo ads) Example for link ad: { "page_id": "your_page_id", "link_data": { "link": "https://example.com", "message": "Check out our offer!", "name": "Product Name", "description": "Product description", "image_hash": "abc123...", "call_to_action": { "type": "LEARN_MORE", "value": { "link": "https://example.com" } } } }
assetFeedSpec: Asset feed specification (for dynamic creative)
urlTags: URL parameters to append to links
usePageActorOverride: Use page as actor

Returns: The created creative with all fields.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Creative name"
    },
    "urlTags": {
      "type": "string",
      "description": "URL parameters to append"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "assetFeedSpec": {
      "type": "object",
      "description": "Asset feed specification"
    },
    "objectStorySpec": {
      "type": "object",
      "description": "Object story specification"
    },
    "usePageActorOverride": {
      "type": "boolean",
      "description": "Use page as actor"
    }
  }
}

metaads_list_images

List ad images for an ad account.

Returns a paginated list of uploaded images with their hashes and URLs.

Args:

accountId: The ad account ID (required)
limit: Number of images to return (1-100, default: 25)
after: Pagination cursor for next page
hashes: Filter by specific image hashes (array)
format: Response format ('json' or 'markdown')

Returns: List of images with hash, url, dimensions, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of images to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "hashes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by image hashes"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_list_videos

List ad videos for an ad account.

Returns a paginated list of uploaded videos.

Args:

accountId: The ad account ID (required)
limit: Number of videos to return (1-100, default: 25)
after: Pagination cursor for next page
format: Response format ('json' or 'markdown')

Returns: List of videos with id, title, description, thumbnail, status, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of videos to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_get_video

Get details for a specific ad video.

Args:

videoId: The video ID (required)
format: Response format ('json' or 'markdown')

Returns: Video details including title, description, thumbnail, status, length, etc.

{
  "type": "object",
  "required": [
    "videoId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "videoId": {
      "type": "string",
      "description": "Video ID"
    }
  }
}

metaads_get_account_insights

Get insights (performance metrics) for an ad account.

Returns performance data like impressions, clicks, spend, conversions, etc.

Args:

accountId: The ad account ID (required)
datePreset: Date range preset (e.g., 'last_7d', 'last_30d', 'this_month')
timeRange: Custom time range { since: 'YYYY-MM-DD', until: 'YYYY-MM-DD' }
timeIncrement: Break down by time period ('1', '7', '28', 'monthly', 'all_days')
fields: Array of metrics to return
breakdowns: Array of dimensions to break down by (age, gender, country, etc.)
actionBreakdowns: Array of action breakdowns
attributionWindows: Attribution windows (1d_click, 7d_click, etc.)
level: Aggregation level ('account', 'campaign', 'adset', 'ad')
limit: Maximum number of results
format: Response format ('json' or 'markdown')

Returns: Array of insights with requested metrics and breakdowns.

{
  "type": "object",
  "properties": {
    "level": {
      "enum": [
        "account",
        "campaign",
        "adset",
        "ad"
      ],
      "type": "string",
      "description": "Aggregation level"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum results"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Metrics to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "breakdowns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Dimensions to break down by"
    },
    "timeIncrement": {
      "type": "string",
      "description": "Time increment for breakdown"
    },
    "actionBreakdowns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Action breakdowns"
    },
    "attributionWindows": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attribution windows"
    }
  }
}

metaads_get_campaign_insights

Get insights (performance metrics) for a specific campaign.

Args:

campaignId: The campaign ID (required)
datePreset: Date range preset
timeRange: Custom time range { since: 'YYYY-MM-DD', until: 'YYYY-MM-DD' }
timeIncrement: Time increment for breakdown
fields: Array of metrics to return
breakdowns: Array of dimensions to break down by
format: Response format

Returns: Array of insights for the campaign.

{
  "type": "object",
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Metrics to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "breakdowns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Breakdowns"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    },
    "timeIncrement": {
      "type": "string",
      "description": "Time increment"
    }
  }
}

metaads_get_adset_insights

Get insights (performance metrics) for a specific ad set.

Args:

adSetId: The ad set ID (required)
datePreset: Date range preset
timeRange: Custom time range
timeIncrement: Time increment
fields: Array of metrics to return
breakdowns: Array of dimensions to break down by
format: Response format

Returns: Array of insights for the ad set.

{
  "type": "object",
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Metrics to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "adSetId": {
      "type": "string",
      "description": "Ad set ID"
    },
    "breakdowns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Breakdowns"
    },
    "timeIncrement": {
      "type": "string",
      "description": "Time increment"
    }
  }
}

metaads_get_ad_insights

Get insights (performance metrics) for a specific ad.

Args:

adId: The ad ID (required)
datePreset: Date range preset
timeRange: Custom time range
timeIncrement: Time increment
fields: Array of metrics to return
breakdowns: Array of dimensions to break down by
format: Response format

Returns: Array of insights for the ad.

{
  "type": "object",
  "properties": {
    "adId": {
      "type": "string",
      "description": "Ad ID"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Metrics to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "breakdowns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Breakdowns"
    },
    "timeIncrement": {
      "type": "string",
      "description": "Time increment"
    }
  }
}

metaads_list_pixels

List Meta Pixels for an ad account.

Returns a paginated list of pixels with their configuration and status.

Args:

accountId: The ad account ID (required)
limit: Number of pixels to return (1-100, default: 25)
after: Pagination cursor for next page
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: List of pixels with id, name, code, last_fired_time, etc.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "after": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of pixels to return"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_get_pixel

Get details for a specific Meta Pixel.

Args:

pixelId: The pixel ID (required)
fields: Comma-separated list of fields to return
format: Response format ('json' or 'markdown')

Returns: Pixel details including name, code, settings, last_fired_time, owner, etc.

{
  "type": "object",
  "required": [
    "pixelId"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pixelId": {
      "type": "string",
      "description": "Pixel ID"
    }
  }
}

metaads_create_pixel

Create a new Meta Pixel.

Creates a new pixel for tracking website conversions.

Args:

accountId: The ad account ID (required)
name: Pixel name (required)

Returns: The created pixel with id, name, and installation code.

{
  "type": "object",
  "required": [
    "accountId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Pixel name"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_search_targeting

Search for targeting options like interests, behaviors, demographics.

Search for available targeting options that can be used in ad sets.

Types:

adinterest: Search for interests
adinterestsuggestion: Get interest suggestions
adTargetingCategory: Browse targeting categories
adgeolocation: Search for locations
adlocale: Search for languages
adeducationschool: Search for schools
adworkemployer: Search for employers
adworkposition: Search for job titles

Args:

accountId: The ad account ID (required)
type: Type of targeting to search (required)
query: Search query (required)
format: Response format ('json' or 'markdown')

Returns: List of targeting options with id, name, type, and audience size estimates.

{
  "type": "object",
  "required": [
    "accountId",
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_get_targeting_categories

Browse available targeting categories.

Get a list of available targeting categories for a given type.

Args:

accountId: The ad account ID (required)
type: Type of targeting categories (required)
format: Response format ('json' or 'markdown')

Returns: List of targeting categories with id, name, and type.

{
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    }
  }
}

metaads_get_delivery_estimate

Get estimated delivery for a targeting specification.

Estimate the potential reach for a given targeting configuration.

Args:

accountId: The ad account ID (required)
targeting: Targeting specification (required) - JSON object with:
- geo_locations: { countries: ['US'] }
- age_min: Minimum age
- age_max: Maximum age
- genders: [1] male, [2] female
- interests: [{ id: '123', name: 'Interest' }]
- etc.
optimizationGoal: Optimization goal (required) - e.g., 'LINK_CLICKS', 'IMPRESSIONS', 'CONVERSIONS'
format: Response format ('json' or 'markdown')

Returns: Delivery estimate with estimated daily reach, impressions, and audience size.

{
  "type": "object",
  "required": [
    "accountId",
    "targeting",
    "optimizationGoal"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "targeting": {
      "type": "object",
      "description": "Targeting specification"
    },
    "optimizationGoal": {
      "type": "string",
      "description": "Optimization goal"
    }
  }
}

metaads_get_reach_frequency

Get a reach and frequency prediction.

Retrieve an existing reach and frequency prediction.

Args:

accountId: The ad account ID (required)
predictionId: The prediction ID (required)
format: Response format ('json' or 'markdown')

Returns: Reach and frequency prediction with curves and estimates.

{
  "type": "object",
  "required": [
    "accountId",
    "predictionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "predictionId": {
      "type": "string",
      "description": "Prediction ID"
    }
  }
}

metaads_create_reach_frequency

Create a reach and frequency prediction.

Create a new reach and frequency prediction for planning purposes.

Args:

accountId: The ad account ID (required)
targetSpec: Targeting specification (required)
startTime: Campaign start time (required, Unix timestamp)
stopTime: Campaign stop time (required, Unix timestamp)
objective: Campaign objective (required)
reachFrequency: Budget or reach goal (required) - one of:
- { budget: amount_in_cents }
- { reach: number_of_people }
frequencyCap: Maximum frequency cap
format: Response format ('json' or 'markdown')

Returns: Created prediction with reach and frequency curves.

{
  "type": "object",
  "required": [
    "accountId",
    "targetSpec",
    "startTime",
    "stopTime",
    "objective"
  ],
  "properties": {
    "reach": {
      "type": "integer",
      "description": "Target reach"
    },
    "budget": {
      "type": "integer",
      "description": "Budget in cents"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "stopTime": {
      "type": "number",
      "description": "Stop time (Unix timestamp)"
    },
    "accountId": {
      "type": "string",
      "description": "Ad account ID"
    },
    "objective": {
      "type": "string",
      "description": "Campaign objective"
    },
    "startTime": {
      "type": "number",
      "description": "Start time (Unix timestamp)"
    },
    "targetSpec": {
      "type": "object",
      "description": "Targeting specification"
    },
    "frequencyCap": {
      "type": "integer",
      "description": "Frequency cap"
    }
  }
}