Documentation & trust

Product and API use

Meta Ads API and StoreAdOps

StoreAdOps is a hosted SaaS product and secure tool service for advertisers and agencies that own or are authorized to manage Meta (Facebook and Instagram) advertising accounts through Meta's Marketing API.

Business model

StoreAdOps is currently offered as a free hosted SaaS product with open signup. Paid subscription plans and external billing are not active. StoreAdOps does not sell advertising inventory, purchase media, or operate as an advertising agency. Users remain responsible for their own Meta ad accounts, budgets, and confirmed changes.

Meta permissions requested

After the user chooses to connect Meta, StoreAdOps requests the following permissions through Meta's OAuth consent screen:

Where catalog advertising is enabled, StoreAdOps also requests:

The Page workflow is read-only and limited to Page-authored published posts. StoreAdOps does not read comments, follower identities, messages, or audience content and does not publish or moderate Page content.

StoreAdOps advertises its complete tool catalog to every user through the standard /mcp endpoint. Broader Page advertising and Commerce catalog tools remain visible, but return a permission-required response before any Meta API call unless the connection already has their separately reviewed scopes.

How a user connects Meta

  1. The user signs in to StoreAdOps.
  2. The user authorizes Meta OAuth and grants the requested permissions.
  3. StoreAdOps lists only the businesses, ad accounts, and managed Pages inside the business selected during consent.
  4. The user connects an AI client using platform-managed browser OAuth where supported, or a revocable, tenant-scoped API key. The setup guide explains both paths.
  5. The client can request reporting or account operations only for the connected user's selected ad account.

Meta Marketing API use cases

Read workflows include campaign, ad set, and ad structure and performance, creative details, audience targeting research, pixel status, delivery diagnostics, managed-Page discovery, and review of recent Page-authored published posts for ad planning.

Management workflows include user-confirmed campaign, ad set, and ad creation, updates, and pauses, and, where catalog advertising is enabled, paused Advantage+ catalog sales campaigns that promote a product set from the merchant's existing catalog. New campaigns are created paused by default.

Safety and authorization controls

Data handling

StoreAdOps retrieves campaign and performance data live rather than accumulating a campaign-data warehouse. It stores encrypted OAuth tokens, selected account metadata, hashed API keys, OAuth state, usage counters, and audit and idempotency records. When growth-analysis features are enabled, bounded encrypted snapshots may be retained with a 30-day expiration; some operational and safety records are retained longer. See the privacy policy for retention and deletion details.

Meta user data is not sold and is not used to train general AI models. Users can revoke access in their Meta account settings and request deletion through support@storeadops.ai.

Meta Ads tools (64 provider tools)

Currently available Meta Ads tools for connected AI clients:

Generated from the current named-tool registry. Every callable input schema is exposed in tools/list; get_capabilities reports account readiness only. Availability depends on connected accounts, permissions, assets and enabled features. Server exposure does not establish approval or availability in an installed ChatGPT or Claude client.

Read and analyze (23)

Bounded reads of account, campaign or commerce data. These tools do not change advertising or store resources.

verify_connection

Verify connection. Performs a live metadata-only check; never selects an account or changes authorization. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, shopify, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_campaigns

Get campaigns. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_campaign_groups

Get campaign groups (ad group, asset group, line item). Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_ads

Get ads. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_creative_assets

Get creative assets. Supported channels: google, meta, pinterest, reddit, snapchat, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_media

Get media. Supported channels: google, meta, microsoft, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_pixels

Get pixels. Supported channels: meta, openai, reddit, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_pages

Get pages. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: business_management, pages_show_list, pages_read_engagement.
  • Requires granted scopes: business_management, pages_show_list.

get_page_posts

Get page posts. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: business_management, pages_manage_ads. Requires separately granted permission pages_manage_ads; not included in the standard connection.

get_catalogs

Get catalogs. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: business_management, catalog_management. Requires separately granted permission catalog_management; not included in the standard connection.

get_catalog_products

Get catalog products. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: business_management, catalog_management. Requires separately granted permission catalog_management; not included in the standard connection.

get_targeting_options

Get targeting options. Supported channels: google, meta, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_performance

Get performance. Synchronous metrics only; never starts an asynchronous report job. Supported channels: google, meta, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

audit_ad_account

Audit ad account. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

diagnose_delivery

Diagnose delivery. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

analyze_wasted_spend

Analyze wasted spend. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

detect_creative_fatigue

Detect creative fatigue. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

check_conversion_tracking

Check conversion tracking. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_budget_allocation_evidence

Get budget allocation evidence. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_placement_evidence

Get placement evidence. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

get_bid_strategy_evidence

Get bid strategy evidence. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

validate_creative_assets

Validate creative assets. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: ads_read.

validate_catalog

Validate catalog. Supported channels: meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: business_management, catalog_management. Requires separately granted permission catalog_management; not included in the standard connection.
Start report jobs (1)

Creates a report job only with explicit approval. This is separate from reading an existing report and does not change campaigns.

start_performance_report

Start ONE explicitly approved performance report job with the supplied account, campaign type, dates and dimensions. This creates provider/StoreAdOps report state, not ads or spend. Supported channels: amazon, meta, microsoft; only the provider/resource/profile variants in this schema. An idempotency_key is required; replay returns the same job. Do not retry an uncertain start with a new key. Use get_report to poll its status and bounded result pages.

  • Requires granted scopes: ads_read.
Prepare changes (20)

Validates inputs, reads relevant state and saves a preview plan in StoreAdOps. Preparation does not perform the proposed advertising change.

prepare_create_meta_campaign

Preview creation of a Meta Ads campaign in the connected account. Validates the requested resources and reads relevant current state, then saves an account-bound plan with its exact preview, plan_ref and required acceptance effects; no advertising resources are created during preparation. Proposed execution: Create one paused campaign, or one image/carousel/video bundle containing a campaign, ad set, creative and ad, as specified by projection. Campaigns, ad sets and ads are created PAUSED; the creative is a reusable asset. Bundle creation uses multiple provider calls, is not atomic, and can complete partially, leaving created resources after failure. It performs no automatic rollback. Inspect the recorded partial outcome before a supported continuation, which reuses verified existing objects. This action does not activate delivery or spending; it does not grant Meta eligibility or approval. After user review, call create_meta_campaign with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key. Repeating preparation saves another StoreAdOps plan; no Meta objects are changed. The preview does not grant Meta authorization or certify compliance.

  • Requires granted scopes: ads_management, business_management, pages_show_list.
  • Requires granted scopes: ads_management.

prepare_update_meta_campaign

Preview changes to one Meta Ads campaign in the connected account. Reads current state and saves an account-bound plan with its exact preview, plan_ref and required acceptance effects; no advertising changes occur during preparation. Proposed execution: Update one campaign's supplied name, bid strategy, special-ad categories, budget or spend cap without changing its configured status. Omit status or use null; to also change status use the separately named update-and-activate, update-and-pause or update-and-archive action. Only supplied non-null fields are changed; null means preserve, not clear. Supply at least one field that differs from the current campaign. Budget, bid-strategy and spend-cap changes can affect spend on an active campaign. Category changes can restrict available targeting; this action does not grant Meta authorization or certify compliance. After user review, call update_meta_campaign with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key. Repeating preparation saves another StoreAdOps plan; no Meta objects are changed. The preview does not grant Meta authorization or certify compliance.

  • Requires granted scopes: ads_management.

prepare_update_and_activate_meta_campaign

Preview changes to one Meta Ads campaign in the connected account. Reads current state and saves an account-bound plan with its exact preview, plan_ref and required acceptance effects; no advertising changes occur during preparation. Proposed execution: Set one campaign's configured status to ACTIVE and apply any supplied name, bid-strategy, special-ad-category, budget or spend-cap changes in the same campaign update. This changes only the campaign node, not child ad-set or ad statuses; eligible children can begin delivery and spending. It does not recursively resume paused children. Optional null fields preserve existing values; if already ACTIVE, another supplied field must differ. Category changes can restrict available targeting; this action does not grant Meta authorization, eligibility or approval. After user review, call update_and_activate_meta_campaign with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key. Repeating preparation saves another StoreAdOps plan; no Meta objects are changed. The preview does not grant Meta authorization or certify compliance.

  • Requires granted scopes: ads_management.

prepare_update_and_pause_meta_campaign

Preview changes to one Meta Ads campaign in the connected account. Reads current state and saves an account-bound plan with its exact preview, plan_ref and required acceptance effects; no advertising changes occur during preparation. Proposed execution: Set one campaign's configured status to PAUSED and apply any supplied name, bid-strategy, special-ad-category, budget or spend-cap changes in the same campaign update. This stops the campaign and its descendants' effective delivery without rewriting child ad-set or ad statuses. After user review, call update_and_pause_meta_campaign with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key.

  • Requires granted scopes: ads_management.

prepare_update_and_archive_meta_campaign

Preview changes to one Meta Ads campaign in the connected account. Reads current state and saves an account-bound plan with its exact preview, plan_ref and required acceptance effects; no advertising changes occur during preparation. Proposed execution: Set one campaign's configured status to ARCHIVED and apply any supplied name, bid-strategy, special-ad-category, budget or spend-cap changes in the same campaign update. This archives the campaign without deleting it or rewriting child ad-set or ad statuses; the archived campaign does not deliver. After user review, call update_and_archive_meta_campaign with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key.

  • Requires granted scopes: ads_management.

prepare_create_campaign_group

Prepare create campaign group: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: paused_create Create one paused group in its referenced campaign. After review call create_campaign_group with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: ads_management. When ad_set.promoted_object.page_id is non-null, also requires granted scopes: business_management, pages_show_list.

prepare_update_campaign_group

Prepare update campaign group: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: patch_may_change_delivery Update supported group name, budget, bid, configuration, targeting or status. Activation may enable advertising spend. After review call update_campaign_group with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: ads_management.

prepare_create_ad

Prepare create ad: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: paused_create Create one paused ad with an explicit format and typed creative. After review call create_ad with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: ads_management.

prepare_update_ad

Prepare update ad: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: patch_may_change_delivery Update supported ad content or status. Activation may enable advertising spend. After review call update_ad with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: ads_management.

prepare_pause_campaigns

Prepare pause campaigns: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. After review call pause_campaigns with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_resume_campaigns

Prepare resume campaigns: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. After review call resume_campaigns with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_remove_campaigns

Prepare remove campaigns: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_campaigns with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_pause_campaign_groups

Prepare pause campaign groups (ad group, asset group, line item): read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. After review call pause_campaign_groups with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_resume_campaign_groups

Prepare resume campaign groups (ad group, asset group, line item): read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. After review call resume_campaign_groups with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_remove_campaign_groups

Prepare remove campaign groups (ad group, asset group): read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_campaign_groups with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_pause_ads

Prepare pause ads: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. After review call pause_ads with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_resume_ads

Prepare resume ads: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. After review call resume_ads with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_remove_ads

Prepare remove ads: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_ads with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

prepare_delete_creative

Prepare delete creative: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: meta, pinterest, snapchat, x; only the provider/resource/profile variants in this schema. Proposed effects: hard_delete Remove one account asset using the channel's discovered semantics. Entities that use it may change delivery; some removals cannot be undone. After review call delete_creative with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: ads_management.

prepare_upload_media

Prepare upload media: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google, meta, microsoft, openai, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: library_upload Upload one image from a public HTTPS URL to the account's media library and return its media ID for creatives. After review call upload_media with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: ads_management.
Execute confirmed changes (20)

Requires the matching prepared plan, the exact change, explicit confirmation, accepted effects and an idempotency key. Activation and resume actions can start delivery and spending.

create_meta_campaign

Create one paused campaign, or one image/carousel/video bundle containing a campaign, ad set, creative and ad, as specified by projection. Campaigns, ad sets and ads are created PAUSED; the creative is a reusable asset. Bundle creation uses multiple provider calls, is not atomic, and can complete partially, leaving created resources after failure. It performs no automatic rollback. Inspect the recorded partial outcome before a supported continuation, which reuses verified existing objects. This action does not activate delivery or spending; it does not grant Meta eligibility or approval. Execute only the exact typed change reviewed through prepare_create_meta_campaign. Requires its plan_ref, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry a partial or uncertain creation with a new key. Account, profile, grants, feature gates and provider readback checks still apply.

  • Requires granted scopes: ads_management, business_management, pages_show_list.
  • Requires granted scopes: ads_management.

update_meta_campaign

Update one campaign's supplied name, bid strategy, special-ad categories, budget or spend cap without changing its configured status. Omit status or use null; to also change status use the separately named update-and-activate, update-and-pause or update-and-archive action. Only supplied non-null fields are changed; null means preserve, not clear. Supply at least one field that differs from the current campaign. Budget, bid-strategy and spend-cap changes can affect spend on an active campaign. Category changes can restrict available targeting; this action does not grant Meta authorization or certify compliance. Execute only the exact typed change reviewed through prepare_update_meta_campaign. Requires its plan_ref, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants, feature gates and provider readback checks still apply.

  • Requires granted scopes: ads_management.

update_and_activate_meta_campaign

Set one campaign's configured status to ACTIVE and apply any supplied name, bid-strategy, special-ad-category, budget or spend-cap changes in the same campaign update. This changes only the campaign node, not child ad-set or ad statuses; eligible children can begin delivery and spending. It does not recursively resume paused children. Optional null fields preserve existing values; if already ACTIVE, another supplied field must differ. Category changes can restrict available targeting; this action does not grant Meta authorization, eligibility or approval. Execute only the exact typed change reviewed through prepare_update_and_activate_meta_campaign. Requires its plan_ref, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants, feature gates and provider readback checks still apply.

  • Requires granted scopes: ads_management.

update_and_pause_meta_campaign

Set one campaign's configured status to PAUSED and apply any supplied name, bid-strategy, special-ad-category, budget or spend-cap changes in the same campaign update. This stops the campaign and its descendants' effective delivery without rewriting child ad-set or ad statuses. Execute only the exact typed change reviewed through prepare_update_and_pause_meta_campaign. Requires its plan_ref, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants, feature gates and provider readback checks still apply.

  • Requires granted scopes: ads_management.

update_and_archive_meta_campaign

Set one campaign's configured status to ARCHIVED and apply any supplied name, bid-strategy, special-ad-category, budget or spend-cap changes in the same campaign update. This archives the campaign without deleting it or rewriting child ad-set or ad statuses; the archived campaign does not deliver. Execute only the exact typed change reviewed through prepare_update_and_archive_meta_campaign. Requires its plan_ref, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants, feature gates and provider readback checks still apply.

  • Requires granted scopes: ads_management.

create_campaign_group

Create campaign group using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: paused_create Create one paused group in its referenced campaign. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: ads_management. When ad_set.promoted_object.page_id is non-null, also requires granted scopes: business_management, pages_show_list.

update_campaign_group

Update campaign group using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: patch_may_change_delivery Update supported group name, budget, bid, configuration, targeting or status. Activation may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: ads_management.

create_ad

Create ad using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: paused_create Create one paused ad with an explicit format and typed creative. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: ads_management.

update_ad

Update ad using the exact typed change and its immutable prepared plan. Supported channels: google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: patch_may_change_delivery Update supported ad content or status. Activation may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: ads_management.

pause_campaigns

Pause campaigns using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

resume_campaigns

Resume campaigns using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

remove_campaigns

Remove campaigns using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

pause_campaign_groups

Pause campaign groups (ad group, asset group, line item) using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

resume_campaign_groups

Resume campaign groups (ad group, asset group, line item) using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

remove_campaign_groups

Remove campaign groups (ad group, asset group) using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

pause_ads

Pause ads using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

resume_ads

Resume ads using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

remove_ads

Remove ads using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: ads_management.

delete_creative

Delete creative using the exact typed change and its immutable prepared plan. Supported channels: meta, pinterest, snapchat, x; only the provider/resource/profile variants in this schema. Effects: hard_delete Remove one account asset using the channel's discovered semantics. Entities that use it may change delivery; some removals cannot be undone. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: ads_management.

upload_media

Upload media using the exact typed change and its immutable prepared plan. Supported channels: google, meta, microsoft, openai, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: library_upload Upload one image from a public HTTPS URL to the account's media library and return its media ID for creatives. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: ads_management.
Shared StoreAdOps workflow tools (5)

These workspace tools are separate from the provider count above; they do not add advertising or commerce permissions.

get_connections_status
Check connected accounts and the selected account before starting.
get_capabilities
Check account readiness for already advertised tools; this does not grant access.
get_merchant_profile
Read the merchant objectives and guardrails saved in StoreAdOps.
get_change_status
Check a saved change's status and available readback; never retries a provider write.
get_report
Poll an existing report and read its result pages. Never starts another report job.

A shared tool can support more than one platform, so platform counts should not be added together. Advertising changes require a preview, explicit confirmation and an idempotency key; listing a tool is not permission to execute it.

Frequently asked questions

What can StoreAdOps do with my Meta account?

After you authorize Meta OAuth, connected AI clients can read reporting and account structure and, only with your explicit confirmation or a disclosed approval, create or update campaigns, ad sets, and ads in the ad account you selected. Campaign creation is paused. Campaign-only activation changes the parent status; the separate campaign resume action can also activate paused child ad sets and ads. Availability in a plugin directory depends on that host's tool review; server availability is not evidence of host approval.

Will it change my account without asking?

No. Direct write tools require confirmed=true; approval-backed executions require separately validated execution authority. All provider writes require an idempotency key, and new campaigns are created paused by default so you can review before anything spends.

Does it generate ad images or videos?

No. StoreAdOps manages campaigns and ads from creative assets you provide; it does not generate creative media.

How do I revoke access?

You can revoke access from your Meta account settings at any time and request deletion through support@storeadops.ai.