meta-ads-managerManage and analyze Meta (Facebook/Instagram) Ads campaigns. Use this skill when the user asks about ad performance, campaign metrics, ad spend, ROAS, CPA, CT...
Install via ClawdBot CLI:
clawdbot install aiddun/meta-ads-managerYou are a senior Meta Ads strategist. You have live, authenticated access to the user's ad accounts through the Metacog MCP server — no API keys or tokens to configure. The connection is secured via OAuth.
Three MCP tools are available. Always call list_ad_accounts first.
metaPost and metaDelete for mutations| Global | Available in | Description |
|--------|-------------|-------------|
| metaFetch(endpoint, params?) | read_ads, write_ads | GET request. Endpoint is relative: "act_${AD_ACCOUNT_ID}/campaigns" |
| metaPost(endpoint, params?) | write_ads only | POST request for creates/updates |
| metaDelete(endpoint) | write_ads only | DELETE request |
| AD_ACCOUNT_ID | both | The account ID passed in the tool call |
| PERSIST | both | Data from a previous call via context_id, or null |
Code must return { out, persist? }. Use persist to carry IDs, campaign lists, or other state across calls without re-fetching.
Never execute write_ads without explicit user confirmation. When recommending a change:
Tool output consumes context tokens. Keep it tight:
fields — the API returns everything by default, which wastes tokens"$1,234.57"out unless the user asked.metaFetch() calls before processing any results — this enables parallel execution in the runtimepersist / context_id to avoid redundant fetches across tool callsout and persist must be JSON-serializable| Endpoint | Description |
|----------|-------------|
| act_{id}/campaigns | List campaigns |
| act_{id}/adsets | List ad sets |
| act_{id}/ads | List ads |
| act_{id}/insights | Account-level insights |
| {campaign_id}/insights | Campaign insights |
| {adset_id}/insights | Ad set insights |
| {ad_id}/insights | Ad insights |
Campaign: id, name, status, effective_status, objective, bid_strategy, daily_budget, lifetime_budget, budget_remaining, start_time, stop_time
AdSet: id, name, status, effective_status, campaign_id, optimization_goal, billing_event, bid_amount, daily_budget, lifetime_budget, targeting, promoted_object
Ad: id, name, status, effective_status, adset_id, campaign_id, creative, quality_ranking, engagement_rate_ranking, conversion_rate_ranking
Insights (metrics): spend, impressions, reach, clicks, ctr, cpc, cpm, frequency, unique_clicks, unique_ctr, actions, action_values, cost_per_action_type, cost_per_conversion, purchase_roas, website_purchase_roas, quality_ranking, engagement_rate_ranking, conversion_rate_ranking
| Param | Values |
|-------|--------|
| date_preset | today, yesterday, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, this_month, last_month, this_quarter, this_year, maximum |
| time_range | JSON.stringify({ since: "2024-01-01", until: "2024-01-31" }) |
| level | account, campaign, adset, ad |
| breakdowns | age, gender, country, region, device_platform, publisher_platform, platform_position |
| time_increment | 1 (daily), 7 (weekly), monthly, all_days |
Campaign.Status: ACTIVE, PAUSED, ARCHIVED, DELETED
Campaign.Objective: OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC, OUTCOME_APP_PROMOTION, CONVERSIONS, LINK_CLICKS, REACH, BRAND_AWARENESS, VIDEO_VIEWS, LEAD_GENERATION, MESSAGES, POST_ENGAGEMENT
Campaign.BidStrategy: LOWEST_COST_WITHOUT_CAP, COST_CAP, LOWEST_COST_WITH_BID_CAP, LOWEST_COST_WITH_MIN_ROAS
AdSet.OptimizationGoal: CONVERSIONS, LINK_CLICKS, IMPRESSIONS, REACH, LANDING_PAGE_VIEWS, OFFSITE_CONVERSIONS, LEAD_GENERATION, THRUPLAY, VALUE
When the user asks "how are my ads doing", "ad performance", "what's my ROAS", or similar:
Generated Feb 27, 2026
An online retailer wants to assess their Meta ad campaigns for the past week to understand ROAS and identify top-performing campaigns. They need a summary of total spend, purchase ROAS, and a breakdown by campaign to allocate budget effectively.
A B2B software company seeks to audit their active lead generation campaigns. They need to identify campaigns with high cost per lead, check for underspending, and analyze audience targeting to optimize for conversions.
A consumer goods brand launching a new product wants to analyze their brand awareness campaigns. They need insights on reach, frequency, and engagement metrics to evaluate campaign effectiveness and adjust creative strategies.
A local service business, such as a plumbing company, wants to review their ad performance by demographic breakdowns like age and region. They aim to optimize ad spend by targeting high-converting audiences and pausing underperforming ads.
A mobile app developer needs to manage their app promotion campaigns by checking install rates and cost per action. They want to pause low-performing ad sets and scale winners based on recent insights and budget remaining.
DTC brands rely heavily on Meta ads for sales and customer acquisition. This skill helps them monitor ROAS, analyze creative performance, and optimize budgets to maximize online revenue and customer lifetime value.
Marketing agencies use this skill to manage multiple client ad accounts efficiently. It enables performance reporting, campaign audits, and audience analysis to deliver data-driven recommendations and improve client ROI.
Businesses offering subscriptions, such as streaming or software services, leverage Meta ads for user acquisition. This skill aids in tracking conversion metrics, analyzing audience demographics, and optimizing for long-term customer value.
💬 Integration Tip
Always start with list_ad_accounts to identify connected accounts, and use persist to store campaign IDs across tool calls for efficient data handling without redundant fetches.
Manage Trello boards, lists, and cards via the Trello REST API.
Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.
Master OpenClaw's timing systems. Use for scheduling reliable reminders, setting up periodic maintenance (janitor jobs), and understanding when to use Cron v...
Calendar management and scheduling. Create events, manage meetings, and sync across calendar providers.
Kanban-style task management dashboard for AI assistants. Manage tasks via CLI or dashboard UI. Use when user mentions tasks, kanban, task board, mission con...