Get MCP Ads

Tool catalogue

600 implemented tools across 14 documented sources. Source access notes below determine what is callable through https://mcp.getmcpads.com/mcp.

Tools marked (write) change something on the live account. They preview by default: without confirm: true the tool describes the change and applies nothing. Writes are refused entirely on the Free plan.

A tool only answers for accounts the organisation has ticked. Any other identifier is refused, including accounts the underlying connection could otherwise reach.

Amazon Ads (104 tools, 74 write)

Connect Amazon and explicitly select the profiles your assistant may access. Tested with an Amazon test account. Product, brand and format eligibility are enforced by Amazon; DSP and AMC are separate products.

• amazon_ads_archive_sb_ad (write): Permanently archive one Sponsored Brands ad. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sb_ad_group (write): Permanently archive one Sponsored Brands ad_group. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sb_campaign (write): Permanently archive one Sponsored Brands campaign. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sb_keyword (write): Permanently archive one Sponsored Brands keyword. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sb_negative_keyword (write): Permanently archive one Sponsored Brands negative_keyword. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sb_negative_target (write): Permanently archive one Sponsored Brands negative_target. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sb_target (write): Permanently archive one Sponsored Brands target. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sd_ad_group (write): Permanently archive one Sponsored Display ad_group. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sd_campaign (write): Permanently archive one Sponsored Display campaign. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sd_negative_target (write): Permanently archive one Sponsored Display negative_target. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sd_product_ad (write): Permanently archive one Sponsored Display product_ad. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_archive_sd_target (write): Permanently archive one Sponsored Display target. Irreversible. Preview and explicit confirmation of this exact entity are required.
• amazon_ads_create_ad_group (write): Create a PAUSED Sponsored Products ad group with a default bid in profile currency. Checks the selected parent campaign. Preview and confirm before creating; requires a paid plan.
• amazon_ads_create_campaign (write): Create one Sponsored Products campaign in PAUSED state. Preview then confirm the exact name, targeting, dates, daily budget and bidding strategy. Currency is the profile currency. Does not activate spend; requires a paid plan.
• amazon_ads_create_campaign_negative_keyword (write): Create one Sponsored Products campaign negative keyword. Negative criteria start ENABLED and suppress matching traffic in their parent scope. Preview and confirm; requires a paid plan.
• amazon_ads_create_campaign_negative_target (write): Create one Sponsored Products campaign negative target. Negative criteria start ENABLED and suppress matching traffic in their parent scope. Preview and confirm; requires a paid plan.
• amazon_ads_create_keyword (write): Create one Sponsored Products keyword. Validates campaign/ad group ownership. Positive ads/targets/keywords start PAUSED; a negative keyword starts ENABLED and can suppress traffic. Product ads require exactly one seller SKU or vendor/author ASIN. Product targeting accepts an exact ASIN or native manual product/category/brand expressions. Preview and confirm; requires a paid plan.
• amazon_ads_create_negative_keyword (write): Create one Sponsored Products negative keyword. Validates campaign/ad group ownership. Positive ads/targets/keywords start PAUSED; a negative keyword starts ENABLED and can suppress traffic. Product ads require exactly one seller SKU or vendor/author ASIN. Product targeting accepts an exact ASIN or native manual product/category/brand expressions. Preview and confirm; requires a paid plan.
• amazon_ads_create_negative_target (write): Create one Sponsored Products negative target. Negative criteria start ENABLED and suppress matching traffic in their parent scope. Preview and confirm; requires a paid plan.
• amazon_ads_create_product_ad (write): Create one Sponsored Products product ad. Validates campaign/ad group ownership. Positive ads/targets/keywords start PAUSED; a negative keyword starts ENABLED and can suppress traffic. Product ads require exactly one seller SKU or vendor/author ASIN. Product targeting accepts an exact ASIN or native manual product/category/brand expressions. Preview and confirm; requires a paid plan.
• amazon_ads_create_report: Request an asynchronous Amazon performance report: Sponsored Products campaigns, groups, placements, search terms or advertised products; Brands campaigns/search terms/ads; Display campaigns/products. Brands legacy campaign reports exclude multi-ad-group campaigns. Does not change advertising or budgets. Choose the attribution window explicitly; retain jobToken and call amazon_ads_get_report later. No polling loop, no cross-platform attribution or automatic sums.
• amazon_ads_create_sb_ad_auto_collection (write): Create one Sponsored Brands ad auto collection. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_ad_brand_video (write): Create one Sponsored Brands ad brand video. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_ad_group (write): Create one Sponsored Brands ad group. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_ad_manual_collection (write): Create one Sponsored Brands ad manual collection. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_ad_product_collection (write): Create one Sponsored Brands ad product collection. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_ad_product_collection_extended (write): Create one Sponsored Brands ad product collection extended. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_ad_store_spotlight (write): Create one Sponsored Brands ad store spotlight. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_ad_video (write): Create one Sponsored Brands ad video. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_campaign (write): Create one Sponsored Brands campaign. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_keyword (write): Create one Sponsored Brands keyword. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_negative_keyword (write): Create one Sponsored Brands negative keyword. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_negative_target (write): Create one Sponsored Brands negative target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sb_target (write): Create one Sponsored Brands target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sd_ad_group (write): Create one Sponsored Display ad group. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sd_campaign (write): Create one Sponsored Display campaign. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sd_creative (write): Create one Sponsored Display creative. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sd_negative_target (write): Create one Sponsored Display negative target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sd_product_ad (write): Create one Sponsored Display product ad. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_sd_target (write): Create one Sponsored Display target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_create_target (write): Create one Sponsored Products target. Validates campaign/ad group ownership. Positive ads/targets/keywords start PAUSED; a negative keyword starts ENABLED and can suppress traffic. Product ads require exactly one seller SKU or vendor/author ASIN. Product targeting accepts an exact ASIN or native manual product/category/brand expressions. Preview and confirm; requires a paid plan.
• amazon_ads_get_ad_groups: Read one page of Amazon Sponsored Products ad groups, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_brands: List brands eligible for Sponsored Brands in this selected profile. Use the returned brandEntityId in campaign and creative configuration; never invent a brand ID.
• amazon_ads_get_campaign_negative_keywords: Read one page of Amazon Sponsored Products campaign negative keywords, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_campaign_negative_targets: Read one page of Amazon Sponsored Products campaign negative targets, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_campaigns: Read one page of Amazon Sponsored Products campaigns, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_creative_asset: Refresh one native Amazon image/video asset in the selected profile. Returns every version and its files; no guessed URLs and no cross-profile fallback. Pass its native assetId from list_creative_assets.
• amazon_ads_get_keywords: Read one page of Amazon Sponsored Products keywords, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_negative_keywords: Read one page of Amazon Sponsored Products negative keywords, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_negative_targets: Read one page of Amazon Sponsored Products negative targets, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_product_ads: Read one page of Amazon Sponsored Products product ads, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_get_product_metadata: Read advertised product titles, native image URLs, stock, price and eligibility from the advertiser's Amazon catalog. Retrieves Sponsored Products visuals without scraping retail pages. Page through pageIndex or Amazon's cursorToken; product images are not complete rendered ads.
• amazon_ads_get_profile: Read the selected Amazon Ads profile: marketplace, account type, currency and timezone. API access does not establish eligibility for Sponsored Brands, Display or DSP.
• amazon_ads_get_report: Check an Amazon report once and, when complete, read its native rows. Use only the jobToken returned by create_report for this workspace and profile. Downloads are bounded; pagination returns row offsets and explicitly marks partial results. Expired reports must be requested again.
• amazon_ads_get_sb_ad_creatives: Read native Sponsored Brands creative versions for one ad: headline, ASINs, brand logo and image/video asset references. Resolve asset IDs with get_creative_asset and ASINs with get_product_metadata. Requires Brands eligibility; no retail scraping.
• amazon_ads_get_sb_ad_groups: Read one page of Sponsored Brands ad groups. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance.
• amazon_ads_get_sb_ads: Read one page of Sponsored Brands ads. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance.
• amazon_ads_get_sb_campaigns: Read one page of Sponsored Brands campaigns. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance.
• amazon_ads_get_sb_keywords: List one page of Sponsored Brands keywords, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.
• amazon_ads_get_sb_negative_keywords: List one page of Sponsored Brands negative keywords, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.
• amazon_ads_get_sb_negative_targets: List one page of Sponsored Brands negative targets, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.
• amazon_ads_get_sb_targets: List one page of Sponsored Brands targets, including archived entities. Follow the returned cursor or offset; one page is not the whole inventory.
• amazon_ads_get_sd_ad_groups: Read one page of Sponsored Display ad groups. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.
• amazon_ads_get_sd_campaigns: Read one page of Sponsored Display campaigns. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.
• amazon_ads_get_sd_creatives: Read one page of Sponsored Display creatives. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.
• amazon_ads_get_sd_negative_targets: Read one page of Sponsored Display negative targets. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.
• amazon_ads_get_sd_product_ads: Read one page of Sponsored Display product ads. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.
• amazon_ads_get_sd_targets: Read one page of Sponsored Display targets. Requires Display eligibility. Pagination uses startIndex, not a cursor; full pages are conservatively marked partial. Creatives include native media references; these records are not performance metrics.
• amazon_ads_get_targets: Read one page of Amazon Sponsored Products targets, including paused and archived entities by default. Continue with nextToken until absent; one page is not an account total. These are configuration records, not performance metrics.
• amazon_ads_list_creative_assets: Search the Amazon creative asset library: images, logos and videos, native download/playback URLs, sizes and moderation metadata. One page; continue with nextToken using the same filters. Uploaded assets are not proof of campaign use or delivery. Sponsored Products images come from get_product_metadata instead.
• amazon_ads_prepare_asset_upload (write): Prepare an Amazon image/video upload for this profile. After preview/confirmation, returns a short-lived native S3 URL. PUT the file bytes to that exact URL without Amazon bearer credentials, with the returned content type, then call register_uploaded_asset with uploadToken. This does not create or activate an ad.
• amazon_ads_register_uploaded_asset (write): Register bytes already uploaded to the Amazon URL from prepare_asset_upload. Binds the source URL to the workspace/profile; arbitrary URLs are not accepted. Preview then confirm. Returns native assetId, versionId and specification failures. Images/videos remain subject to placement requirements and moderation.
• amazon_ads_update_ad_group (write): Update one Sponsored Products ad group: state and bid. Enabling may spend; archiving is irreversible. Preview binds current values, and confirm refuses a stale or changed request. Requires a paid plan.
• amazon_ads_update_campaign (write): Update Sponsored Products campaign name, state, dates or bidding strategy. ARCHIVED is irreversible. Preview binds the current campaign; changing bidding on an enabled campaign can change spend. Use update_campaign_budget for the daily budget.
• amazon_ads_update_campaign_budget (write): Change one Sponsored Products daily budget in profile currency. Can change spend on enabled campaigns. Preview binds the previous budget and state; confirmation refuses stale previews. Requires a paid plan.
• amazon_ads_update_campaign_negative_keyword (write): Change the state of a Sponsored Products campaign negative keyword. Enabling suppresses matching traffic; archiving is irreversible. Preview and confirm the exact entity.
• amazon_ads_update_campaign_negative_target (write): Change the state of a Sponsored Products campaign negative target. Enabling suppresses matching traffic; archiving is irreversible. Preview and confirm the exact entity.
• amazon_ads_update_campaign_status (write): Pause or enable one Amazon Sponsored Products campaign. Enabling can spend money. Preview first, then confirm with expectedStatus from the preview. Amazon enforces profile membership; archived campaigns cannot be restored. Requires a paid plan.
• amazon_ads_update_keyword (write): Update one Sponsored Products keyword: state and bid. Enabling may spend; archiving is irreversible. Preview binds current values, and confirm refuses a stale or changed request. Requires a paid plan.
• amazon_ads_update_negative_keyword (write): Change the state of a Sponsored Products negative keyword. Enabling suppresses matching traffic; archiving is irreversible. Preview and confirm the exact entity.
• amazon_ads_update_negative_target (write): Change the state of a Sponsored Products negative target. Enabling suppresses matching traffic; archiving is irreversible. Preview and confirm the exact entity.
• amazon_ads_update_product_ad (write): Update one Sponsored Products product ad: state. Enabling may spend; archiving is irreversible. Preview binds current values, and confirm refuses a stale or changed request. Requires a paid plan.
• amazon_ads_update_sb_ad (write): Update one Sponsored Brands ad. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_creative_auto_collection (write): Replace creative for Sponsored Brands ad creative auto collection. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_creative_brand_video (write): Replace creative for Sponsored Brands ad creative brand video. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_creative_manual_collection (write): Replace creative for Sponsored Brands ad creative manual collection. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_creative_product_collection (write): Replace creative for Sponsored Brands ad creative product collection. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_creative_product_collection_extended (write): Replace creative for Sponsored Brands ad creative product collection extended. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_creative_store_spotlight (write): Replace creative for Sponsored Brands ad creative store spotlight. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_creative_video (write): Replace creative for Sponsored Brands ad creative video. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_ad_group (write): Update one Sponsored Brands ad group. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_campaign (write): Update one Sponsored Brands campaign. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_keyword (write): Update one Sponsored Brands keyword. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_negative_keyword (write): Update one Sponsored Brands negative keyword. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_negative_target (write): Update one Sponsored Brands negative target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sb_target (write): Update one Sponsored Brands target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sd_ad_group (write): Update one Sponsored Display ad group. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sd_campaign (write): Update one Sponsored Display campaign. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sd_creative (write): Update one Sponsored Display creative. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sd_negative_target (write): Update one Sponsored Display negative target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sd_product_ad (write): Update one Sponsored Display product ad. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_sd_target (write): Update one Sponsored Display target. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries.
• amazon_ads_update_target (write): Update one Sponsored Products target: state and bid. Enabling may spend; archiving is irreversible. Preview binds current values, and confirm refuses a stale or changed request. Requires a paid plan.
• amazon_ads_upload_asset_bytes (write): Upload supplied image/video bytes to the native S3 URL bound to the opaque uploadToken from prepare_asset_upload. No bearer credentials are sent to S3. Preview/confirmation binds the byte digest. Register the asset afterwards; this does not create an ad.

Apple Ads (15 tools, 7 write)

Connect Apple Ads and select the organizations your assistant may access. Apple account roles apply.

• apple_ads_create_account (write): Create an additional Apple ad account in the authorizing user's organization. Requires a selected anchor account in that same organization and Apple account-creation permissions. Currency, timezone and billing are inherited; no app delegations or delivery are configured. Select the new account separately in Sources.
• apple_ads_create_adgroup (write): Create a PAUSED manual-CPT Apple ad group under a verified campaign. Automated keyword targeting is disabled.
• apple_ads_create_campaign (write): Create an App Store search-results campaign in PAUSED state. Requires an eligible app, explicit currency, budget and countries. Preview before confirming; no delivery is enabled by creation.
• apple_ads_create_keyword (write): Create a PAUSED positive keyword in a verified Apple ad group. Preview before confirming.
• apple_ads_get_account: Read the selected Apple ad account, including native currency, timezone and billing configuration.
• apple_ads_get_adgroups: Read a page of ad groups belonging to one Apple campaign.
• apple_ads_get_app: Read App Store app metadata available to the selected Apple ad account.
• apple_ads_get_app_eligibility: Check an app's advertising eligibility and available storefronts before creating a campaign.
• apple_ads_get_campaign: Read one Apple campaign and verify its account membership.
• apple_ads_get_campaigns: Read a page of Apple app campaigns, including paused campaigns. Native pagination is returned; offset/limit do not imply a complete account export.
• apple_ads_get_keywords: Read a page of positive keywords belonging to one Apple ad group.
• apple_ads_get_report: Read native Apple campaign, ad group, ad, keyword or search-term performance for explicit campaigns. Preserves spend currency, attribution metrics, timezone, native grand totals and pagination. Never sum ratios or assume a page is the entire account. Monthly/weekly/daily historical reports are supported subject to Apple retention. Omit granularity for period totals. Campaign reports accept up to 20 campaigns; other levels require exactly one campaign per call.
• apple_ads_update_adgroup (write): Update an Apple adgroup. Preview returns expectedSnapshot; confirm with that snapshot to reject changed resources or changed payloads. ENABLED may cause advertising spend.
• apple_ads_update_campaign (write): Update an Apple campaign. Preview returns expectedSnapshot; confirm with that snapshot to reject changed resources or changed payloads. ENABLED may cause advertising spend.
• apple_ads_update_keyword (write): Update an Apple keyword. Preview returns expectedSnapshot; confirm with that snapshot to reject changed resources or changed payloads. ENABLED may cause advertising spend.

LinkedIn Ads (26 tools, 11 write)

Advertising API Development tier. Test-account writes only; Standard access is not yet approved.

• linkedin_create_campaign (write): Create an inactive (DRAFT) text or sponsored-content campaign. LinkedIn campaigns hold budget, targeting and bid. Native compatibility still applies.
• linkedin_create_campaign_group (write): Create a DRAFT campaign group in a selected test account. Preview by default.
• linkedin_create_media_ad (write): Create a DRAFT sponsored image/video ad, with a dark post (feedDistribution NONE). Does not publish an organic feed post.
• linkedin_create_text_ad (write): Create a DRAFT text ad with an existing account-library image. Preview by default.
• linkedin_delete_draft_ad (write): Delete one owned DRAFT test creative. Does not delete its source post or media.
• linkedin_duplicate_ad (write): Duplicate a selected account ad into a verified campaign as DRAFT, reusing its exact content reference. Does not duplicate campaign settings or activate delivery.
• linkedin_finalize_upload (write): Finalize a video after all signed parts were uploaded. Check processing with linkedin_get_media until AVAILABLE; never substitute the cover for video.
• linkedin_find_targeting: Look up native targeting URNs such as countries by name.
• linkedin_get_account_details: Read one LinkedIn ad account in full, with the members who hold a role on it. Roles decide what the connection can do, so a read that fails on one account and works on another is usually a role, not a scope.
• linkedin_get_campaign_groups: List campaign groups in a LinkedIn ad account, with budget, schedule and serving status. On LinkedIn the campaign group is where a shared budget and a bid strategy live, so it is the level that explains why sibling campaigns stopped together.
• linkedin_get_campaigns: List campaigns in a LinkedIn ad account with status, objective, format, bid strategy, budget and schedule. On LinkedIn the campaign holds the targeting and the bid, and the creatives under it are the ads.
• linkedin_get_creatives: List the creatives of a LinkedIn ad account, optionally for given campaigns. A creative is the ad itself, and it carries its own intended status, its review verdict and the reasons it is being held back.
• linkedin_get_delivery_status: Explain why LinkedIn ads are or are not serving, from the account down to the creative. LinkedIn keeps a user status and a system serving status side by side, and it is almost always the second one that says why nothing is running.
• linkedin_get_demographics: Break LinkedIn delivery down by professional demographics: company, company size, industry, seniority, job title, job function or location. These are the numbers LinkedIn is bought for, and they come with limits the tool states alongside the rows.
• linkedin_get_entity: Read one campaign group, campaign or creative and verify account ownership.
• linkedin_get_insights: Run a LinkedIn Ads report grouped by one pivot. This is the analytics finder: one pivot, any granularity, and up to 20 fields including dateRange and pivotValues. Ratios such as CTR, CPC and CPM do not exist in the API and are computed here from the raw terms.
• linkedin_get_media: Refresh one image/video URL and verify library association.
• linkedin_get_revenue_attribution: Read the LinkedIn Revenue Attribution Report: pipeline and closed won revenue from the CRM, attributed to LinkedIn advertising. Only answers for accounts whose Business Manager has a CRM connected, and only over a window of 30 to 366 days.
• linkedin_get_setup_guide: Read account and LinkedIn Development preview constraints before writes.
• linkedin_initialize_upload (write): Initialize image/video upload to selected test account library. Returns signed receipt for chunk upload/finalization. No arbitrary upload host accepted.
• linkedin_list_ad_creatives: Gallery of ad-linked images and playable videos with actual ad names. Separates landing URLs from media URLs. Does not report delivery.
• linkedin_list_media: List account image/video library files with download URLs and native processing status; not ad performance.
• linkedin_run_statistics_report: Run a LinkedIn Ads report grouped by up to three pivots at once. This is the statistics finder, the only way to cross campaign with device, or campaign group with serving location, in a single request.
• linkedin_update_entity (write): Rename, pause/archive or edit budget, schedule, targeting or text-ad content of an owned test campaign/group/ad. No activation offered. Nested settings replace the corresponding object.
• linkedin_update_media (write): Rename or archive an owned account-library image/video. Binary content is immutable; upload a new asset to replace it.
• linkedin_upload_part (write): Upload one base64 file part using the signed initialization receipt. Up to 8 MiB decoded; file bytes stay at LinkedIn. No token sent to upload host.

Reddit Ads (50 tools, 19 write)

Connect Reddit and select the ad accounts your assistant may access. Native account eligibility and permissions apply.

• reddit_create_ad (write): create Reddit ad with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_create) and current configuration before edits.
• reddit_create_ad_group (write): create Reddit ad_group with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_group_create) and current configuration before edits.
• reddit_create_campaign (write): create Reddit campaign with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=campaign_create) and current configuration before edits.
• reddit_create_catalog (write): Reddit create catalog using the native schema catalog_create. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.
• reddit_create_custom_audience (write): create Reddit custom_audience with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=custom_audience_create) and current configuration before edits.
• reddit_create_lead_form (write): create Reddit lead_form with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=lead_form_create) and current configuration before edits.
• reddit_create_post (write): Reddit create post using the native schema post_create. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.
• reddit_create_product_set (write): Reddit create product set using the native schema product_set_create. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.
• reddit_create_saved_audience (write): create Reddit saved_audience with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=saved_audience_create) and current configuration before edits.
• reddit_get_ad: Read one Reddit ad; verify it belongs to the selected ad account.
• reddit_get_ad_group: Read one Reddit ad_group; verify it belongs to the selected ad account.
• reddit_get_ad_groups: Read Reddit ad_groups, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.
• reddit_get_ads: Read Reddit ads, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.
• reddit_get_asset_uploads: Poll processing of creative imports through the selected profile; ACTIVE is media-ready, not advertising delivery.
• reddit_get_campaign: Read one Reddit campaign; verify it belongs to the selected ad account.
• reddit_get_campaigns: Read Reddit campaigns, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.
• reddit_get_catalog_imports: Read catalog_imports from an owned Reddit catalog.
• reddit_get_catalogs: Read product catalogs of the business owning the selected ad account.
• reddit_get_creative_assets: List the selected Reddit profile's asset library; unused files are not necessarily ads.
• reddit_get_custom_audience: Read one Reddit custom_audience; verify it belongs to the selected ad account.
• reddit_get_custom_audiences: Read Reddit custom_audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.
• reddit_get_insights: Native Reddit reporting with metrics and entity/audience breakdowns, explicit UTC dates and pagination. Empty results validate transport only. Reported audience demographics differ from configured targeting.
• reddit_get_lead_form: Read one Reddit lead_form; verify it belongs to the selected ad account.
• reddit_get_lead_gen_forms: Read Reddit lead_gen_forms, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.
• reddit_get_pixels: List pixels accessible to the selected Reddit ad account.
• reddit_get_post: Read an ad structured post after profile ownership verification.
• reddit_get_post_job: Poll a previously created structured post using its signed job receipt. Does not accept arbitrary job IDs from another account.
• reddit_get_posts: List advertising structured posts for a profile attached to this account. Returns native image/video/carousel/text configuration.
• reddit_get_product_sets: Read product_sets from an owned Reddit catalog.
• reddit_get_products: Read products from an owned Reddit catalog.
• reddit_get_profiles: List profiles accessible to the selected Reddit ad account.
• reddit_get_reporting_schema: Reddit metric and dimension inventory; configured targeting is read with reddit_get_targeting, not inferred from reporting.
• reddit_get_saved_audience: Read one Reddit saved_audience; verify it belongs to the selected ad account.
• reddit_get_saved_audiences: Read Reddit saved_audiences, including native configuration and configured/effective status. Pagination returns an opaque cursor; all pages require explicit continuation.
• reddit_get_setup_guide: Complete Reddit connector coverage, prerequisites and live-validation limits. Do not infer unavailable capabilities from the initial short tool list.
• reddit_get_targeting: Read actual ad-group targeting: inclusions, exclusions, geo, age/gender, languages, interests, communities, keywords, devices and audience IDs. This is configuration, not delivery demographics.
• reddit_get_targeting_options: Discover valid native targeting values. Communities can be searched; large lists are paginated or explicitly marked partial.
• reddit_get_write_schema: Exact pinned native schemas for Reddit creation and edits, including targeting and all implemented campaign/ad formats. Provider acceptance is separate from local schema validation.
• reddit_health_check: Read the selected Reddit account, currency and timezone; API access is not proof of delivery or full objective eligibility.
• reddit_list_ad_creatives: Resolve ad-linked image/video/carousel assets with explicit coverage. A video cover does not establish its motion/audio; use full media when available.
• reddit_update_ad (write): update Reddit ad with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_update) and current configuration before edits.
• reddit_update_ad_group (write): update Reddit ad_group with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=ad_group_update) and current configuration before edits.
• reddit_update_asset (write): Update supported Reddit asset fields; preview by default. Read reddit_get_write_schema(operation=asset_update).
• reddit_update_campaign (write): update Reddit campaign with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=campaign_update) and current configuration before edits.
• reddit_update_catalog (write): Update supported Reddit catalog fields; preview by default. Read reddit_get_write_schema(operation=catalog_update).
• reddit_update_post (write): Update supported Reddit post fields; preview by default. Read reddit_get_write_schema(operation=post_update).
• reddit_update_product_set (write): Update supported Reddit product_set fields; preview by default. Read reddit_get_write_schema(operation=product_set_update).
• reddit_update_saved_audience (write): update Reddit saved_audience with native fields, including supported objectives/formats. Preview by default; creations of campaigns/groups/ads are always PAUSED. Read reddit_get_write_schema(operation=saved_audience_update) and current configuration before edits.
• reddit_upload_creative_assets (write): Reddit upload creative assets using the native schema asset_upload. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.
• reddit_upsert_products (write): Reddit upsert products using the native schema products_upsert. Preview first. Imports are asynchronous; poll the returned handles. Does not activate ads.

Microsoft Advertising (39 tools, 20 write)

Connect through Microsoft, then explicitly select the advertising accounts your assistant may access. Reads are available on Free; writes require an eligible paid plan.

• bing_add_ad_group_targeting (write): Add one native ad group targeting criterion. Read current targeting before edits; use Targets for demographic/geo edits and Audience for audience associations. Does not clear unspecified criteria.
• bing_add_campaign_targeting (write): Add one native campaign targeting criterion. Read current targeting before edits; use Targets for demographic/geo edits and Audience for audience associations. Does not clear unspecified criteria.
• bing_create_ad (write): Create a Microsoft Ads ad with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_create_ad_group (write): Create a Microsoft Ads ad_group with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_create_asset_group (write): Create a paused Performance Max asset group with text/image assets. Requires an eligible campaign and all required assets; local preview is not provider validation.
• bing_create_audience (write): Create a Microsoft Ads audience with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_create_campaign (write): Create a Microsoft Ads campaign with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_create_conversion_goal (write): Create a Microsoft Ads conversion_goal configuration. No website installation or event injection. Preview first; conversion goals are created paused and excluded from bidding.
• bing_create_keyword (write): Create a Microsoft Ads keyword with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_create_uet_tag (write): Create a Microsoft Ads uet_tag configuration. No website installation or event injection. Preview first; conversion goals are created paused and excluded from bidding.
• bing_get_ad_groups: Read ad groups and native configuration in an owned campaign.
• bing_get_ads: Read ads including native creative assets, URLs and status. AdTypes explicitly controls the returned formats.
• bing_get_asset_groups: Read Performance Max asset groups with native creative configuration and status.
• bing_get_audiences: Read accessible audience configuration for one explicit type. An empty audience does not establish matchability or targetability.
• bing_get_campaigns: Read native campaign configuration, budget, settings and status for an explicit campaign type. Repeat for other types to inventory the whole account.
• bing_get_conversion_goals: Read conversion-goal configuration; this does not establish that events are flowing.
• bing_get_geo_file: Get Microsoft's current geographic targeting catalog download link. Use its active Location IDs; never reuse Google location IDs.
• bing_get_insights: Submit an asynchronous Microsoft Ads report for the selected account. Poll the signed receipt with bing_get_report. Native column compatibility and sandbox data availability apply.
• bing_get_keywords: Read keywords, match types, bids and status from an owned ad group.
• bing_get_media: Read metadata of uploaded Microsoft Ads media by ID in the selected account.
• bing_get_report: Poll and download a Microsoft Ads report bound to this selected account and environment. Returns up to 2,000 CSV rows; narrow the range if truncated. Empty sandbox output is not production performance evidence.
• bing_get_reporting_schema: Read the pinned Microsoft report types, supported native columns and official references. Select columns for a compatible report type; a catalog entry is not evidence of populated or production data.
• bing_get_setup_guide: Microsoft Ads connector coverage, sandbox validation and remaining limitations. Read before claiming parity or unsupported features.
• bing_get_targeting: Read actual configured campaign or group targeting, separately by criterion type. Includes inclusion/exclusion criterion objects; this is configuration, not demographic performance.
• bing_get_uet_tags: Read UET tracking tag configuration. No website tracking code is installed by this operation.
• bing_get_videos: Read account video assets and processing status. Active means the media is ready, not that an ad is delivering. Video access depends on account eligibility; use returned failure codes.
• bing_get_write_schema: Pinned Microsoft native entity fields. Read each polymorphic object's documentation for its REST Type value. Schemas describe the API; account eligibility remains separate.
• bing_health_check: Read the selected account and confirm sandbox/production, customer and currency. This does not validate every feature.
• bing_import_video (write): Import a video from your directly downloadable HTTPS file into the selected account. Microsoft fetches and transcodes the source asynchronously; a returned ID is not readiness. Preview first, then poll bing_get_videos. Does not create or activate an ad.
• bing_list_ad_creatives: Retrieve actual image representations linked to account-owned ads and Performance Max asset groups, preserving parent IDs/names. Bounded inventory; no inferred delivery, video contents or KPI attribution.
• bing_update_ad (write): Update a Microsoft Ads ad with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_update_ad_group (write): Update a Microsoft Ads ad_group with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_update_ad_group_targeting (write): Update one native ad group targeting criterion. Read current targeting before edits; use Targets for demographic/geo edits and Audience for audience associations. Does not clear unspecified criteria.
• bing_update_audience (write): Update a Microsoft Ads audience with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_update_campaign (write): Update a Microsoft Ads campaign with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_update_campaign_targeting (write): Update one native campaign targeting criterion. Read current targeting before edits; use Targets for demographic/geo edits and Audience for audience associations. Does not clear unspecified criteria.
• bing_update_keyword (write): Update a Microsoft Ads keyword with native fields. Preview by default. Ad entities are created Paused. Read bing_get_write_schema and current configuration first.
• bing_update_video (write): Update the description of an account-owned video asset. Does not alter delivery or replace the video source. Preview by default; read-back with bing_get_videos.
• bing_upload_image (write): Upload image bytes to the selected Microsoft Ads library. Does not create or activate an ad. Local preview reports byte length without repeating the image body.

Snapchat Ads (46 tools, 25 write)

Available for authorized, selected accounts.

• snapchat_create_ad (write): Create a Snapchat ad. Always PAUSED. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_adsquad (write): Create a Snapchat adsquad. Always PAUSED. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_campaign (write): Create a Snapchat campaign. Always PAUSED. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_creative (write): Create a Snapchat creative. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_creative_element (write): Create a Snapchat creative_element. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_interaction_zone (write): Create a Snapchat interaction_zone. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_lead_generation_form (write): Create a Snapchat lead_generation_form. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_lookalike (write): Create a lookalike audience from an owned customer-list seed. Provider eligibility and sufficient seed size still apply; creation does not guarantee targetable_status READY. Preview unless confirm true.
• snapchat_create_media (write): Create a Snapchat media. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_create_segment (write): Create a Snapchat segment. Local preview by default; confirm true writes after verifying parent/account ownership.
• snapchat_finalize_frozen_upload (write): Finalize only after every frozen upload part has an acknowledged signed partReceipt. Returns mediaId; follow with snapchat_get_media_status until ready:true before creating a creative.
• snapchat_finalize_media_upload (write): Finalize a video upload after all parts succeeded. Use the exact finalize_path and upload_id returned by init_media_upload. Preview unless confirm true.
• snapchat_get_ads: List Snapchat ads in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_adsquads: List Snapchat adsquads in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_campaigns: List Snapchat campaigns in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_creative_elements: List Snapchat creative_elements in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_creatives: List Snapchat creatives in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_entity: Read a campaign, ad squad, ad, creative, media or segment with verified account ownership.
• snapchat_get_insights: Read native Snapchat stats with explicit time interval (end exclusive), granularity and optional entity breakdown. Spend and monetary conversion values are micro currency. Empty test-account results are not live performance evidence.
• snapchat_get_interaction_zones: List Snapchat interaction_zones in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_lead_generation_forms: List Snapchat lead_generation_forms in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_media: List Snapchat media in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_media_status: Read this account-owned media and its native processing state. Only ready:true permits creative creation; an accepted upload alone is insufficient.
• snapchat_get_mobile_apps: Read Snap App IDs associated with the selected ad account before creating app promotion campaigns or mobile retargeting audiences.
• snapchat_get_pixels: Read the pixels associated with the selected account before configuring conversion optimization or website audiences.
• snapchat_get_segments: List Snapchat segments in the selected account, retaining full native configuration and pagination. An ad squad is an ad group/ad set.
• snapchat_get_setup_guide: Read Snapchat campaign objectives, audience workflows, creative format prerequisites and explicit limitations. Implementation is not proof of account eligibility or live delivery. Use before claiming all features are available.
• snapchat_get_targeting: Read configured ad squad targeting, audiences, exclusions, demographics, geo and placements. Missing fields are unknown, not proof of broad targeting. Performance breakdowns describe delivery, not configured targeting.
• snapchat_get_targeting_options: Discover native targeting values before editing: countries, regions, languages, genders, interests and devices. Retains pagination; do not invent category IDs.
• snapchat_get_targeting_specs: Read separately stored targeting specs, including configurations exceeding 500 criteria. These can be omitted from the ordinary ad squad response.
• snapchat_get_write_schema: Discover implemented Snapchat creation/edit fields, required fields and preview rules. These are connector-supported fields, not an exhaustive Snap API schema.
• snapchat_health_check: Read the selected Snapchat account, permissions-visible metadata and test flag. Test accounts cannot serve ads.
• snapchat_init_media_upload (write): Initialize a chunked video upload, up to 256 MiB across at most 32 parts of 8 MiB. Returns upload_id, add_path and finalize_path to use for subsequent calls. Preview unless confirm true.
• snapchat_list_ad_creatives: Resolve ad-linked Snapchat images/videos, Story children and Collection tiles with business names, native IDs and fresh media URLs. Incomplete formats/media are reported. No performance is inferred.
• snapchat_prepare_frozen_upload (write): Prepare a resumable upload for an existing media object from a frozen Launcher file. Images: PNG/JPEG up to 5 MB. Videos: MP4/MOV up to the shared 500 MB limit. Returns a signed receipt and part count; does not create another media or ad.
• snapchat_update_ad (write): Update Snapchat ad configuration, including name. Preview by default; ownership checked before applying.
• snapchat_update_adsquad (write): Update Snapchat adsquad configuration, including name, targeting, schedule and budget. Preview by default; ownership checked before applying.
• snapchat_update_audience_users (write): Add or remove customer-list members. Accepts only normalized SHA-256 hashes: EMAIL_SHA256, PHONE_SHA256, MOBILE_AD_ID_SHA256. Normalize emails by trimming/lowercasing; phones to country-code digits; mobile IDs lowercase retaining hyphens. Never invent customer data. Preview returns counts, not hashes. Caller batches up to 10,000 per request; confirm true applies.
• snapchat_update_campaign (write): Update Snapchat campaign configuration, including name. Preview by default; ownership checked before applying.
• snapchat_update_creative (write): Update Snapchat creative configuration, including name. Preview by default; ownership checked before applying.
• snapchat_update_segment (write): Rename or edit retention/description of an audience segment. Unchanged fields are preserved. Local preview unless confirm true.
• snapchat_update_status (write): Pause or activate a campaign, ad squad or ad. Preview by default; activating production entities can spend budget.
• snapchat_upload_frozen_image (write): Upload one frozen PNG/JPEG up to 5 MB into an existing media object. Bounded transfer with one native mutation; no extra multipart steps. Follow /result/mediaId with get_media_status ready:true. Supports large image lots without expanding each image into video upload parts.
• snapchat_upload_frozen_part (write): Transfer one exact frozen file range using the saved upload receipt. One-based part number, at most 8 MiB in memory. Save every partReceipt for finalization; successful parts are never replayed by the Launcher.
• snapchat_upload_media (write): Upload base64 image/video bytes to a previously created media object. Maximum 5 MB per image or 10 MiB per direct video, decoded. Use frozen uploads for larger videos. No external URL fetching. Preview does not send bytes; confirm true uploads after ownership verification.
• snapchat_upload_media_part (write): Upload one video part, at most 8 MiB decoded. Use the exact add_path and upload_id returned by init_media_upload. Preview never sends bytes.

X Ads (44 tools, 19 write)

Connect your own X Ads account and select the advertisers to expose. Free permits reads; Pro, Team and Enterprise permit writes. Reconnect older connections for media.write. X controls account verification and delivery eligibility.

• x_ads_activate_campaign (write): Activate a campaign (set entity_status=ACTIVE). This makes the campaign eligible to serve ads and SPEND REAL MONEY once its line items are also active. This is the only tool that can activate a campaign; confirm with the advertiser before calling it. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_activate_line_item (write): Activate a line item (set entity_status=ACTIVE). Once its parent campaign is also active, the line item becomes eligible to serve ads and SPEND REAL MONEY. This is the only tool that can activate a line item; confirm with the advertiser before calling it. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_add_targeting_criterion (write): Add one targeting criterion to a line item (call once per criterion). A line item with no criteria serves broad ; that is allowed, not an error. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_create_ad_post (write): Compose a promoted-only ("nullcasted") post to use as an ad creative. The post never appears on the author's profile or followers' timelines and spends nothing by itself ; attach it to a line item with promote_post. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_create_campaign (write): Create a campaign in an ads account. The campaign is ALWAYS created with entity_status PAUSED ; it cannot serve or spend until explicitly activated with activate_campaign. Campaigns are always created with budget_optimization LINE_ITEM (the only mode ads-api still supports), so budgets are NOT set here: set daily_budget_amount_local_micro on each line item via create_line_item. Schedule (start_time/end_time) and pacing (standard_delivery) also live on line items, not campaigns, in ads-api v12. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_create_card (write): Create a card from a JSON components payload. Cards are immutable through this API (there is no update tool) ; to change a card, create a new one and promote a new post that uses the new card_uri. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_create_line_item (write): Create a line item (ad group) under a campaign. The line item is ALWAYS created with entity_status PAUSED ; it cannot serve or spend until explicitly activated with activate_line_item. For website conversion campaigns, set goal=WEBSITE_CONVERSIONS and primary_web_event_tag to a web event tag (pixel) id from list_web_event_tags. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_create_media_library_item (write): Register an existing media key as a named item in the account's media library. Use list_media_library to see media already registered to the account. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_create_web_event_tag (write): Create a website conversion event tag (pixel); the returned id can be set as a line item's primary_web_event_tag Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_delete_card (write): Delete a card from an ads account. Deleting a card that a live promoted post references leaves that post's card dangling (posts are immutable) ; to swap a live ad's card, create the new card, create a new ad post with its card_uri, promote it, then pause the old ad before deleting the old card. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_delete_media_library_item (write): Delete a media library object from an ads account Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_delete_web_event_tag (write): Delete a website conversion event tag Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_get_account_stats: Get synchronous analytics (impressions, engagements, spend) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_active_entities: List which ads entities had metrics change in a time window (use before requesting account stats) Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_campaign: Get a single campaign by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_campaign_reach: Get reach and average-frequency metrics for campaigns Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_card: Get a single card by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_line_item: Get a single line item by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_media_library_item: Get a single media library object by media key Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_media_upload_status: Read processing status of an upload owned by the connected X user. Media uploads are user-owned until registered in the selected account's media library.
• x_ads_get_promoted_post: Get a single promoted post by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_targeting_criterion: Get a single targeting criterion by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_get_web_event_tag: Get a single website conversion event tag by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_account_posts: List posts (tweets) usable for promotion by an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_ads_accounts: List the ads accounts the authenticated user can access Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_campaigns: List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_cards: List the cards in an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_funding_instruments: List funding instruments (payment sources) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_line_item_placements: List valid placement combinations per line item product type Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_line_items: List line items (ad groups) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_media_library: List the media library objects in an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_post_previews: Get rendered HTML previews for published or scheduled posts Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_promoted_posts: List promoted posts (promoted tweets) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_targeting_criteria: List targeting criteria for an ads account's line items Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_list_web_event_tags: List the website conversion event tags (pixels) in an ads account; a tag's id is what a conversion line item takes as its primary_web_event_tag Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_promote_post (write): Attach post(s) to a line item as its ad creative(s). Promoted posts have no entity_status of their own ; they cannot serve while the parent line item or campaign is paused. The response carries each post's approval_status (ads enter review before serving). Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_remove_targeting (write): Remove a targeting criterion from its line item (undo a targeting mistake). Criterion IDs come from list_targeting_criteria or the add response. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_search_targeting_interests: Search targetable interest categories by name. Use this to find the targeting_value IDs required by add_targeting_criterion for INTEREST-type criteria. Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_search_targeting_locations: Search targetable locations by name. Use this to find the targeting_value IDs required by add_targeting_criterion for LOCATION-type criteria. Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.
• x_ads_update_campaign (write): Rename a campaign or pause it (entity_status=PAUSED). This tool can pause but CANNOT activate ; use activate_campaign to make a campaign eligible to spend. Budgets and schedule live on line items in ads-api v12: use update_line_item to change them. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_update_line_item (write): Update a line item's bid, budget, name, schedule, placements, goal, pacing, audience expansion (set audience_expansion=EXPANDED to turn on Optimized Targeting) or entity_status. Set entity_status=PAUSED to pause this ad group; pausing is only possible here, and activate_line_item is the only way to make it eligible to spend again. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_update_media_library_item (write): Update a media library object's metadata (e.g. name, title, description) Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_update_web_event_tag (write): Update a website conversion event tag Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.
• x_ads_upload_media (write): Upload an image, GIF or MP4 clip to X. Preview includes size and SHA-256 only. X API credits may be charged. Images use one request; video/GIF use initialize, append and finalize without retries. Check processing before registering the returned media_key with create_media_library_item. Does not create or activate an ad.

RTB House (7 tools, 2 write)

Available for authorized, selected accounts.

• rtb_house_get_advertiser: Read RTB House advertiser details, status, currency, available attribution conventions and permissions.
• rtb_house_get_campaigns: Read RTB House campaigns, including paused campaigns and isEditable. Campaign hashes are subcampaigns in statistics.
• rtb_house_get_creatives: Read RTB House creative names, statuses and preview links, including inactive creatives by default.
• rtb_house_get_insights: Read RTB House daily or grouped performance. Conversion metrics require an explicit countConvention. Returns available metrics, labelled ratio calculations, unavailableMetrics and partial coverage, with attribution, currency and UTC offset. Never sum ratios or reach across rows. RTB House validates dimension combinations.
• rtb_house_get_offers: Read product offers from an RTB House advertiser feed. A result reaching the limit may be incomplete.
• rtb_house_update_advertiser_status (write): Pause or activate the ENTIRE RTB House advertiser. This controls delivery across its campaigns. Preview first, then confirm:true with expectedStatus. Activation may resume spending across active campaigns.
• rtb_house_update_campaign_status (write): Pause or activate one RTB House campaign. Checks advertiser membership and isEditable. Preview first, then confirm:true with expectedStatus from that preview. Activation may spend money.

Meta Ads (59 tools, 23 write)

Available for authorized, selected accounts.

• meta_batch_catalog_items (write): Create or update up to 50 catalog products by retailer_id. Returns asynchronous batch handles; acceptance is not completion. No deletion or automatic upsert. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_create_ad (write): Create a PAUSED ad using an existing ad set and creative from the selected account. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_create_adcreative (write): Create an ad creative from an existing post or an explicit object_story_spec and optional asset_feed_spec. Supports image, video, carousel, collection and flexible specs. Does not launch an ad. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_create_adset (write): Create a PAUSED Meta ad set with explicit targeting, optimization, placements, attribution, bidding and schedule. Amounts use major account-currency units. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_create_campaign (write): Create a PAUSED Meta campaign with either ad set budgets (omit campaign budget), a daily campaign budget, or a lifetime campaign budget. Supports native validate_only. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_create_custom_audience (write): Create a website, engagement, customer-list container or lookalike audience. Does not upload customer data. Terms and eligibility are enforced by Meta. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_create_product_set (write): Create a filtered product set in a catalog owned by the same Business as the selected ad account. Never publishes to Shops. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_debug_token: Check the current access token validity, expiration, and granted scopes. Useful for diagnosing auth issues.
• meta_duplicate_adset (write): Duplicate a known-good ad set within the selected account, preserving complex native configuration. Always PAUSED and WITHOUT copying ads. Rename it afterwards with meta_rename_adset. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_get_account_details: Get detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info.
• meta_get_ad_activity: Read ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields.
• meta_get_ad_studies: List conversion lift studies and A/B tests (Ad Studies) for an ad account. Includes study type, status, and cells.
• meta_get_ads: List ads for a Meta ad account, optionally filtered by ad set. Returns ad ID, name, status, and creative reference.
• meta_get_adset_configuration: Read an existing ad set, its parent campaign budget/objective and account currency before preparing an edit. Returns native settings; no mutation.
• meta_get_adsets: List ad sets for a Meta ad account, optionally filtered by campaign. Returns targeting, budget, optimization, and schedule info.
• meta_get_audience_details: Read detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow.
• meta_get_audiences: List custom, saved, and lookalike audiences for a Meta ad account.
• meta_get_brand_safety_controls: Read brand safety, suitability, placement, and context-control signals from ad account/ad set targeting and optional block-list edges.
• meta_get_business_assets: Discover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow.
• meta_get_campaign_structure: Get hierarchical campaign structure: campaigns -> ad sets -> ads. Useful for understanding account organization.
• meta_get_campaigns: List campaigns for a Meta ad account. Returns campaign ID, name, status, objective, budget, and bid strategy.
• meta_get_catalog_batch_status: Read the completion and per-item errors for a catalog batch handle. Acceptance of a batch is not proof that every product succeeded.
• meta_get_catalog_products: Read Product Catalogs and Product Items when catalog access is available. Returns join-ready product metadata without creating or updating catalog assets.
• meta_get_creative_assets: Return ad-linked creative media with actual ad names, collection covers, all carousel/flexible components, resolved image hashes and video URLs. Catalog-only ads are classified separately; use get_creative_gallery for a visual gallery. Raw creative metadata remains available for diagnostics.
• meta_get_creatives: Get ad creative content: text, images, videos, links, call-to-action. Returns creative details for specified ads.
• meta_get_delivery_diagnostics: Aggregate read-only delivery diagnostics across campaigns, ad sets, and ads using status/effective_status/issues_info where available plus simple delivery insights.
• meta_get_insights: Meta performance. For purchases, leads or conversion analysis request actions (and action_values for revenue), or explicit metrics such as purchases/omni_purchases/leads. The native conversions field is not a universal conversion total; its absence does not mean purchases or leads are unavailable. Label the exact action_type and never sum overlapping purchase types. Fields: meta://metrics, meta://dimensions, meta://breakdowns. Compatible query results are merged.
• meta_get_instagram_accounts: List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow.
• meta_get_organic_content_enrichment: Read Facebook Page posts and Instagram media with URLs, native periods and optional insights. These are content insights, not Ads Insights; do not infer an organic-only breakdown.
• meta_get_page_posts: Read published Facebook Page posts using a Page token resolved from the connected user. Returns exact PageID_PostID, message, permalink and media attachments. Use postId for an exact existing-post ad preflight. No Instagram media, comments, likes or insights are requested; this read alone does not establish advertising eligibility.
• meta_get_pages: List accessible Facebook Pages with id, name, category, tasks, picture, and linked Instagram account references when available.
• meta_get_pixels: List pixels and datasets from an ad account or Business Manager when accessible, returning actionable warnings for permission-limited edges.
• meta_get_study_results: Get detailed results for a conversion lift or A/B test study. Returns objectives, cells, and lift results.
• meta_get_uploaded_video: Check video processing and membership in the selected account library. If the first page misses the ID, use the video title to narrow the account-scoped lookup. A direct video read alone never proves membership or readiness. Bounded pagination; not_found is not success.
• meta_get_video_sources: Resolve fresh download URLs (source) and thumbnails for specific ad videos. Call this at download time: the returned URLs are signed and expire quickly.
• meta_health_check: Agent-ready read-only health check: validates token metadata, lists accessible ad accounts, and warns about missing read scopes without exposing the access token.
• meta_inspect_launcher_entity: Read a specific acknowledged Launcher entity in its ad account for reconciliation. Read-only; never creates, changes or retries the entity. Missing or normalized fields must be inspected before claiming an exact match.
• meta_interpret_experiment_results: Read and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities.
• meta_join_product_insights: Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.
• meta_list_ad_accounts: List all Meta ad accounts accessible with the current token. Returns account ID, name, currency, timezone, and status.
• meta_list_ad_images: List the ad account image library (/adimages): hash, name, dimensions, status, a permanent publicly served display URL (permalink_url), short-lived CDN URLs, and optionally the creatives using each image.
• meta_list_ad_videos: List the ad account video library (/advideos): title, duration, processing status, and publicly served thumbnails (preferred and largest sizes). Source file URLs are returned only on request because they expire quickly.
• meta_rename_ad (write): Rename a Meta ad. The name is the only thing that changes. Previews by default.
• meta_rename_adset (write): Rename a Meta ad set. The name is the only thing that changes. Previews by default.
• meta_rename_campaign (write): Rename a Meta campaign. The name is the only thing that changes. Previews by default.
• meta_search_entities: Search campaigns, ad sets, or ads by name within an ad account. Useful for finding specific entities.
• meta_update_ad_creative (write): Replace an ad’s creative with another existing creative from the same account. The ad status is unchanged. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_update_ad_status (write): Pause or reactivate a Meta ad. Previews by default: without confirm: true, the tool describes the change without applying it.
• meta_update_adset_budget (write): Change an ad set daily or lifetime budget after checking its parent budget and existing schedule. Status stays unchanged. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_update_adset_configuration (write): Update targeting, optimization, placements, attribution, bidding, budget or schedule. Targeting is a COMPLETE replacement, not a partial merge. Status is unchanged. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_update_adset_schedule (write): Change start and/or end time using ISO 8601 with an explicit offset. Check the resulting range against existing dates before any mutation. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_update_adset_status (write): Pause or reactivate a Meta ad set. Previews by default: without confirm: true, the tool describes the change without applying it.
• meta_update_campaign_budget (write): Change an existing campaign-owned budget after verifying currency and ownership. Does not convert an ad-set-budget campaign or change status. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_update_campaign_status (write): Pause or reactivate a Meta campaign. Previews by default: without confirm: true, the tool describes the change without applying it.
• meta_update_custom_audience (write): Update an existing custom audience name, description, retention or complete rule. Does not change audience membership directly. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_update_product_set (write): Replace a product set filter or rename it. Catalog ownership and set membership are checked before writing. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_upload_ad_image (write): Upload an image into the selected ad account using base64 bytes (up to 5 MiB decoded). Preview reports size only, never the file body. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_upload_ad_video (write): Import a video from a publicly reachable HTTPS URL or base64 MP4 bytes (up to 5 MiB decoded). Meta processes it asynchronously. No campaign is launched. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.
• meta_validate_query: Validate a metric/breakdown combination BEFORE executing. Returns errors and warnings. Use this to check if your query will work.

Pinterest Ads (56 tools, 27 write)

Available for authorized, selected accounts.

• pinterest_batch_catalog_items (write): Submit native CREATE/UPDATE/UPSERT/DELETE catalog item operations. Poll the returned batch ID before reporting completion. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_ad (write): Create a PAUSED ad from an accessible Pin. Native specification supports Pinterest creative formats subject to eligibility. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_adgroup (write): Create a PAUSED ad group with explicit native bidding, targeting, budget and schedule. Performance+ requires explicit performancePlusUnderPausedCampaign consent: its group is ACTIVE while the parent campaign must remain PAUSED. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_board (write): Create /boards in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_campaign (write): Create a PAUSED campaign. Monetary convenience fields use the account currency. Campaign Budget Optimization defaults to true; non-CBO eligibility is account-specific. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_catalog (write): Create /catalogs in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_catalog_feed (write): Create /catalogs/feeds in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_collection_ad (write): Create a PAUSED collection with an explicitly selected image/video hero Pin and an accessible catalog product group. Does not create catalog-only/DPA ads. Standard account eligibility is required; unavailable in Sandbox. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_pin (write): Create /pins in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_product_group (write): Create /catalogs/product_groups in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_create_product_group_promotion (write): Create a PAUSED shopping or collections promotion from a catalog product group. Unavailable in Sandbox. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_estimate_delivery: Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates. The request body follows the selected Pinterest v5 schema and no campaign/ad group is created or changed.
• pinterest_get_account_entities: Read Pinterest ad-account entities and configuration. Covers account, campaign, ad group, ad, product-group promotion, promotion, label, schedule, targeting template, and order-line inventory. Returns one API page and its bookmark for predictable live queries.
• pinterest_get_audience_insights: Read aggregated Pinterest Audience Insights for the advertiser's total or engaged audience, Pinterest's total audience, or the scope/type endpoint. Pinterest fixes the audience-insights observation window; it is not a custom date-range report.
• pinterest_get_audiences: Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership.
• pinterest_get_billing_and_orders: Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status. Financial data is returned only when the token has account access.
• pinterest_get_business_assets: Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites. Requires the corresponding business-management permissions.
• pinterest_get_catalog_diagnostics: Read deep catalog inventory and diagnostics: catalogs, feeds, feed processing results, item issues, product groups, product counts/products, available filter values, and catalog item lookups. ITEMS is a read-only POST lookup.
• pinterest_get_catalog_inventory: List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples.
• pinterest_get_conversion_setup: Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events, and conversion-deletion request status. This never sends or deletes conversion events.
• pinterest_get_creative_assets: Fetch Pinterest creative assets and period performance when available. Returns ads, pins, thumbnails/images/videos, campaign/ad group context, catalog signals, and asset classifications.
• pinterest_get_delivery_metrics: Read Pinterest resources/delivery_metrics. Use this to inspect Pinterest's official delivery metric metadata for sync or async reports.
• pinterest_get_keyword_intelligence: Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Country metrics accept up to 2,000 keywords per request.
• pinterest_get_lead_assets: Read lead-form definitions and lead subscription configuration. Lead-record export is intentionally excluded because it can contain end-user PII.
• pinterest_get_organic_inventory: Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results. This is inventory metadata, not proof of paid delivery.
• pinterest_get_pin_analytics: Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins. Pass raw metric names supported by the selected Pinterest endpoint.
• pinterest_get_platform_resources: Read Pinterest platform metadata and readiness resources: supported ad-account countries, delivery metric definitions, metrics readiness, lead-form questions, media upload metadata, commerce integration metadata, or the authenticated user account.
• pinterest_get_targeting_options: Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience. Can also resolve a specific interest ID.
• pinterest_get_trends: Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, or editorial articles.
• pinterest_get_video_upload: Read processing status for this advertiser-bound uploaded video. Only ready:true permits video Pin creation; registration or HTTP 204 is insufficient.
• pinterest_get_write_schema: Read the official Pinterest v5 native request schema and Sandbox limitations before composing a write.
• pinterest_health_check: Read-only Pinterest Ads health check. Verifies configured credentials, account access, delivery metrics access, and optional default account readability without exposing OAuth tokens.
• pinterest_list_ad_accounts: List Pinterest ad accounts accessible to the configured credentials.
• pinterest_list_ad_creatives: List the ad account's ad creatives across every status (the API silently omits ARCHIVED ads unless asked) with their pin media resolved: public i.pinimg.com image URLs up to 1200px, video cover, and video_url when the app is allowed to read it. Catalog-driven formats are excluded by default.
• pinterest_prepare_video_upload (write): Register an upload for a frozen Launcher video and save its opaque receipt before transferring bytes. Does not create a Pin or ad. Preview, confirm, upload, then check processing.
• pinterest_register_media (write): Register media upload; returned upload_url/parameters are not confirmation that a video is uploaded or ready. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_run_catalog_report: Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM. PRODUCT_ITEM history is limited to 92 days before today (UTC), with requests chunked into 31-day windows; older item performance cannot be retrieved by retrying. Use PRODUCT_GROUP for older catalog delivery totals, not individual SKU performance.
• pinterest_run_conversion_product_report: Run Pinterest async conversion product reporting by brand, category, brand+category, SKU, or SKU group via reports/brand_category_sku. This is a restricted Pinterest feature: Standard API access alone does not guarantee availability for the client. It is separate from PRODUCT_ITEM spend reporting.
• pinterest_run_report: Run a read-only Pinterest Ads report. Auto-routes old/wide or explicit async requests through Pinterest async reports. Uses raw Pinterest reporting column names.
• pinterest_run_specialized_export: Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics. START creates only a report/export artifact; it never updates delivery entities.
• pinterest_run_targeting_report: Run live targeting analytics for an ad account, campaigns, ad groups, or ads, broken down by age, gender, location, interest, keyword, audience, placement, device, or other Pinterest targeting types. For data older than the sync window, use pinterest_run_report with targetingTypes and executionMode=async.
• pinterest_update_ad (write): Update native ad settings. Read the existing entity first; nested specifications may replace existing values. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_ad_status (write): Update the status of an existing ad. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_adgroup_budget (write): Set exactly one daily or lifetime ad group budget in major account currency units. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_adgroup_configuration (write): Update native ad group settings. Read the existing entity first; nested specifications may replace existing values. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_adgroup_status (write): Update the status of an existing adgroup. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_board (write): Update /boards in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_campaign_budget (write): Set exactly one daily or lifetime campaign budget in major account currency units. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_campaign_configuration (write): Update native campaign settings. Read the existing entity first; nested specifications may replace existing values. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_campaign_status (write): Update the status of an existing campaign. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_catalog_feed (write): Update /catalogs/feeds in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_pin (write): Update a Pin. Requires Pinterest restricted pin_edit entitlement in addition to pins:write; Standard alone is insufficient. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_product_group (write): Update /catalogs/product_groups in the selected advertiser context. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_update_product_group_promotion (write): Update a catalog product group promotion. Unavailable in Sandbox. Preview by default. No automatic mutation retry. Native API eligibility and scopes still apply.
• pinterest_upload_video (write): Stream the frozen video to the native destination saved in uploadReceipt. No bearer credential is sent to storage. Does not register another media or activate advertising. Follow with pinterest_get_video_upload.
• pinterest_validate_report: Validate and preview how a Pinterest report will execute. Returns sync/async routing, endpoint, level, columns, attribution settings, and warnings without calling performance endpoints.

Google Ads (45 tools, 10 write)

Available for authorized, selected accounts.

• google_ads_apply_plan (write): Preview, validate and atomically apply a Google Ads v25 build/change plan: campaigns, budgets, ad groups, RSA/Display/Demand Gen ads, image/text/YouTube assets, PMax asset groups and links, keywords, geographic/language targeting listing groups and conversion action configuration (no conversion event uploads). Native REST camelCase fields; amounts are integer micros of the explicitly stated currency. Supports temporary negative resource IDs for ordered creation in one transaction. No VIDEO campaign creation (Google API restriction), billing, account access changes, customer lists or conversion uploads. New campaigns/groups/ads are always PAUSED. Call first without confirm to inspect the plan and get planHash; validateOnly asks Google without applying; execution requires confirm and the matching expectedPlanHash. Read back results with google_ads_run_gaql. Never retry a creation after an uncertain network result before checking its name/IDs.
• google_ads_create_campaign (write): Create a Google Ads campaign. It is always created PAUSED and there is no option to create it active: someone has to look at it before it spends. Creates the campaign budget too. Previews by default.
• google_ads_generate_ad_group_themes: Organize supplied keywords into existing Google Ads ad groups. Returns suggested ad group/campaign pairings, normalized keyword text, and suggested match type without creating or editing keywords. Read-only Keyword Planner RPC.
• google_ads_generate_keyword_forecast_metrics: Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. Supports targeting, negatives, match type, three bidding strategies, explicit future dates, and an optional independent per-keyword breakdown. This read-only planless RPC does not create a campaign or saved plan.
• google_ads_generate_keyword_historical_metrics: Get Keyword Planner search-volume history for supplied keywords. Returns average monthly searches, monthly volumes (up to 48 months), latest volume, computed 3-month and YoY changes, competition, CPC/bid ranges, close variants, and optional device totals. This is a read-only planless RPC.
• google_ads_generate_keyword_ideas: Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. Returns historical volume, monthly trends, computed 3-month/YoY changes, competition, bids, close variants, optional concepts, and pagination. Read-only; no plan is saved.
• google_ads_get_account_details: Get detailed information for a specific Google Ads customer account.
• google_ads_get_account_hierarchy: List accessible customers and, where possible, manager/client relationships from GAQL customer_client. Falls back to accessible customers if hierarchy queries are unavailable.
• google_ads_get_adgroups: List ad groups for a Google Ads account, optionally filtered by campaign.
• google_ads_get_bidding_strategies: List portfolio bidding strategies. Includes metrics only when startDate/endDate are provided; otherwise returns structure only.
• google_ads_get_budgets: List campaign budgets with amount, status, delivery method, and recommended budget fields when supported.
• google_ads_get_campaigns: List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.
• google_ads_get_change_events: Fetch recent change_event rows. Enforces Google Ads constraints: date window within the last 30 days and LIMIT <= 10000.
• google_ads_get_conversion_actions: List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported.
• google_ads_get_demand_gen_assets: List Demand Gen ads (video responsive, multi-asset, carousel) with their referenced creatives resolved: stable image URLs and YouTube video IDs with embed and thumbnail URLs. Complements google_ads_get_pmax_assets, which covers Performance Max.
• google_ads_get_insights: Query Google Ads performance insights with intelligent query planning. Auto-generates GAQL, handles metric/segment incompatibilities by splitting queries. Use google-ads://metrics for available metrics, google-ads://dimensions for dimensions.
• google_ads_get_keyword_performance: Get keyword-level performance data from keyword_view resource. Shows quality score, impressions, clicks, cost.
• google_ads_get_landing_pages: Fetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported.
• google_ads_get_paid_organic_search_terms: Read-only paid/organic search terms report. Uses paid_organic_search_term_view when available and falls back to paid-only search_term_view if organic fields are unavailable.
• google_ads_get_pmax_asset_diagnostics: Read-only Performance Max asset group diagnostics. Returns ad strength, asset coverage action items, primary status reasons, optional performance metrics, and optional top asset combinations.
• google_ads_get_pmax_assets: List Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics.
• google_ads_get_pmax_placements: Read-only Performance Max placement diagnostics from performance_max_placement_view. Returns placement type, display name, target URL, campaign context, and impressions only.
• google_ads_get_recommendations: List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.
• google_ads_get_search_terms: Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.
• google_ads_get_shopping_performance: Read-only Shopping performance report keyed by Merchant Center product dimensions. Useful for joining spend/conversions to merchant ID, item ID, title, brand, feed label, and custom labels.
• google_ads_get_shopping_products: Read-only Merchant Center product catalog/eligibility report via shopping_product. Supports account, campaign, and ad group scopes with performance metrics when the account has Shopping/PMax e-commerce data.
• google_ads_get_simulations: Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. Returns simulation metadata and projected point lists when available, with a metadata fallback.
• google_ads_get_video_upload: Read the processing state and YouTube video ID of one Google Ads upload in the selected customer. Use only the returned videoId after state=PROCESSED. This is a read; it does not upload again.
• google_ads_health_check: Read-only connectivity check. Verifies credential presence, Google Ads API access, login customer visibility, API version, and actionable warnings without returning secrets.
• google_ads_list_accounts: List Google Ads customer accounts accessible with the current credentials. If an accessible customer is a manager account, also attempts to include enabled child accounts from customer_client.
• google_ads_list_image_assets: List the account's image asset library (FROM asset) with stable, publicly served full-size URLs on tpc.googlesyndication.com, dimensions, file size, and mime type. This is the whole stock and carries no notion of delivery: an asset uploaded in 2022 and never served appears exactly like one running today. Newest first, so a limit returns recent assets rather than an arbitrary slice, and the count in the response is the account total. For a visual-only gallery of assets with delivery over dates, use get_creative_gallery (Performance Max coverage). Request get_creative_performance only when KPI cards are wanted. Shopping product imagery lives in Merchant Center, not in this library.
• google_ads_list_video_assets: List the account's YouTube video assets (FROM asset) with derived watch, embed, and public thumbnail URLs. This is the whole stock and carries no notion of delivery: an asset uploaded years ago and never served appears exactly like one running today. Newest first, so a limit returns recent assets rather than an arbitrary slice, and the count in the response is the account total. For a visual-only gallery of assets with delivery over dates, use get_creative_gallery (Performance Max coverage). Request get_creative_performance only when KPI cards are wanted. Google Ads exposes no downloadable video file: PMax and Demand Gen videos are hosted on YouTube, so display them via embed or thumbnails.
• google_ads_remove_video_upload (write): Remove a video upload owned by the selected ad account. Deletes the uploaded YouTube video and can break ads referencing it. Preview and matching expectedPlanHash required. Google v25 marks title/description immutable; this tool does not pretend to edit them.
• google_ads_rename_campaign (write): Rename a Google Ads campaign. The name is the only thing that changes: delivery, budget and targeting are untouched. Previews by default.
• google_ads_run_gaql: Execute a raw GAQL (Google Ads Query Language) query. Full flexibility for any reporting need. Example: SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100.
• google_ads_run_readonly_rpc: Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, identity verification, invoices, and payments accounts. The operation is an enum; arbitrary paths and all mutations/uploads are impossible.
• google_ads_search_fields: Search Google's live GoogleAdsField catalog. Discovers every queryable GAQL resource, attribute, segment, metric, enum value, and selectable-with compatibility relationship. Read-only and useful before a raw GAQL query.
• google_ads_suggest_geo_targets: Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. Returns criterion IDs, canonical names, target types, status, parents, locale, and approximate reach. Read-only.
• google_ads_update_adgroup_bid (write): Change the default CPC bid of a Google Ads ad group. The amount is in the account currency (1.20 for 1.20 EUR). Has no effect on a campaign using an automated bidding strategy. Previews by default.
• google_ads_update_adgroup_status (write): Pause, re-enable or remove a Google Ads ad group. Previews by default.
• google_ads_update_campaign_budget (write): Change the daily budget of a Google Ads campaign. The amount is in the account currency (12.50 for 12.50 EUR). Previews by default.
• google_ads_update_campaign_schedule (write): Change the start or end date of a Google Ads campaign. Dates are YYYY-MM-DD in the account time zone. Previews by default.
• google_ads_update_campaign_status (write): Pause, re-enable or remove a Google Ads campaign. Previews by default: without confirm: true, the tool describes the change without applying it.
• google_ads_upload_video (write): Upload MP4/WebM/QuickTime bytes (max 16 MiB) to the Google-managed YouTube channel for the selected ad account. Visibility is UNLISTED: viewable by anyone with the link, not private. Default preview omits bytes and returns planHash; confirm requires expectedPlanHash. This API has no validateOnly. After upload, query you_tube_video_upload.state and video_id with google_ads_run_gaql; only use the video ID after PROCESSED, via google_ads_apply_plan assetOperation.youtubeVideoAsset. No automatic retry after an uncertain upload.
• google_ads_validate_query: Validate metric/dimension/resource compatibility BEFORE executing a query. Checks segment restrictions and resource availability.

TikTok Ads (64 tools, 29 write)

Available for authorized, selected accounts.

• tiktok_create_adgroup (write): Create DISABLED classic TikTok adgroup. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_create_ads (write): Create DISABLED classic TikTok ads (video, image, carousel or authorized Spark content). No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_create_campaign (write): Create a TikTok campaign. It is always created disabled and there is no option to create it running. Previews by default.
• tiktok_create_campaign_advanced (write): Create DISABLED classic TikTok campaign. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_create_cta_portfolio (write): Create a dynamic CTA portfolio from the exact approved recommendations returned by creative/cta/recommend for this advertiser. Use its result.creative_portfolio_id as ad_configuration.call_to_action_id for Smart+ Spark website/app ads. Creates no ad and changes no delivery status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_create_custom_identity (write): Create an advertiser-owned CUSTOMIZED_USER advertising identity for Pangle or Global App Bundle. Does not create a public TikTok profile or enable delivery. Custom identities cannot be used for new TikTok-placement ads. Uses TikTok’s default avatar. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_create_smart_plus_ad (write): Create DISABLED upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content). No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_create_smart_plus_adgroup (write): Create DISABLED upgraded Smart+ TikTok adgroup. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_create_smart_plus_campaign (write): Create DISABLED upgraded Smart+ TikTok campaign. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_get_adgroups: Read full native ad group configuration including targeting, custom/lookalike audience references and exclusions, geo, language, age/gender, placements, interests/behaviors, budget and schedule. Set smartPlus:true for upgraded Smart+ targeting_spec. Missing fields are unknown, not unrestricted targeting. Paginated.
• tiktok_get_ads: List ads for a TikTok advertiser. Returns ad ID, name, operation status, and creative info.
• tiktok_get_advertiser_info: Get detailed information for specific TikTok advertiser accounts: currency, timezone, status, balance.
• tiktok_get_asset_urls: Re-resolve fresh, publicly fetchable URLs for specific TikTok library assets (file/video/ad/info and file/image/ad/info). Call at display or download time: every TikTok media URL is signed and expires.
• tiktok_get_async_report_status: Check a TikTok async report task status by taskId when async report endpoints are available. No report creation or mutation is performed.
• tiktok_get_audience_details: Get custom/lookalike/saved audience details where TikTok DMP endpoints are accessible. Read-only only.
• tiktok_get_audience_overlap: Read-only audience overlap diagnostics across ad groups, custom audiences, saved audiences, and targeting fields.
• tiktok_get_audience_report: Read TikTok AUDIENCE performance reports by age or gender at advertiser, campaign, ad group or ad level, including delivery from eligible Smart+ campaigns. Multiple demographics return separate reports, not a joint distribution. Explicit pagination and native provider errors; no inference of configured targeting or Custom Audience membership.
• tiktok_get_audiences: List custom and lookalike audiences for a TikTok advertiser account.
• tiktok_get_campaigns: List campaigns for a TikTok advertiser account. Returns campaign ID, name, status, budget, and objective.
• tiktok_get_carousel_music: Get TikTok music recommendations for exactly the uploaded images in a standard, non-catalog image ad (one card) or carousel. Verifies each image is carousel-usable. Read-only; select a returned music_id in the approval preview and use the same images in the ad. Music is for use on TikTok only.
• tiktok_get_creative_fatigue_recipes: Find likely creative fatigue patterns from ad-level daily reporting and return read-only refresh recipes. Does not create, edit, or upload creatives.
• tiktok_get_creatives: Get creative details (video, image, text) for specific ads in a TikTok advertiser account.
• tiktok_get_delivery_status: Aggregate campaign, ad group, and ad delivery status/operation_status with simple diagnostics.
• tiktok_get_entities_raw: List TikTok campaigns, ad groups, or ads with caller-selected native fields, filtering, sorting, and pagination. This GET-only escape hatch exposes newly released entity fields without waiting for the MCP's curated schemas.
• tiktok_get_events: Discover pixel/app events or accessible tracking diagnostics for an advertiser. Uses best-effort endpoint checks plus reporting dimensions as fallback.
• tiktok_get_insights: Query TikTok Ads performance insights using the current native/calculated metric catalog and query planning. Use tiktok://metrics resource to see available metrics. Use tiktok://dimensions for dimensions. Age/gender dimensions route automatically to AUDIENCE reports via tiktok_get_audience_report, including campaign/ad group levels. Other dimensions use the BASIC planner. Multiple audience breakdowns remain separate reports, never joined.
• tiktok_get_pixels: List TikTok pixels and, when permissions allow it, pixel event metadata for an advertiser. Falls back with explicit warnings when endpoints are unavailable.
• tiktok_get_read_endpoint: Advanced GET-only TikTok Business API escape hatch for documented JSON read endpoints not yet modeled by a specialized MCP tool. Relative v1.3 paths and JSON-compatible query parameters are validated; OAuth, mutations, downloads, and lead-record paths are blocked.
• tiktok_get_report_raw: Run a native TikTok BASIC or AUDIENCE synchronous report with caller-selected dimensions and metrics. AUDIENCE supports demographics such as age/gender at campaign/adgroup levels; tiktok_get_audience_report provides a guided path. Use when a current API field is not yet in tiktok://metrics; unlike tiktok_get_insights, this tool does not calculate aliases or auto-split incompatible selections.
• tiktok_get_search_ads_maturity: Diagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints. Read-only diagnostics only.
• tiktok_get_shop_catalog_diagnostics: Read-only TikTok Shop/catalog/e-commerce diagnostics. Tries catalog reporting first, then Shop auction metrics, and returns endpoint warnings when catalog permissions are unavailable.
• tiktok_get_spark_ads: Return Spark Ads context from ad fields when available, with a conservative fallback if Spark-specific fields are not supported.
• tiktok_get_spark_organic_joins: Join accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow. Read-only only.
• tiktok_get_targeting: Read configured ad group targeting and audience references: custom/lookalike inclusions/exclusions, geo, language, age/gender, placements, interests and behaviors. Supports classic and upgraded Smart+ (smartPlus:true), preserving targeting_spec and automatic targeting settings. Does not infer delivered audiences or hidden Smart+ signals. Use tiktok_get_audiences for audience names/types and tiktok_get_audience_report for delivered demographics.
• tiktok_get_targeting_catalog: Read TikTok targeting and planning catalogs: locations, languages, interests, behaviors, hashtags, Search Ads keyword ideas/health, devices, carriers, contextual tags, content exclusions, and time zones.
• tiktok_get_uploaded_video: Read one uploaded video from this advertiser’s media library. Returns ready only after its media information is available with positive duration and dimensions. Does not upload again.
• tiktok_get_video_assets: Return ad-linked TikTok video asset metadata from ad/get and video material endpoints when available.
• tiktok_get_write_context: Read the exact TikTok entity, parent settings and advertiser currency/timezone before editing or building a new configuration. Read-only.
• tiktok_health_check: Read-only health check for TikTok credentials, accessible advertisers, and advertiser info. Never returns tokens or secrets.
• tiktok_list_ad_images: List the advertiser's whole image library (file/image/ad/search): file name, dimensions, signature, carousel usability, and a publicly served image URL signed for roughly thirty days (image_url_expires_at gives the exact instant).
• tiktok_list_ad_videos: List the advertiser's whole video library (file/video/ad/search): file name, duration, dimensions, signature, and publicly served preview and cover URLs. Every TikTok URL is signed and expires after roughly six hours: re-resolve with tiktok_get_asset_urls before use.
• tiktok_list_advertisers: List all TikTok advertiser accounts accessible with the current token. Returns advertiser ID, name, and status.
• tiktok_rename_ad (write): Rename one classic TikTok ad. Does not change its budget, creative content or status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_rename_adgroup (write): Rename one classic TikTok adgroup. Does not change its budget, creative content or status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_rename_campaign (write): Rename one classic TikTok campaign. Does not change its budget, creative content or status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_search_keywords: Get keyword suggestions for TikTok Search Ads. Returns recommended keywords with search volume estimates.
• tiktok_update_ad_status (write): Pause or reactivate exactly one classic ad. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_adgroup_budget (write): Change the budget of a TikTok ad group. Amount in the account currency, sent as is. Previews by default.
• tiktok_update_adgroup_configuration (write): Update classic TikTok adgroup. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_adgroup_status (write): Pause or reactivate a TikTok ad group. Previews by default.
• tiktok_update_ads (write): Update classic TikTok ads (video, image, carousel or authorized Spark content). Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_campaign_budget (write): Change a TikTok campaign budget, in the account currency. Previews by default.
• tiktok_update_campaign_configuration (write): Update classic TikTok campaign. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_campaign_status (write): Pause or reactivate a TikTok campaign. Previews by default.
• tiktok_update_smart_plus_ad (write): Update upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content). Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_smart_plus_ad_status (write): Pause or reactivate exactly one Smart+ ad. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_smart_plus_adgroup (write): Update upgraded Smart+ TikTok adgroup. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_smart_plus_adgroup_status (write): Pause or reactivate exactly one Smart+ adgroup. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_smart_plus_campaign (write): Update upgraded Smart+ TikTok campaign. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_smart_plus_campaign_status (write): Pause or reactivate exactly one Smart+ campaign. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_update_smart_plus_material_status (write): Pause or reactivate selected creative materials inside one upgraded Smart+ ad. Parent campaign, ad group and ad statuses are unchanged; the shared library asset is not modified. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_upload_ad_image (write): Import a image from a public HTTPS media URL or base64 file (up to 5 MiB). A single returned media ID is exposed at media.id, with the native receipt preserved in result. TikTok may process it asynchronously; acceptance is not proof the media is ready. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_upload_ad_video (write): Import a video from a public HTTPS media URL or base64 file (up to 5 MiB). A single returned media ID is exposed at media.id, with the native receipt preserved in result. TikTok may process it asynchronously; acceptance is not proof the media is ready. Local preview by default. No automatic retry; advertiser ownership is checked before applying.
• tiktok_validate_query: Validate a TikTok metric/dimension combination BEFORE executing. Checks dimension grouping rules, lifetime compatibility, and metric/dimension compatibility.

Search Console (18 tools, 0 write)

Available for authorized, selected accounts.

• gsc_analyze_search_appearance_trends: Analyze structured data and rich-result trend signals via the Search Analytics searchAppearance dimension when GSC exposes it.
• gsc_bulk_inspect_urls: Inspect multiple URLs with a conservative sequential limit and normalized URL Inspection results. Quota: 2000 requests/day/property.
• gsc_cluster_queries: Cluster Search Console queries by simple tokens and intent signals: brand/non-brand, question, category, and topic tokens.
• gsc_compare_search_types: Compare performance across Search Console search types: web, image, video, news, discover, and Google News.
• gsc_detect_cannibalization: Detect queries where multiple pages compete for clicks/impressions in Search Analytics query-page rows.
• gsc_find_losses_gains: Compare two periods for query or page performance and return click/impression/CTR/position deltas.
• gsc_get_data_freshness: Detect the most recent date with Search Analytics data by querying recent daily rows.
• gsc_get_sitemap_health: Return an enriched read-only sitemap health summary with status totals, submitted/indexed content counts, warnings, and errors.
• gsc_health_check: Verify Google Search Console read-only authentication, visible properties, configured default site, and permission levels without exposing tokens.
• gsc_indexation_watchlist: Read-only URL Inspection watchlist for critical URLs. Inspects up to 10 URLs and returns alert/review/ok assessments without storing state.
• gsc_inspect_url: Inspect a URL for Google indexing status, crawl info, mobile usability, AMP, and rich results. Quota: 2000 requests/day/property.
• gsc_list_sitemaps: List sitemaps submitted for a Search Console property, including processing status and submitted/indexed counts.
• gsc_list_sites: List all Google Search Console properties accessible with the current credentials.
• gsc_monitor_indexation_freshness: Read-only monitoring snapshot for Search Analytics freshness, sitemap indexation totals, and an optional small URL Inspection sample.
• gsc_plan_large_site_sampling: Build a read-only URL Inspection sampling plan for large sites from sitemap risk signals and Search Analytics page performance.
• gsc_query_search_analytics: Query Google Search Console Search Analytics. Returns clicks, impressions, CTR, and average position for queries, pages, countries, devices, dates, and search appearances. Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for available fields and rules.
• gsc_track_sitemap_deltas: Read-only sitemap delta tracker. Fetches the current sitemap snapshot and compares it to an agent-provided baseline; no state is written.
• gsc_validate_query: Validate a Search Console metric/dimension/search type combination before executing it.

Google Analytics 4 (27 tools, 0 write)

Available for authorized, selected accounts.

• ga4_batch_run_pivot_reports: Run 1-5 independent read-only GA4 pivot reports for the same property in one official Data API batch request.
• ga4_batch_run_reports: Run 1-5 independent read-only GA4 Core reports for the same property in one official Data API batch request.
• ga4_check_compatibility: Ask the official GA4 Data API which dimensions and metrics are compatible with a proposed Core report selection.
• ga4_get_audience_diagnostics: Read-only audience diagnostics from Admin API audiences, Data API recurring audience lists, and observed audienceName report fallback.
• ga4_get_audience_export_diagnostics: Read-only Audience Export diagnostics. Lists existing audience exports, state counts, and optionally samples rows from an existing export.
• ga4_get_bigquery_export_diagnostics: Detect GA4 BigQuery export links and diagnose export modes, stream coverage, excluded events, and dataset location.
• ga4_get_channel_groups: List custom channel groups defined for a GA4 property.
• ga4_get_custom_definitions: List custom dimensions and custom metrics exposed by GA4 Data API metadata. Read-only fallback for custom definition inventory.
• ga4_get_ecommerce_diagnostics: Read-only ecommerce coverage diagnostics for core ecommerce events, revenue metrics, and item-level reporting over a date range.
• ga4_get_event_parameters: Best-effort event parameter inventory from GA4 metadata plus event reports. Documents Data API limitations for raw parameters.
• ga4_get_key_events: Inventory GA4 key events/conversions using metadata-aware Data API reports. Returns best-effort event names and counts.
• ga4_get_metadata: Get the complete list of dimensions and metrics available for a specific GA4 property. Useful for discovering custom dimensions/metrics.
• ga4_get_property_configuration: Read GA4 property details plus selected singleton Admin settings (attribution, retention, Google Signals, reporting identity, or user-provided-data settings).
• ga4_get_property_quotas_snapshot: Read the current GA4 Data API property quota snapshot from the official v1alpha endpoint. This does not run a report, but Google still charges one property-quota token to the category with the most remaining quota.
• ga4_get_server_side_tagging_diagnostics: Best-effort read-only server-side tagging diagnostics from data streams, Measurement Protocol secrets, event rules, and stream settings.
• ga4_health_check: Read-only GA4 health check. Verifies configured credentials, accessible properties, and metadata/property access without exposing OAuth tokens.
• ga4_list_accounts: List raw GA4 Analytics Admin accounts accessible to the authenticated user (read-only, auto-paginated).
• ga4_list_admin_resources: List an allowlisted GA4 Admin collection in read-only mode: streams, custom definitions, key events, audiences, product links, annotations, channel groups, expanded datasets, subproperty/rollup configuration, and access bindings.
• ga4_list_audience_exports: List existing GA4 Audience Export snapshots and Recurring Audience Lists without creating new exports.
• ga4_list_properties: List all GA4 properties accessible with the current credentials. Returns property ID, display name, timezone, and currency.
• ga4_query_audience_export: Query rows from an existing GA4 Audience Export. User/device identifiers are redacted by default; include them only through explicit opt-in.
• ga4_run_advanced_funnel_report: Run the GA4 Data API v1alpha runFunnelReport endpoint with optional breakdown/next-action, falling back to read-only step counts if unavailable.
• ga4_run_funnel_recipe: Run a read-only configurable funnel recipe using one GA4 report per eventName/pagePath step and return simple step counts.
• ga4_run_pivot_report: Run a read-only GA4 Data API pivot report with native filters, ordering, quota state, multiple date ranges, and up to 250,000 pivot cells. Every pivot requires an explicit limit.
• ga4_run_realtime_report: Run a read-only GA4 Data API realtime report. Realtime supports only a limited subset of dimensions and metrics.
• ga4_run_report: Run a GA4 analytics report with intelligent query planning. Supports 52 metrics, 63 dimensions, auto-pagination. Use ga4://metrics and ga4://dimensions resources for available fields. Max 9 dimensions + 10 metrics per request.
• ga4_validate_query: Validate a metric/dimension combination BEFORE executing. Checks max limits (9 dims, 10 metrics), ecommerce rules, and dimension compatibility.