Server definition
- Hash
- sha256:b70df018735d3e2e46e63f359755e3a750f3aadbb335c26cb9d91cc3369c1cf4
- What it is
- What a remote MCP server returned when asked what it offers: 28 tools
The blob, as servednamed by its sha256
{
"instructions": "You are Adbloop's Meta Ads assistant. Your users are marketers and business owners, not engineers — be warm, encouraging, plain-spoken, and concise. NEVER expose internal mechanics in your replies: no field names, snake_case, JSON schemas, 'the validator dropped X', or tool-probing narration — handle all of that silently and only tell the user things that matter to them in plain language. Before creating campaigns or anything that spends money, briefly restate the key choices (account/page, objective, budget, paused or live) in one short line and proceed. If a tool returns a blocker or missing data, explain it kindly in one or two sentences and offer the fix or ask one simple question. If the user repeats a question, just re-run the relevant tool and answer freshly — do NOT lecture, scold, or point out that they asked before. When something goes wrong, take ownership briefly and move to the solution. Default to reassurance, clarity, and being genuinely helpful.",
"tools": [
{
"description": "Add a NEW ad (with creative) to an EXISTING ad set. Created PAUSED. Accepts either an existing creative_id, a library image_hash (this is where saved library creatives CAN be used), or ad copy fields. WRITES live.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ad_name": {
"type": "string"
},
"adset_id": {
"type": "string"
},
"creative_id": {
"description": "Use an existing Meta creative as-is.",
"type": "string"
},
"cta": {
"description": "e.g. LEARN_MORE",
"type": "string"
},
"description": {
"type": "string"
},
"headline": {
"type": "string"
},
"image_hash": {
"description": "Use a saved library creative's image_hash — supported here (unlike bulk-create).",
"type": "string"
},
"meta_account_id": {
"type": "string"
},
"page_id": {
"type": "string"
},
"primary_text": {
"type": "string"
},
"website_url": {
"type": "string"
}
},
"required": [
"adset_id"
],
"type": "object"
},
"name": "add_ad_to_adset",
"outputSchema": null
},
{
"description": "Create many Meta campaigns at once on ONE account (rate-limit-safe, validated). WRITES live. Honors plan limits, spend guardrails, and capacity. Auto-uses the correct Page/Instagram/pixel. Each campaign needs an imageUrl (public image, or Drive/Dropbox share link).",
"inputSchema": {
"additionalProperties": true,
"properties": {
"campaigns": {
"description": "The campaigns to create; each item's fields are defined in the campaign schema. campaignName and objective are required per campaign; image ads need an imageUrl.",
"items": {
"additionalProperties": true,
"properties": {
"campaignName": {
"description": "Campaign name (shows in Ads Manager).",
"type": "string"
},
"cboBudget": {
"description": "Daily CBO budget in the account's currency, MAJOR units (e.g. 500 = ₹500). Used when useCBO is true.",
"type": "number"
},
"conversionLocation": {
"description": "e.g. website.",
"type": "string"
},
"ctaButton": {
"description": "Call-to-action, e.g. LEARN_MORE, SHOP_NOW, SIGN_UP.",
"type": "string"
},
"dailyBudget": {
"description": "Daily ad-set budget in MAJOR units, used when useCBO is false.",
"type": "number"
},
"headline": {
"description": "Ad headline.",
"type": "string"
},
"imageUrl": {
"description": "REQUIRED for image ads. A publicly-downloadable image URL. SUPPORTED: direct https image URLs, Google Drive share links, and Dropbox share links (file must be shared 'Anyone with the link can view') — these are auto-converted. NOT supported: OneDrive/SharePoint/Box links (unreliable), library image_hash values, or Meta fbcdn/permalink URLs (download fails).",
"type": "string"
},
"objective": {
"description": "e.g. OUTCOME_TRAFFIC, OUTCOME_LEADS, OUTCOME_SALES.",
"enum": [
"OUTCOME_TRAFFIC",
"OUTCOME_SALES",
"OUTCOME_LEADS",
"OUTCOME_ENGAGEMENT",
"OUTCOME_AWARENESS",
"OUTCOME_APP_PROMOTION"
],
"type": "string"
},
"performanceGoal": {
"description": "Optimization goal, e.g. LINK_CLICKS, LANDING_PAGE_VIEWS, OFFSITE_CONVERSIONS.",
"type": "string"
},
"primaryText": {
"description": "Ad primary text / body copy.",
"type": "string"
},
"useCBO": {
"description": "Campaign Budget Optimization on/off.",
"type": "boolean"
},
"websiteUrl": {
"description": "Landing page URL the ad clicks to.",
"type": "string"
}
},
"required": [
"campaignName",
"objective"
],
"type": "object"
},
"type": "array"
},
"catalogId": {
"description": "Product catalog ID, for DPA / catalog (dynamic product) campaigns.",
"type": "string"
},
"confirm": {
"description": "Set true to proceed when a spend-guardrail or rate-limit-capacity warning would otherwise pause the run.",
"type": "boolean"
},
"instagram_account_id": {
"description": "Instagram account for placements. Optional — auto-resolved from the account if omitted.",
"type": "string"
},
"meta_account_id": {
"description": "Ad account to create all these campaigns on (defaults to your primary account).",
"type": "string"
},
"page_id": {
"description": "Facebook Page for the ads. Optional — auto-resolved from the account if omitted.",
"type": "string"
},
"pixel_id": {
"description": "Meta Pixel for conversion tracking. Optional — auto-resolved from the account if omitted.",
"type": "string"
},
"productSetId": {
"description": "Product set ID within the catalog, for DPA / catalog campaigns.",
"type": "string"
}
},
"required": [
"campaigns"
],
"type": "object"
},
"name": "bulk_create_campaigns",
"outputSchema": null
},
{
"description": "Launch the SAME campaign set across MULTIPLE ad accounts in one call (up to 5 accounts; chain calls for more). Each account gets its own currency-aware guardrails, capacity check (throttled accounts are skipped, not hammered), and correct Page/Instagram/pixel. WRITES live.",
"inputSchema": {
"additionalProperties": true,
"properties": {
"account_ids": {
"description": "Up to 5 Meta ad account IDs.",
"items": {
"type": "string"
},
"type": "array"
},
"campaigns": {
"items": {
"additionalProperties": true,
"properties": {
"campaignName": {
"description": "Campaign name (shows in Ads Manager).",
"type": "string"
},
"cboBudget": {
"description": "Daily CBO budget in the account's currency, MAJOR units (e.g. 500 = ₹500). Used when useCBO is true.",
"type": "number"
},
"conversionLocation": {
"description": "e.g. website.",
"type": "string"
},
"ctaButton": {
"description": "Call-to-action, e.g. LEARN_MORE, SHOP_NOW, SIGN_UP.",
"type": "string"
},
"dailyBudget": {
"description": "Daily ad-set budget in MAJOR units, used when useCBO is false.",
"type": "number"
},
"headline": {
"description": "Ad headline.",
"type": "string"
},
"imageUrl": {
"description": "REQUIRED for image ads. A publicly-downloadable image URL. SUPPORTED: direct https image URLs, Google Drive share links, and Dropbox share links (file must be shared 'Anyone with the link can view') — these are auto-converted. NOT supported: OneDrive/SharePoint/Box links (unreliable), library image_hash values, or Meta fbcdn/permalink URLs (download fails).",
"type": "string"
},
"objective": {
"description": "e.g. OUTCOME_TRAFFIC, OUTCOME_LEADS, OUTCOME_SALES.",
"enum": [
"OUTCOME_TRAFFIC",
"OUTCOME_SALES",
"OUTCOME_LEADS",
"OUTCOME_ENGAGEMENT",
"OUTCOME_AWARENESS",
"OUTCOME_APP_PROMOTION"
],
"type": "string"
},
"performanceGoal": {
"description": "Optimization goal, e.g. LINK_CLICKS, LANDING_PAGE_VIEWS, OFFSITE_CONVERSIONS.",
"type": "string"
},
"primaryText": {
"description": "Ad primary text / body copy.",
"type": "string"
},
"useCBO": {
"description": "Campaign Budget Optimization on/off.",
"type": "boolean"
},
"websiteUrl": {
"description": "Landing page URL the ad clicks to.",
"type": "string"
}
},
"required": [
"campaignName",
"objective"
],
"type": "object"
},
"type": "array"
},
"confirm": {
"type": "boolean"
}
},
"required": [
"account_ids",
"campaigns"
],
"type": "object"
},
"name": "bulk_create_multi_account",
"outputSchema": null
},
{
"description": "Check an ad account's current Meta API rate-limit headroom BEFORE a bulk run. Read-only. Returns GO/TIGHT/SPLIT/WAIT_OR_SPLIT/WAIT + utilization + regain minutes.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"campaign_count": {
"type": "number"
},
"meta_account_id": {
"type": "string"
}
},
"required": [
"meta_account_id"
],
"type": "object"
},
"name": "check_capacity",
"outputSchema": null
},
{
"description": "Create an automation rule for an ad account: when a metric crosses a threshold over a lookback window, take an action (alert, pause, or scale budget). New rules default to alert-only unless you set a different action. Works at campaign, ad set, or ad level.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "What to do when it triggers. Defaults to alert.",
"enum": [
"alert",
"pause",
"resume",
"scale_budget",
"set_budget"
],
"type": "string"
},
"action_value": {
"description": "For scale_budget: percent step (e.g. 20 = +20%). For set_budget: absolute daily budget in major units.",
"type": "number"
},
"cooldown_hours": {
"description": "Min hours between actions on the same campaign. Default 24.",
"type": "number"
},
"entity_type": {
"description": "What the rule watches. Default campaign.",
"enum": [
"campaign",
"adset",
"ad"
],
"type": "string"
},
"frequency": {
"description": "How often to check. Default daily.",
"enum": [
"hourly",
"every_3_hours",
"every_6_hours",
"every_12_hours",
"daily"
],
"type": "string"
},
"lookback_days": {
"description": "Window the metric is measured over, 1-90. Default 3.",
"type": "number"
},
"meta_account_id": {
"description": "REQUIRED — the ad account the rule watches.",
"type": "string"
},
"metric": {
"description": "Metric to evaluate.",
"enum": [
"spend",
"cpa",
"results",
"roas",
"ctr",
"cpc",
"cpm",
"impressions",
"clicks",
"cpl",
"cpp",
"leads",
"purchases"
],
"type": "string"
},
"name": {
"description": "A short name for the rule.",
"type": "string"
},
"operator": {
"description": "gt=greater than, lt=less than, etc.",
"enum": [
"gt",
"gte",
"lt",
"lte",
"eq"
],
"type": "string"
},
"result_action_type": {
"description": "For cpa/results rules that pause or scale: the Meta result to count (e.g. lead, offsite_conversion.fb_pixel_purchase). Required to let a cpa/results rule take a money action.",
"type": "string"
},
"threshold": {
"description": "The number the metric is compared to.",
"type": "number"
}
},
"required": [
"name",
"meta_account_id",
"metric",
"operator",
"threshold"
],
"type": "object"
},
"name": "create_automation_rule",
"outputSchema": null
},
{
"description": "Create ONE Meta campaign (created PAUSED for review). Free-plan friendly — counts toward your monthly campaign limit. To launch many at once or from a Drive folder, use bulk_create_campaigns (Pro). Needs a public imageUrl (or Drive/Dropbox share link) for image ads. WRITES live.",
"inputSchema": {
"additionalProperties": true,
"properties": {
"appId": {
"description": "App ID for App Promotion campaigns.",
"type": "string"
},
"appStoreUrl": {
"description": "App store URL for App Promotion campaigns.",
"type": "string"
},
"bidStrategy": {
"description": "LOWEST_COST_WITHOUT_CAP / COST_CAP / LOWEST_COST_WITH_BID_CAP / LOWEST_COST_WITH_MIN_ROAS.",
"type": "string"
},
"campaignName": {
"type": "string"
},
"catalogId": {
"type": "string"
},
"cboBudget": {
"type": "number"
},
"conversionEvent": {
"description": "Pixel event for conversion goals, e.g. PURCHASE, LEAD, ADD_TO_CART.",
"type": "string"
},
"conversionLocation": {
"type": "string"
},
"countries": {
"description": "ISO country codes; defaults to IN.",
"items": {
"type": "string"
},
"type": "array"
},
"ctaButton": {
"type": "string"
},
"dailyBudget": {
"type": "number"
},
"description": {
"type": "string"
},
"headline": {
"type": "string"
},
"imageUrl": {
"description": "Image for the ad. Paste a PUBLIC https image URL, OR a single Google Drive / Dropbox file share link (shared so 'Anyone with the link can view') — these are auto-converted. For a single campaign, ask the user for ONE image's share link. (Listing a whole Drive folder to spin up one campaign per image is a Pro feature.)",
"type": "string"
},
"leadFormId": {
"description": "Instant-form ID for lead campaigns (instant_forms / website_and_instant_forms).",
"type": "string"
},
"meta_account_id": {
"description": "Ad account to create on (defaults to your primary).",
"type": "string"
},
"objective": {
"enum": [
"OUTCOME_TRAFFIC",
"OUTCOME_SALES",
"OUTCOME_LEADS",
"OUTCOME_ENGAGEMENT",
"OUTCOME_AWARENESS",
"OUTCOME_APP_PROMOTION"
],
"type": "string"
},
"performanceGoal": {
"type": "string"
},
"phoneNumber": {
"description": "Phone number for Calls campaigns.",
"type": "string"
},
"primaryText": {
"type": "string"
},
"productSetId": {
"type": "string"
},
"regionalRegulatedCategories": {
"description": "Regional regulated category codes required for certain locations (e.g. [\"SINGAPORE_UNIVERSAL\"] for Singapore Employment ads). Passed through to the ad set.",
"items": {
"type": "string"
},
"type": "array"
},
"regionalRegulationIdentities": {
"additionalProperties": true,
"description": "Verified beneficiary/payer identity IDs, required together with regionalRegulatedCategories (e.g. { \"singapore_universal_beneficiary\": \"<id>\", \"singapore_universal_payer\": \"<id>\" }). Passed through to the ad set.",
"type": "object"
},
"scheduleEnd": {
"description": "Ad set end time, ISO 8601 datetime. Optional; when set, Meta stops the ad set at this time (auto-stop fail-safe). Required by Meta when a lifetime budget is used.",
"type": "string"
},
"scheduleStart": {
"description": "Ad set start time, ISO 8601 datetime (e.g. 2026-09-20T09:00:00+08:00). Optional; defaults to ~1 hour from now.",
"type": "string"
},
"specialAdCategory": {
"description": "HOUSING / EMPLOYMENT / CREDIT / ISSUES_ELECTIONS_POLITICS (default NONE).",
"type": "string"
},
"useCBO": {
"type": "boolean"
},
"videoUrl": {
"type": "string"
},
"websiteUrl": {
"type": "string"
}
},
"required": [
"campaignName",
"objective"
],
"type": "object"
},
"name": "create_campaign",
"outputSchema": null
},
{
"description": "Create ONE campaign with MULTIPLE ad sets and MULTIPLE ads each (1 campaign -> N ad sets -> M ads), image or video, including DPA/Catalog dynamic product ads. Created PAUSED. Honors spend guardrails. Pro feature. WRITES live.",
"inputSchema": {
"additionalProperties": true,
"properties": {
"campaigns": {
"description": "One or more structured campaigns (usually one).",
"items": {
"additionalProperties": true,
"properties": {
"adSets": {
"items": {
"additionalProperties": true,
"properties": {
"adSetName": {
"type": "string"
},
"ads": {
"items": {
"additionalProperties": true,
"properties": {
"adName": {
"type": "string"
},
"callToAction": {
"description": "e.g. LEARN_MORE, SHOP_NOW.",
"type": "string"
},
"creativeType": {
"enum": [
"image",
"video"
],
"type": "string"
},
"headline": {
"type": "string"
},
"imageUrl": {
"description": "Public image URL or Drive/Dropbox share link (image ads).",
"type": "string"
},
"primaryText": {
"type": "string"
},
"videoUrl": {
"description": "Public video URL (video ads).",
"type": "string"
},
"websiteUrl": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"catalogId": {
"description": "DPA: product catalog id (with productSetId + conversionLocation 'catalog').",
"type": "string"
},
"conversionEvent": {
"type": "string"
},
"conversionLocation": {
"description": "website, instant_forms, calls, messaging_apps, instagram_profile, catalog, etc.",
"type": "string"
},
"countries": {
"items": {
"type": "string"
},
"type": "array"
},
"dailyBudget": {
"description": "Daily budget MAJOR units (ABO; ignored if campaign useCBO).",
"type": "number"
},
"leadFormId": {
"type": "string"
},
"messagingDestination": {
"type": "string"
},
"performanceGoal": {
"description": "Optimization goal for this ad set.",
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"productSetId": {
"description": "DPA: product set id.",
"type": "string"
}
},
"required": [
"ads"
],
"type": "object"
},
"type": "array"
},
"campaignName": {
"type": "string"
},
"countries": {
"items": {
"type": "string"
},
"type": "array"
},
"dailyBudget": {
"description": "CBO daily budget MAJOR units (when useCBO).",
"type": "number"
},
"objective": {
"enum": [
"OUTCOME_TRAFFIC",
"OUTCOME_SALES",
"OUTCOME_LEADS",
"OUTCOME_ENGAGEMENT",
"OUTCOME_AWARENESS",
"OUTCOME_APP_PROMOTION"
],
"type": "string"
},
"specialAdCategory": {
"type": "string"
},
"useCBO": {
"type": "boolean"
}
},
"required": [
"campaignName",
"objective",
"adSets"
],
"type": "object"
},
"type": "array"
},
"meta_account_id": {
"description": "Ad account (defaults to primary).",
"type": "string"
}
},
"required": [
"campaigns"
],
"type": "object"
},
"name": "create_structured",
"outputSchema": null
},
{
"description": "Delete an automation rule permanently.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"rule_id": {
"description": "The rule's id.",
"type": "string"
}
},
"required": [
"rule_id"
],
"type": "object"
},
"name": "delete_automation_rule",
"outputSchema": null
},
{
"description": "PERMANENTLY delete campaigns/ad sets/ads by ID. Irreversible — requires confirm:true. Use pause instead if unsure.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"campaign_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"confirm": {
"description": "Must be true — deletion is permanent.",
"type": "boolean"
},
"meta_account_id": {
"type": "string"
}
},
"required": [
"campaign_ids",
"confirm"
],
"type": "object"
},
"name": "delete_campaigns",
"outputSchema": null
},
{
"description": "Estimate how long bulk creation will take for N campaigns. Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
}
},
"required": [
"count"
],
"type": "object"
},
"name": "estimate_bulk_create",
"outputSchema": null
},
{
"description": "List the Meta ad accounts connected to this Adbloop user, with the Page NAME + Instagram username + pixel each account uses. Use this to resolve a spoken account/page name to IDs.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_ad_accounts",
"outputSchema": null
},
{
"description": "Full tree of one campaign: its ad sets and every ad inside each. Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"campaign_id": {
"type": "string"
},
"meta_account_id": {
"type": "string"
}
},
"required": [
"campaign_id"
],
"type": "object"
},
"name": "get_campaign_structure",
"outputSchema": null
},
{
"description": "List the user's saved creatives. NOTE: image_hash works with add_ad_to_adset, but bulk_create_campaigns needs a public imageUrl (or Drive/Dropbox link). Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"type": "number"
}
},
"type": "object"
},
"name": "get_creative_library",
"outputSchema": null
},
{
"description": "View the spend safety limits for an account. Read-only. Editable only by the owner in Adbloop settings.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"meta_account_id": {
"type": "string"
}
},
"type": "object"
},
"name": "get_guardrails",
"outputSchema": null
},
{
"description": "Rate-limit-safe Meta performance metrics (spend, impressions, clicks, CTR, leads, purchases, ROAS). Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"campaign_id": {
"description": "Limit the report to a single campaign (and its ad sets/ads when level is adset or ad).",
"type": "string"
},
"date_preset": {
"description": "Date-range shorthand, e.g. today, yesterday, last_7d, last_14d, last_30d, this_month, last_month, maximum. Ignored when both since and until are supplied.",
"type": "string"
},
"level": {
"description": "Report granularity: 'overview' = whole-account totals; 'campaign' = per campaign; 'adset' = per ad set; 'ad' = per ad. Defaults to 'campaign'.",
"enum": [
"campaign",
"adset",
"ad",
"overview"
],
"type": "string"
},
"limit": {
"description": "Max number of rows to return.",
"type": "number"
},
"meta_account_id": {
"description": "Ad account to report on (defaults to your primary).",
"type": "string"
},
"since": {
"description": "Custom range start, YYYY-MM-DD. Use together with 'until' (both required) instead of date_preset.",
"type": "string"
},
"until": {
"description": "Custom range end, YYYY-MM-DD. Use together with 'since'.",
"type": "string"
}
},
"type": "object"
},
"name": "get_insights",
"outputSchema": null
},
{
"description": "List the lead-gen forms available on a Facebook Page (for OUTCOME_LEADS campaigns). Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"meta_account_id": {
"type": "string"
},
"page_id": {
"type": "string"
}
},
"required": [
"page_id"
],
"type": "object"
},
"name": "get_lead_forms",
"outputSchema": null
},
{
"description": "List ads — across the account or inside one ad set. Includes creative preview info. Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"adset_id": {
"type": "string"
},
"limit": {
"type": "number"
},
"meta_account_id": {
"type": "string"
}
},
"type": "object"
},
"name": "list_ads",
"outputSchema": null
},
{
"description": "List ad sets — across the account or inside one campaign. Shows budget, optimization goal, status. Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"campaign_id": {
"type": "string"
},
"limit": {
"type": "number"
},
"meta_account_id": {
"type": "string"
}
},
"type": "object"
},
"name": "list_adsets",
"outputSchema": null
},
{
"description": "List your automation rules, with their condition, action, on/off state, and when each last ran.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"meta_account_id": {
"description": "Optional — only rules for this ad account.",
"type": "string"
}
},
"type": "object"
},
"name": "list_automation_rules",
"outputSchema": null
},
{
"description": "List existing campaigns with status, budget, effective status. Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"after": {
"type": "string"
},
"limit": {
"type": "number"
},
"meta_account_id": {
"type": "string"
},
"status_filter": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "list_campaigns",
"outputSchema": null
},
{
"description": "List the images/videos inside a PUBLIC Google Drive folder (must be shared as 'Anyone with the link'). Returns each file's name and a Drive URL usable directly as imageUrl in bulk_create_campaigns. Perfect for 'create one campaign per image in this folder'. Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"folder_url": {
"description": "Google Drive folder link (or bare folder ID)",
"type": "string"
}
},
"required": [
"folder_url"
],
"type": "object"
},
"name": "list_drive_folder",
"outputSchema": null
},
{
"description": "Pause campaigns/ad sets/ads by ID. Reversible.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"campaign_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"meta_account_id": {
"type": "string"
}
},
"required": [
"campaign_ids"
],
"type": "object"
},
"name": "pause_campaigns",
"outputSchema": null
},
{
"description": "Resume (activate) paused campaigns/ad sets/ads by ID. Turns spend ON.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"campaign_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"meta_account_id": {
"type": "string"
}
},
"required": [
"campaign_ids"
],
"type": "object"
},
"name": "resume_campaigns",
"outputSchema": null
},
{
"description": "Evaluate your active rules right now instead of waiting for the schedule, and report what fired. Guardrail cap and cooldown still apply. Useful for testing.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "run_automation_rules",
"outputSchema": null
},
{
"description": "Search Meta's targeting interests by keyword (e.g. 'yoga', 'small business owners'). Returns interest names, IDs, and audience sizes — useful when planning campaigns. Read-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"meta_account_id": {
"type": "string"
},
"query": {
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_targeting",
"outputSchema": null
},
{
"description": "Turn an automation rule on or off. Off rules stay saved but never run.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"is_active": {
"description": "true = on, false = off.",
"type": "boolean"
},
"rule_id": {
"description": "The rule's id.",
"type": "string"
}
},
"required": [
"rule_id",
"is_active"
],
"type": "object"
},
"name": "set_automation_rule_active",
"outputSchema": null
},
{
"description": "Change the daily budget (and/or rename) of an existing campaign or ad set. The account is required so the new budget is checked against your spend guardrails. WRITES live.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"daily_budget": {
"description": "New daily budget, MAJOR units (e.g. 500 = ₹500).",
"type": "number"
},
"entity_id": {
"description": "Campaign ID (CBO budget) or ad set ID.",
"type": "string"
},
"meta_account_id": {
"description": "REQUIRED — the ad account this entity belongs to (for the guardrail check).",
"type": "string"
},
"name": {
"description": "Optional new name.",
"type": "string"
}
},
"required": [
"entity_id",
"meta_account_id"
],
"type": "object"
},
"name": "update_campaign_budget",
"outputSchema": null
},
{
"description": "Pre-flight check campaign rows BEFORE creating. Read-only. Per-row verdict: will_create / will_create_with_changes / will_fail. Pass meta_account_id to also check spend guardrails.",
"inputSchema": {
"additionalProperties": true,
"properties": {
"campaigns": {
"items": {
"additionalProperties": true,
"properties": {
"campaignName": {
"description": "Campaign name (shows in Ads Manager).",
"type": "string"
},
"cboBudget": {
"description": "Daily CBO budget in the account's currency, MAJOR units (e.g. 500 = ₹500). Used when useCBO is true.",
"type": "number"
},
"conversionLocation": {
"description": "e.g. website.",
"type": "string"
},
"ctaButton": {
"description": "Call-to-action, e.g. LEARN_MORE, SHOP_NOW, SIGN_UP.",
"type": "string"
},
"dailyBudget": {
"description": "Daily ad-set budget in MAJOR units, used when useCBO is false.",
"type": "number"
},
"headline": {
"description": "Ad headline.",
"type": "string"
},
"imageUrl": {
"description": "REQUIRED for image ads. A publicly-downloadable image URL. SUPPORTED: direct https image URLs, Google Drive share links, and Dropbox share links (file must be shared 'Anyone with the link can view') — these are auto-converted. NOT supported: OneDrive/SharePoint/Box links (unreliable), library image_hash values, or Meta fbcdn/permalink URLs (download fails).",
"type": "string"
},
"objective": {
"description": "e.g. OUTCOME_TRAFFIC, OUTCOME_LEADS, OUTCOME_SALES.",
"enum": [
"OUTCOME_TRAFFIC",
"OUTCOME_SALES",
"OUTCOME_LEADS",
"OUTCOME_ENGAGEMENT",
"OUTCOME_AWARENESS",
"OUTCOME_APP_PROMOTION"
],
"type": "string"
},
"performanceGoal": {
"description": "Optimization goal, e.g. LINK_CLICKS, LANDING_PAGE_VIEWS, OFFSITE_CONVERSIONS.",
"type": "string"
},
"primaryText": {
"description": "Ad primary text / body copy.",
"type": "string"
},
"useCBO": {
"description": "Campaign Budget Optimization on/off.",
"type": "boolean"
},
"websiteUrl": {
"description": "Landing page URL the ad clicks to.",
"type": "string"
}
},
"required": [
"campaignName",
"objective"
],
"type": "object"
},
"type": "array"
},
"meta_account_id": {
"type": "string"
}
},
"required": [
"campaigns"
],
"type": "object"
},
"name": "validate_campaigns",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:b70df018735d3e2e46e63f359755e3a750f3aadbb335c26cb9d91cc3369c1cf4 | sha256sum