MCP Documentation

Inbox tools reference

Inbox is AI-driven: every ad account is operated by your assistant over the Model Context Protocol, not a manual dashboard. 273 tools across 21 ad platforms — Meta, Google, Amazon, LinkedIn, TikTok, Snapchat, Pinterest, Reddit and Microsoft — each covered in depth via passthrough to the native API.

273 MCP tools21 ad platformsNative passthroughDead-shell-freeAI optimization

Prerequisites

  • An Inbox workspace with a connected ad account (authorize each platform in Connections).
  • For Meta: a Business Manager account, an active ad account with billing, a Facebook Page (and optional Instagram account).
  • For Google: a Google Ads account and an approved developer token.
  • An MCP client — Claude, Claude Code, Cursor or any MCP-capable assistant — plus an Inbox API key.

Connecting & setup

  1. 1Go to Connections and click Connect on the platform you want (Meta, Google, …).
  2. 2Sign in and authorize the ad account; Inbox stores the connection, never the tokens.
  3. 3Create an API key under Settings and add the Inbox MCP server to your AI client.
  4. 4Ask your assistant to operate campaigns — everything below is one MCP call away.

Meta Ads — Facebook & Instagram (33 tools)

Native Graph API depth via passthrough. Tools marked write consume tool-call quota; reads are free.

Performance Analysis5 tools

meta_insights

Performance for a campaign, ad set, ad or whole account — with breakdowns by age, gender, placement and more.

meta_wasted_spend

Flags ads spending above a floor with no/low conversions or ROAS below 1, worst first.

meta_creative_fatigue

Detects ads whose CTR is falling while frequency rises — the signal to refresh creative.

meta_explain_anomaly

Finds the biggest day-over-day swing in spend, CPC, CTR or impressions and attributes it.

meta_get_creatives

Lists ad creatives on an account with their object story specs and thumbnails.

Targeting & Research3 tools

meta_search_targeting

Search interests, behaviors and demographics by free text (e.g. "yoga", "small business owners").

meta_browse_targeting

Browse Meta's full targeting category tree for an ad account.

meta_reach_estimate

Estimate audience size for a targeting spec before you launch.

Campaign Creation4 tools

meta_launch_campaignwrite

Launch a complete, deliverable campaign in one call — Campaign → Ad Set → Creative → Ad. Supports IMAGE, VIDEO and CAROUSEL. Created PAUSED.

meta_create_dcowrite

Dynamic Creative Optimization ad — Meta auto-mixes your images, titles and bodies for best performance.

meta_duplicate_campaignwrite

Deep-copy a campaign with all its ad sets and ads, created PAUSED.

meta_get_campaign

Full detail of a single campaign: objective, budget, bid strategy, status.

Ad Set & Ad Management7 tools

meta_list_campaigns

List campaigns on an ad account with status and budget.

meta_list_ad_sets

List ad sets in a campaign with targeting, budget and optimization goal.

meta_list_ads

List ads in an ad set with their creatives and status.

meta_add_ad_setwrite

Add an ad set (targeting + budget + optimization) to an existing campaign.

meta_add_adwrite

Add an ad with an existing creative to an ad set.

meta_update_objectwrite

Update any campaign / ad set / ad: budget, bid, targeting, schedule, name.

meta_set_statuswrite

Set ACTIVE, PAUSED, ARCHIVED or DELETED on any object — pause and resume included.

Audiences3 tools

meta_list_audiences

List custom and lookalike audiences with approximate sizes and delivery status.

meta_create_custom_audiencewrite

Create a custom audience — CUSTOM, WEBSITE or ENGAGEMENT — with an optional rule.

meta_create_lookalikewrite

Create a lookalike audience from a seed audience for a country at a chosen ratio.

Lead Generation2 tools

meta_list_lead_forms

List lead-gen forms configured on a Facebook Page.

meta_lead_form_submissions

Pull submissions (leads) from a specific lead form.

Account & Pixel Management2 tools

meta_list_pixels

List Meta Pixels configured on an ad account, with last-fired time.

meta_list_instagram

List Instagram accounts connected to the ad account for IG placements.

Optimization2 tools

meta_optimize_budget

Rank ad sets by ROAS and recommend shifting budget to top performers.

meta_optimize_placements

Rank placements (platform / position) by ROAS and CTR to reallocate spend.

Advanced — beyond Adspirer5 tools

meta_create_ad_rulewrite

Create an automated rule (e.g. auto-pause when cost-per-result exceeds a cap). Auto-pilot guardrail.

meta_list_ad_rules

List automated rules on an ad account.

meta_send_conversionwrite

Send a server-side conversion via the Conversions API (PII fields SHA-256 hashed).

meta_create_ab_testwrite

Create an A/B split test (ad study) comparing campaigns or ad sets by a metric.

meta_register_image_urlwrite

Register an image URL with Meta /adimages to get a reusable, validated image hash.

Google Ads (59 tools)

Full serving campaigns (Search, Performance Max, Display), keyword and bidding management, extensions, and GAQL reporting via passthrough to the native Google Ads API.

Campaign Creation4 tools

create_search_campaignwrite

Complete, serving Search campaign — budget → campaign → ad group → responsive search ad → keywords. PAUSED.

create_pmax_campaignwrite

Complete Performance Max — budget → campaign → asset group → text + image assets → search themes. PAUSED.

create_display_campaignwrite

Complete Display campaign — responsive display ad with images uploaded from URLs. PAUSED.

create_google_campaignwrite

Shell campaign of any channel type (SEARCH, DISPLAY, DEMAND_GEN, VIDEO, SHOPPING) — budget + campaign only.

Ad Groups & Ads5 tools

google_add_ad_groupwrite

Add a standalone ad group (SEARCH or DISPLAY) to a campaign.

google_add_search_adwrite

Add a standalone responsive search ad to an ad group.

google_add_display_adwrite

Add a standalone responsive display ad (images uploaded from URLs).

google_remove_adwrite

Remove an ad by resource name.

google_remove_ad_groupwrite

Remove an ad group by resource name.

Keywords & Research5 tools

keyword_research

Keyword ideas with real search volume and CPC from Google Keyword Planner.

google_add_keywordswrite

Add keywords (exact / phrase / broad) to an ad group.

google_add_negative_keywordswrite

Add campaign-level negative keywords to block irrelevant search terms.

google_search_terms

Search-term report (highest cost first) for negative-keyword discovery.

google_search_audiences

Search Google audiences (user lists) by name.

Display Targeting7 tools

google_add_display_audienceswrite

Add audiences — user lists and/or affinity / in-market interests — to a Display ad group.

google_add_display_topicswrite

Add topic targeting to a Display ad group.

google_add_display_placementswrite

Add managed placements (specific site URLs) to a Display ad group.

google_add_display_keywordswrite

Add contextual keywords to a Display ad group.

google_update_display_demographicswrite

Exclude age ranges and/or genders on a Display ad group.

google_get_display_criteria

View an ad group's targeting (audiences, topics, placements, keywords).

google_remove_criterionwrite

Remove any ad-group targeting criterion by resource name.

Performance Max Signals4 tools

google_add_pmax_search_themeswrite

Add search themes to a PMax asset group (≤25).

google_add_pmax_audience_signalwrite

Add an audience signal to a PMax asset group.

google_get_pmax_signals

View current search themes and audience signals.

google_remove_pmax_signalwrite

Remove a PMax asset-group signal.

Campaign Management10 tools

google_update_budgetwrite

Change a campaign budget's daily amount.

google_update_bid_strategywrite

Switch bidding — Maximize Conversions / Conversion Value / Target Spend, with optional CPA or ROAS targets.

google_set_ad_group_statuswrite

Pause or resume an ad group.

google_update_ad_groupwrite

Update an ad group — name, status, bid, rotation.

google_list_ad_groups

List ad groups (optionally for one campaign) with metrics.

google_campaign_targeting

View a campaign's locations, languages and audiences.

google_campaign_structure

Full campaign structure: campaign → ad groups → ads.

google_update_frequency_capswrite

Set ad-delivery frequency caps on a campaign.

google_update_schedulewrite

Set ad-scheduling (day/hour) criteria on a campaign.

google_update_campaign_settingswrite

Update network settings (Search Partners / Display) and add location + language targeting.

Creative & Assets7 tools

google_get_ad_creative

Export creative composition (headlines, descriptions, URLs) for ads.

google_update_display_creativewrite

Update a responsive display ad's creative fields.

google_add_search_imagewrite

Upload an image and attach it as a Search-campaign image asset.

google_discover_assets

Browse the account's asset inventory (text + image).

google_validate_assets

Validate an image URL against Google's size + aspect-ratio requirements before upload.

google_suggest_ad_content

Return Google ad character limits + a scaffold for the AI to fill (SEARCH or DISPLAY).

google_help_upload

Step-by-step guide + specs for uploading creative assets.

Ad Extensions7 tools

google_add_sitelinkswrite

Attach sitelink extensions (text + URL + descriptions).

google_add_calloutswrite

Attach callout extensions.

google_add_structured_snippetswrite

Attach a structured-snippet extension (header + values).

google_add_call_assetwrite

Attach a call extension (phone number).

google_add_business_namewrite

Attach a business-name asset to a Search campaign.

google_list_extensions

List a campaign's linked assets/extensions.

google_remove_extensionwrite

Remove a campaign extension by resource name.

Geo & Language2 tools

google_resolve_locations

Resolve location names to geoTargetConstants for location targeting.

google_list_languages

List targetable Google Ads languages.

Performance & Conversions8 tools

google_campaign_performance

Campaign performance via GAQL — cost, clicks, conversions, CTR, average CPC.

google_ad_performance

Per-ad performance across Search / Display / Video.

google_wasted_spend

Keywords with spend but zero conversions, highest cost first.

google_explain_anomaly

Biggest day-over-day swing in cost / clicks / conversions / CTR over 30 days, attributed.

google_optimize_budget

Rank campaigns by ROAS and recommend budget shifts.

google_recommendations

Google's own optimization recommendations for the account.

google_conversion_actions

List conversion actions with tracking method and status.

google_conversion_performance

Conversion volume, value and CPA by conversion action.

Amazon Ads (30 tools)

Sponsored Products, Brands and Display — campaigns, ad groups, product ads, keywords, targeting, recommendations and async reporting. We handle Amazon's LWA OAuth, regional routing and profile scoping.

Accounts1 tool

amazon_list_profiles

List advertiser profiles across NA/EU/FE regions (get the profileId other tools need).

Campaigns (SP / SB / SD)6 tools

amazon_list_campaigns

List campaigns of a type (Sponsored Products / Brands / Display) with status + budget.

amazon_create_sp_campaignwrite

Create a Sponsored Products campaign (PAUSED).

amazon_create_sb_campaignwrite

Create a Sponsored Brands campaign (PAUSED).

amazon_create_sd_campaignwrite

Create a Sponsored Display campaign (PAUSED).

amazon_update_campaignswrite

Update name / budget / state / bidding for campaigns of a type.

amazon_set_campaign_statewrite

Set ENABLED / PAUSED / ARCHIVED — pause, resume, delete.

Sponsored Products Structure10 tools

amazon_launch_spwrite

One-call launch: campaign → ad group → product ads → keywords. PAUSED.

amazon_list_ad_groups

List ad groups.

amazon_create_ad_groupwrite

Create an ad group in a campaign.

amazon_list_product_ads

List product ads.

amazon_add_product_adswrite

Add product ads (by ASIN or SKU) to an ad group.

amazon_list_keywords

List keywords.

amazon_add_keywordswrite

Add keywords (exact/phrase/broad) with bids.

amazon_add_negative_keywordswrite

Add negative keywords.

amazon_list_targets

List product/category targeting clauses.

amazon_add_targetswrite

Add product/category targeting clauses.

Sponsored Brands3 tools

amazon_list_sb_ads

List Sponsored Brands ads.

amazon_add_sb_keywordswrite

Add keywords to Sponsored Brands.

amazon_add_sb_themeswrite

Add theme-based targeting to Sponsored Brands.

Recommendations & Budget4 tools

amazon_keyword_recommendations

Suggested keywords for a list of ASINs.

amazon_bid_recommendations

Suggested bids for keywords/targets.

amazon_budget_recommendations

Budget optimization guidance for campaigns.

amazon_budget_usage

Campaign budget consumption tracking.

Reporting & Analytics5 tools

amazon_create_reportwrite

Request an async report (returns a reportId).

amazon_get_report

Retrieve a report by id (status + download URL when ready).

amazon_campaign_performance

Campaign report — impressions, clicks, spend, sales, ACOS, ROAS.

amazon_search_terms

Search-term report — actual shopper queries.

amazon_product_performance

Per-ASIN/SKU advertised-product report.

Advanced1 tool

amazon_rawwrite

Direct Amazon Ads API access for anything the typed tools don't cover.

LinkedIn Ads (23 tools)

Sponsored Content campaigns, creatives, B2B targeting (job title, industry, seniority, skills, company), analytics, conversions and lead gen — via the LinkedIn Marketing API.

Accounts2 tools

linkedin_list_ad_accounts

List ad accounts available to the connected user.

linkedin_list_organizations

List company pages available for advertising.

Campaign Groups2 tools

linkedin_list_campaign_groups

List campaign groups for an ad account.

linkedin_create_campaign_groupwrite

Create a campaign group (DRAFT).

Campaigns4 tools

linkedin_list_campaigns

List campaigns, optionally filtered by group.

linkedin_create_campaignwrite

Create a Sponsored Content (image) campaign, PAUSED, with targeting.

linkedin_update_campaignwrite

Partial-update budget, bid, targeting or status.

linkedin_set_campaign_statuswrite

Pause / resume / archive a campaign.

Creatives4 tools

linkedin_list_creatives

List creatives, optionally for one campaign.

linkedin_add_creativewrite

Add a creative referencing a post/share URN to a campaign.

linkedin_update_creativewrite

Update a creative's status or content reference.

linkedin_create_image_postwrite

Create a sponsored image post (the share a creative references).

Targeting & Research3 tools

linkedin_search_targeting

Typeahead targeting entities — titles, industries, skills, companies, seniorities + more facets.

linkedin_list_targeting_facets

List all available targeting facets.

linkedin_research_business

Suggest targeting from a company name (matching orgs + related titles).

Analytics4 tools

linkedin_campaign_performance

Campaign analytics — impressions, clicks, cost, conversions, leads.

linkedin_creative_performance

Creative-level analytics — compare image/copy combinations.

linkedin_explain_anomaly

Diagnose a sudden CTR/CPC/conversion change.

linkedin_optimize_budget

Rank campaigns by CPA and recommend budget shifts.

Conversions & Lead Gen3 tools

linkedin_list_conversions

List conversion events on an account.

linkedin_create_conversionwrite

Create a conversion event (form submission, download, demo request).

linkedin_list_lead_forms

List lead-gen forms for an account.

Advanced1 tool

linkedin_rawwrite

Direct LinkedIn Marketing API access (RestLi finders, typeahead, anything not typed).

TikTok Ads (28 tools)

In-Feed video campaigns — ad groups, video/image/Spark/carousel ads, asset upload, interest targeting, video-engagement analytics, hook-rate fatigue detection — via the TikTok Business API.

Accounts2 tools

tiktok_list_advertisers

List advertiser accounts authorized for this connection.

tiktok_advertiser_info

Advertiser account details (also a connection-status check).

Campaigns5 tools

tiktok_list_campaigns

List campaigns with status and budget.

tiktok_get_campaign

Detailed information for one campaign.

tiktok_create_campaignwrite

Create an In-Feed campaign (paused).

tiktok_update_campaignwrite

Update name, budget, budget mode.

tiktok_set_campaign_statuswrite

Enable / disable / delete campaigns.

Ad Groups4 tools

tiktok_list_ad_groups

List ad groups (filter by campaign).

tiktok_create_ad_groupwrite

Create an ad group with targeting + budget (paused).

tiktok_update_ad_groupwrite

Update name, budget, targeting, schedule.

tiktok_set_ad_group_statuswrite

Enable / disable / delete ad groups.

Ads & Creative Formats3 tools

tiktok_list_ads

List ads (filter by ad group or campaign).

tiktok_add_adwrite

Add image, video, Spark or Carousel ads to an ad group.

tiktok_set_ad_statuswrite

Enable / disable / delete ads.

Assets & Identity4 tools

tiktok_upload_videowrite

Upload a video by URL → video_id.

tiktok_upload_imagewrite

Upload an image by URL → image_id.

tiktok_discover_videos

Discover existing video assets in the account.

tiktok_list_identities

List identities usable as the ad author.

Targeting & Research1 tool

tiktok_search_targeting

Search interests, keywords, regions, languages, carriers, device models, action categories.

Reporting & Analysis8 tools

tiktok_campaign_performance

Campaign metrics with video engagement.

tiktok_ad_performance

Ad-level metrics incl. hook rate (2s) and completion (p100).

tiktok_audience_insights

Age/gender breakdown with spend, conversions, CPA.

tiktok_geo_performance

Country-level performance breakdown.

tiktok_wasted_spend

Flag ads with spend but no conversions.

tiktok_optimize_budget

Rank campaigns by CPA and recommend budget shifts.

tiktok_creative_fatigue

Detect hook-rate decline — which videos to refresh.

tiktok_explain_objective

Recommend the right objective + ad format for a goal.

Advanced1 tool

tiktok_rawwrite

Direct TikTok Business API access for anything the typed tools don't cover.

Snapchat Ads (29 tools)

Full funnel — campaigns, ad squads, ads, creatives + media, audience segments, interest/geo/device targeting and time-series stats — via the Snapchat Marketing API.

Accounts3 tools

snapchat_list_organizations

List organizations the user belongs to.

snapchat_list_ad_accounts

List ad accounts under an organization.

snapchat_get_ad_account

Ad account details.

Campaigns6 tools

snapchat_list_campaigns

List campaigns in an ad account.

snapchat_get_campaign

Campaign details.

snapchat_create_campaignwrite

Create a campaign (PAUSED).

snapchat_update_campaignswrite

Update campaigns (name, objective, …).

snapchat_set_campaign_statuswrite

Pause or activate a campaign.

snapchat_delete_campaignwrite

Delete a campaign.

Ad Squads4 tools

snapchat_list_ad_squads

List ad squads (ad sets) in a campaign.

snapchat_create_ad_squadwrite

Create an ad squad with targeting + budget (PAUSED).

snapchat_update_ad_squadswrite

Update ad squads (budget, bid, targeting).

snapchat_set_ad_squad_statuswrite

Pause or activate an ad squad.

Ads3 tools

snapchat_list_ads

List ads in an ad squad.

snapchat_create_adwrite

Create an ad referencing a creative (PAUSED).

snapchat_set_ad_statuswrite

Pause or activate an ad.

Creatives & Media4 tools

snapchat_list_creatives

List creatives in an ad account.

snapchat_create_creativewrite

Create a creative referencing a top-snap media id.

snapchat_list_media

List media assets.

snapchat_create_mediawrite

Register a media object (then upload bytes).

Targeting & Audiences3 tools

snapchat_search_targeting

Browse interests, demographics, geo, devices, languages.

snapchat_list_segments

List audience segments (custom audiences).

snapchat_create_segmentwrite

Create an audience segment.

Stats & Analysis5 tools

snapchat_campaign_stats

Campaign stats — impressions, swipes, spend, purchases, video views.

snapchat_ad_squad_stats

Ad squad stats.

snapchat_ad_account_stats

Account stats over time (DAY/HOUR/TOTAL).

snapchat_wasted_spend

Flag ad squads with spend but no purchases.

snapchat_optimize_budget

Rank ad squads by cost-per-purchase and recommend shifts.

Advanced1 tool

snapchat_rawwrite

Direct Snapchat Marketing API access for anything the typed tools don't cover.

Pinterest Ads (18 tools)

Campaigns, ad groups, Pin ads, audiences and analytics — via the Pinterest API v5.

Accounts & Pins2 tools

pinterest_list_ad_accounts

List ad accounts.

pinterest_list_pins

List Pins available to the account.

Campaigns4 tools

pinterest_list_campaigns

List campaigns.

pinterest_create_campaignwrite

Create a campaign (PAUSED, micro-currency budgets).

pinterest_update_campaignswrite

Update campaigns.

pinterest_set_campaign_statuswrite

Set ACTIVE/PAUSED/ARCHIVED.

Ad Groups3 tools

pinterest_list_ad_groups

List ad groups (filter by campaign).

pinterest_create_ad_groupwrite

Create an ad group with targeting + budget (PAUSED).

pinterest_set_ad_group_statuswrite

Set ACTIVE/PAUSED/ARCHIVED.

Ads3 tools

pinterest_list_ads

List ads (filter by ad group).

pinterest_create_adwrite

Create an ad referencing an organic Pin (PAUSED).

pinterest_set_ad_statuswrite

Set ACTIVE/PAUSED/ARCHIVED.

Audiences2 tools

pinterest_list_audiences

List audiences.

pinterest_create_audiencewrite

Create an audience.

Analytics3 tools

pinterest_campaign_analytics

Campaign analytics — spend, impressions, clicks, conversions, CTR.

pinterest_ad_group_analytics

Ad group analytics.

pinterest_ad_analytics

Ad analytics.

Advanced1 tool

pinterest_rawwrite

Direct Pinterest API access.

Reddit Ads (19 tools)

Campaigns, ad groups, post ads, audiences and async reporting — via the Reddit Ads API v3.

Accounts2 tools

reddit_me

Authenticated user info.

reddit_get_ad_account

Ad account details.

Campaigns4 tools

reddit_list_campaigns

List campaigns.

reddit_create_campaignwrite

Create a campaign (PAUSED).

reddit_update_campaignwrite

Update a campaign.

reddit_set_campaign_statuswrite

Pause or activate.

Ad Groups3 tools

reddit_list_ad_groups

List ad groups.

reddit_create_ad_groupwrite

Create an ad group with targeting + budget (PAUSED).

reddit_set_ad_group_statuswrite

Pause or activate.

Ads & Posts4 tools

reddit_list_ads

List ads.

reddit_create_adwrite

Create an ad referencing a post (PAUSED).

reddit_set_ad_statuswrite

Pause or activate.

reddit_list_posts

List promotable posts.

Audiences2 tools

reddit_list_audiences

List custom audiences.

reddit_create_audiencewrite

Create a custom audience.

Reporting3 tools

reddit_create_reportwrite

Request a report (group_by + fields).

reddit_get_report

Retrieve a report by id.

reddit_campaign_report

Convenience campaign report (spend, clicks, conversions, CTR, CPC).

Advanced1 tool

reddit_rawwrite

Direct Reddit Ads API access.

Microsoft Advertising (11 tools)

Bing/Microsoft Search campaigns via a normalized layer (the native API is SOAP), with a raw escape hatch.

Accounts1 tool

microsoft_list_ad_accounts

List Microsoft Advertising accounts.

Campaigns4 tools

microsoft_list_campaigns

List campaigns (normalized).

microsoft_get_campaign

Get one campaign.

microsoft_create_campaignwrite

Create a campaign (PAUSED).

microsoft_update_campaignwrite

Update a campaign.

Ad Groups & Ads4 tools

microsoft_list_ad_groups

List ad groups.

microsoft_create_ad_groupwrite

Create an ad group.

microsoft_list_ads

List ads.

microsoft_create_adwrite

Create an ad.

Reporting & Advanced2 tools

microsoft_report

Performance report (normalized).

microsoft_rawwrite

Raw passthrough escape hatch.

Automation Rules

Set-and-forget rules that run on a schedule across all 21 platforms: IF a campaign's metrics match (nested AND/OR on CPA, ROAS, CTR, spend, conversions…) THEN pause, resume, scale budget, or alert — with cooldowns, dry-run preview and a full execution log. The AI agent can create them by request.

Cross-platform Automation Rules6 tools

create_rulewrite

IF conditions match a campaign THEN action fires — across ALL 21 platforms, on a schedule. e.g. CPA > $30 → PAUSE, ROAS > 3 → SCALE_BUDGET +20%.

list_rules

List all automation rules.

update_rulewrite

Edit conditions, action, scope, cooldown, dry-run, or enable/disable.

delete_rulewrite

Delete a rule.

run_ruleswrite

Evaluate all active rules now and execute matching actions.

rule_history

Recent executions — what fired, on which campaign, applied/skipped/failed/dry-run.

Core & Cross-platform

Connection management, the AI optimization layer and a single normalized report that works across every connected platform.

Brand Knowledge3 tools

get_brand

Read the workspace brand profile (voice, audience, products, do's/don'ts, budget defaults). The agent reads this before writing copy or launching.

set_brandwrite

Create/update the brand profile so every campaign stays on-brand — only the fields you pass change.

clear_brandwrite

Delete the brand profile.

Core & Cross-platform14 tools

platform_report

Normalized performance report for ANY connected ad platform — Google, Meta, TikTok, LinkedIn, Pinterest, Reddit, Snapchat, Amazon and more — one schema across all.

list_connections

List the ad accounts connected to this workspace.

list_campaigns

List all campaigns across the workspace with status and budget.

create_campaignwrite

Create a normalized campaign on any platform, created PAUSED.

pause_campaignwrite

Pause a campaign by its Inbox id.

resume_campaignwrite

Resume (activate) a paused campaign.

get_insights

Cross-platform briefing: totals, per-platform metrics, wasted spend and budget recommendations.

conversion_audit

Audit conversion tracking across the account — health score, grade and recommendations.

generate_report

Generate and store a cross-platform performance snapshot.

preflight_campaign

Validate a campaign draft (budget, name, platform minimums) before creating it.

run_watch

Run the watch agent now: evaluate monitors and surface wasted-spend alerts.

create_monitorwrite

Create a metric monitor that alerts when a threshold is crossed (SPEND, CPA, ROAS, CTR, CPC, conversions).

list_alerts

List recent alerts raised by monitors and the watch agent.

capabilities

List everything this Inbox workspace can do.

Interactive widgets

In hosts that support rich tool output — ChatGPT, Claude and other MCP Apps clients — Inbox returns results as interactive panels, not walls of text. Ask for a performance briefing and you get a live KPI dashboard with a per-platform breakdown; list campaigns and you get a sortable, filterable table — rendered inline in the chat. Hosts without widget support fall back to plain text automatically, so nothing breaks.

  • Performance briefing → KPI dashboard (spend, ROAS, CTR, wasted spend, per-platform bars, recommendations).
  • Campaign & report lists → sortable, searchable tables across all 21 platforms.
  • Standards-based: served over the MCP Apps ui:// resource spec, no extra setup.

Example prompts

Launch

Launch a paused carousel campaign on my Meta account for US women 25–45 interested in fitness, $50/day, optimizing for link clicks.

Analyze

Show wasted spend across all my platforms over the last 30 days and explain the biggest Meta anomaly.

Audiences

Create a 1% US lookalike from my purchasers custom audience on Meta.

Google

Pull my Google search-term report and list negative-keyword candidates.

Guardrail

Add a rule that auto-pauses any Meta ad set whose cost per result goes above $30.

How Inbox compares

Inbox matches the full Meta surface of leading agents (campaign creation, audiences, lead gen, pixels, insights, optimization) and adds four capabilities they don't ship: automated rules, A/B split tests, the Conversions API for server-side events, and a cross-platform normalized report that works across every connected ad platform — not just six. Platform depth runs through passthrough to each native API, so nothing is lost to a lowest-common-denominator schema.