Get MCP Ads

npx add-mcp 'https://mcp.getmcpads.com/mcp'

Tool catalogue

388 implemented tools across 9 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.

Reddit Ads (50 tools, 19 write)

External assistant access is pending Reddit clarification. Authorized operators can manage the test connection; the implemented tools are documented here but are not publicly callable yet.

• 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)

External assistant access is not enabled. Sandbox testing and production account discovery are available to authorized operators. Publisher and external-tenant consent verification remain in progress; the developer token has already been obtained.

• 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 (41 tools, 21 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_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_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_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_media (write): Upload base64 image/video bytes to a previously created media object. Maximum 10 MiB decoded. 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.

Meta Ads (57 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 Meta campaign. It is always created PAUSED and there is no option to create it active. Previews by default.
• 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: Query Meta Ads performance insights. Supports 170+ metrics, 43+ breakdowns with intelligent query planning. Use meta://metrics resource to see available metrics. Use meta://breakdowns for available breakdowns. The query planner automatically splits incompatible metric/breakdown combinations into multiple API requests and merges results.
• 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_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_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 the daily or lifetime budget of a Meta ad set. Amount in the account currency (12.50 for 12.50 EUR). Meta expects minor units, the conversion is done here. Previews by default.
• 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 the start or end time of a Meta ad set. Times are ISO 8601 with an offset, for example 2026-09-01T00:00:00+0200. Previews by default.
• 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 the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget). On a campaign without one, Meta refuses and the ad set budget is the one to change. Amount in the account currency. Previews by default.
• 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 (52 tools, 24 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. 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_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_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_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_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 (44 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_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 (60 tools, 27 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_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_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_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). 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). 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.