API Reference

Meta Ads / API Reference

meta_ads_create_automated_rule

Meta Ads tool. Create a Meta automated rule that monitors and acts on ad performance automatically. Two types: - SCHEDULE_BASED: runs on interval (DAILY/HOURLY/SEMI_HOURLY). Use schedule_spec. - TRIGGER_BASED: real-time reaction to performance changes. Use trigger_spec. NOTE: Trigger-based rules are API-only — not available in Ads Manager UI. Args: name: Rule name (required). rule_type: 'SCHEDULE_BASED' or 'TRIGGER_BASED' (required). evaluation_spec: JSON string — what to evaluate. Example: '{"evaluation_type":"SCHEDULE","filters":[{"field":"entity_type","value":"ADSET"}, {"field":"campaign.delivery_status","value":"Active"}]}' execution_spec: JSON string — what action to take. Example: '{"execution_type":"PAUSE"}' or '{"execution_type":"CHANGE_BUDGET","execution_options":[{"field":"budget","value":10,"action_type":"PERCENTAGE","operator":"MULTIPLY_BY"}]}' account_id: Ad account ID. Leave blank for .env default. schedule_spec: JSON string for schedule-based rules. Example: '{"schedule_type":"DAILY","start_minute":480}' (480=8AM) trigger_spec: JSON string for trigger-based rules. Example: '{"type":"STATS_CHANGE","trigger_filters":[{"field":"cost_per_result","operator":">","value":50}]}'

This is a write tool: it creates automated rule in your Meta Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Create automated rule in my Meta Ads account for [name], [rule type], [evaluation spec].

It takes 4 required and 3 optional parameters.

Parameters

ParameterTypeRequiredDescription
namestringYesName
rule_typestringYesRule Type
evaluation_specstringYesEvaluation Spec
execution_specstringYesExecution Spec
account_idstringNoAccount Id
schedule_specstringNoSchedule Spec
trigger_specstringNoTrigger Spec

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads