# Tool catalogue

185 tools across 6 sources, served from 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.

## Meta Ads (39 tools, 10 write)

- `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_get_business_assets`: Discover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow.
- `meta_get_pages`: List accessible Facebook Pages with id, name, category, tasks, picture, and linked Instagram account references when available.
- `meta_get_instagram_accounts`: List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow.
- `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_ad_activity`: Read ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields.
- `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_creative_assets`: Return normalized creative asset metadata for ads or creative IDs: thumbnail, object_story_spec, asset_feed_spec, video/image/link URL, CTA, and page/IG references.
- `meta_get_audience_details`: Read detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow.
- `meta_get_catalog_products`: Read Product Catalogs and Product Items when catalog access is available.
- `meta_join_product_insights`: Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.
- `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_interpret_experiment_results`: Read and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities.
- `meta_get_organic_content_enrichment`: Enrich Facebook Page posts and Instagram organic media with media URLs, permalinks, counts, attachments, and optional read-only insights.
- `meta_list_ad_accounts`: List all Meta ad accounts accessible with the current token.
- `meta_get_account_details`: Get detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info.
- `meta_get_campaigns`: List campaigns for a Meta ad account. Returns campaign ID, name, status, objective, budget, and bid strategy.
- `meta_get_adsets`: List ad sets for a Meta ad account, optionally filtered by campaign.
- `meta_get_ads`: List ads for a Meta ad account, optionally filtered by ad set.
- `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_get_campaign_structure`: Get hierarchical campaign structure: campaigns -> ad sets -> ads.
- `meta_get_creatives`: Get ad creative content: text, images, videos, links, call-to-action.
- `meta_get_audiences`: List custom, saved, and lookalike audiences for a Meta ad account.
- `meta_get_ad_studies`: List conversion lift studies and A/B tests (Ad Studies) for an ad account.
- `meta_get_study_results`: Get detailed results for a conversion lift or A/B test study.
- `meta_validate_query`: Validate a metric/breakdown combination BEFORE executing.
- `meta_get_page_posts`: Get recent posts from a connected Facebook/Instagram page.
- `meta_debug_token`: Check the current access token validity, expiration, and granted scopes.
- `meta_search_entities`: Search campaigns, ad sets, or ads by name within an ad account.
- `meta_update_campaign_status` (write): Pause or reactivate a Meta campaign.
- `meta_update_adset_status` (write): Pause or reactivate a Meta ad set.
- `meta_update_ad_status` (write): Pause or reactivate a single Meta ad.
- `meta_update_adset_budget` (write): Change an ad set's daily or lifetime budget, in the account currency.
- `meta_create_campaign` (write): Create a Meta campaign. Always created PAUSED, with no option to create it active.
- `meta_rename_ad` (write): Rename a Meta ad. The name is the only thing that changes.
- `meta_rename_adset` (write): Rename a Meta ad set. The name is the only thing that changes.
- `meta_rename_campaign` (write): Rename a Meta campaign. The name is the only thing that changes.
- `meta_update_adset_schedule` (write): Change the start or end time of a Meta ad set.
- `meta_update_campaign_budget` (write): Change the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget).

## Pinterest Ads (31 tools, 5 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.
- `pinterest_list_ad_accounts`: List Pinterest ad accounts accessible to the configured credentials.
- `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_validate_report`: Validate and preview how a Pinterest report will execute.
- `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_get_creative_assets`: Fetch Pinterest creative assets and period performance when available.
- `pinterest_run_catalog_report`: Run Pinterest catalog reporting by PRODUCT_GROUP or PRODUCT_ITEM.
- `pinterest_get_catalog_inventory`: List Pinterest catalog inventory surfaces: catalogs, product groups, product group promotions, and optional product samples.
- `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.
- `pinterest_get_account_entities`: Read Pinterest ad-account entities and configuration.
- `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_get_targeting_options`: Read Pinterest's official targeting option catalog for app type, gender, locale, age, location/geo, interest, keyword, or audience.
- `pinterest_get_keyword_intelligence`: Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms.
- `pinterest_get_audiences`: Read audience, customer-list, sharing, and Business-received audience inventory without uploading or changing audience membership.
- `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_estimate_delivery`: Run non-mutating Pinterest planning computations: ad-group audience size, bid floors, or campaign delivery estimates.
- `pinterest_get_conversion_setup`: Inspect Pinterest conversion measurement configuration: conversion tags, oCPM-eligible/page-visit tags, Event Quality Score, advertiser-defined events, and.
- `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.
- `pinterest_run_specialized_export`: Start or inspect non-mutating Pinterest data jobs for Marketing Mix Modeling (MMM), bulk advertiser entity downloads, or catalog diagnostics.
- `pinterest_get_lead_assets`: Read lead-form definitions and lead subscription configuration.
- `pinterest_get_business_assets`: Read Pinterest Business Access inventory: employers/linked businesses, assets, members, partners, assigned assets, received audiences, and invites.
- `pinterest_get_billing_and_orders`: Read billing profiles/invoices, invoice download URLs, order lines, ads-credit discounts, and SSIO account/order status.
- `pinterest_get_pin_analytics`: Read paid Pin analytics, organic multi/single-Pin analytics, user-account analytics, top Pins, or top video Pins.
- `pinterest_get_organic_inventory`: Read organic Pinterest content used alongside ads: Pins, boards, Pins on a board, Pin product tags, or search results.
- `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.
- `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.
- `pinterest_update_campaign_status` (write): Pause, reactivate or archive a Pinterest campaign.
- `pinterest_update_campaign_budget` (write): Change a Pinterest campaign's daily or lifetime spend cap.
- `pinterest_create_campaign` (write): Create a Pinterest campaign. Always created PAUSED, with no option to create it active.
- `pinterest_update_adgroup_budget` (write): Change the daily or lifetime budget of a Pinterest ad group.
- `pinterest_update_adgroup_status` (write): Pause, reactivate or archive a Pinterest ad group.

## Google Ads (38 tools, 7 write)

- `google_ads_list_accounts`: List Google Ads customer accounts accessible with the current credentials.
- `google_ads_get_account_details`: Get detailed information for a specific Google Ads customer account.
- `google_ads_run_gaql`: Execute a raw GAQL (Google Ads Query Language) query.
- `google_ads_get_insights`: Query Google Ads performance insights with intelligent query planning.
- `google_ads_get_campaigns`: List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.
- `google_ads_get_adgroups`: List ad groups for a Google Ads account, optionally filtered by campaign.
- `google_ads_get_keyword_performance`: Get keyword-level performance data from keyword_view resource.
- `google_ads_validate_query`: Validate metric/dimension/resource compatibility BEFORE executing a query.
- `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_get_account_hierarchy`: List accessible customers and, where possible, manager/client relationships from GAQL customer_client.
- `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_change_events`: Fetch recent change_event rows. Enforces Google Ads constraints: date window within the last 30 days and LIMIT <= 10000.
- `google_ads_get_recommendations`: List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.
- `google_ads_get_budgets`: List campaign budgets with amount, status, delivery method, and recommended budget fields when supported.
- `google_ads_get_bidding_strategies`: List portfolio bidding strategies. Includes metrics only when startDate/endDate are provided; otherwise returns structure only.
- `google_ads_get_search_terms`: Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.
- `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_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_simulations`: Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations.
- `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_shopping_products`: Read-only Merchant Center product catalog/eligibility report via shopping_product.
- `google_ads_get_shopping_performance`: Read-only Shopping performance report keyed by Merchant Center product dimensions.
- `google_ads_get_pmax_placements`: Read-only Performance Max placement diagnostics from performance_max_placement_view.
- `google_ads_get_pmax_asset_diagnostics`: Read-only Performance Max asset group diagnostics.
- `google_ads_update_campaign_status` (write): Pause, re-enable or remove a Google Ads campaign.
- `google_ads_update_campaign_budget` (write): Change a campaign's daily budget, in the account currency.
- `google_ads_create_campaign` (write): Create a Google Ads campaign with its budget. Always created PAUSED, with no option to create it active.
- `google_ads_generate_ad_group_themes`: Organize supplied keywords into existing Google Ads ad groups.
- `google_ads_generate_keyword_forecast_metrics`: Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign.
- `google_ads_generate_keyword_historical_metrics`: Get Keyword Planner search-volume history for supplied keywords.
- `google_ads_generate_keyword_ideas`: Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site.
- `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...
- `google_ads_search_fields`: Search Google's live GoogleAdsField catalog.
- `google_ads_suggest_geo_targets`: Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants.
- `google_ads_rename_campaign` (write): Rename a Google Ads campaign. Delivery, budget and targeting are untouched.
- `google_ads_update_adgroup_bid` (write): Change the default CPC bid of a Google Ads ad group.
- `google_ads_update_adgroup_status` (write): Pause, re-enable or remove a Google Ads ad group.
- `google_ads_update_campaign_schedule` (write): Change the start or end date of a Google Ads campaign.

## TikTok Ads (32 tools, 5 write)

- `tiktok_health_check`: Read-only health check for TikTok credentials, accessible advertisers, and advertiser info.
- `tiktok_list_advertisers`: List all TikTok advertiser accounts accessible with the current token.
- `tiktok_get_advertiser_info`: Get detailed information for specific TikTok advertiser accounts: currency, timezone, status, balance.
- `tiktok_get_campaigns`: List campaigns for a TikTok advertiser account.
- `tiktok_get_adgroups`: List ad groups for a TikTok advertiser. Returns targeting, budget, optimization goal, and schedule info.
- `tiktok_get_ads`: List ads for a TikTok advertiser. Returns ad ID, name, operation status, and creative info.
- `tiktok_get_insights`: Query TikTok Ads performance insights. Supports 400+ metrics with intelligent query planning. Use tiktok://metrics resource to see available metrics. Use tiktok://dimensions.
- `tiktok_get_creatives`: Get creative details (video, image, text) for specific ads in a TikTok advertiser account.
- `tiktok_get_audiences`: List custom and lookalike audiences for a TikTok advertiser account.
- `tiktok_search_keywords`: Get keyword suggestions for TikTok Search Ads.
- `tiktok_validate_query`: Validate a TikTok metric/dimension combination BEFORE executing.
- `tiktok_get_pixels`: List TikTok pixels and, when permissions allow it, pixel event metadata for an advertiser.
- `tiktok_get_events`: Discover pixel/app events or accessible tracking diagnostics for an advertiser.
- `tiktok_get_delivery_status`: Aggregate campaign, ad group, and ad delivery status/operation_status with simple diagnostics.
- `tiktok_get_async_report_status`: Check a TikTok async report task status by taskId when async report endpoints are available.
- `tiktok_get_video_assets`: Return ad-linked TikTok video asset metadata from ad/get and video material endpoints when available.
- `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_audience_details`: Get custom/lookalike/saved audience details where TikTok DMP endpoints are accessible.
- `tiktok_get_shop_catalog_diagnostics`: Read-only TikTok Shop/catalog/e-commerce diagnostics.
- `tiktok_get_search_ads_maturity`: Diagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints.
- `tiktok_get_creative_fatigue_recipes`: Find likely creative fatigue patterns from ad-level daily reporting and return read-only refresh recipes.
- `tiktok_get_audience_overlap`: Read-only audience overlap diagnostics across ad groups, custom audiences, saved audiences, and targeting fields.
- `tiktok_get_spark_organic_joins`: Join accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow.
- `tiktok_update_campaign_status` (write): Pause or reactivate a TikTok campaign.
- `tiktok_update_campaign_budget` (write): Change a TikTok campaign budget, in the account currency.
- `tiktok_create_campaign` (write): Create a TikTok campaign. Always created PAUSED, with no option to create it active.
- `tiktok_get_entities_raw`: List TikTok campaigns, ad groups, or ads with caller-selected native fields, filtering, sorting, and pagination.
- `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.
- `tiktok_get_report_raw`: Run a native TikTok synchronous report with caller-selected dimensions and metrics.
- `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_update_adgroup_budget` (write): Change the budget of a TikTok ad group.
- `tiktok_update_adgroup_status` (write): Pause or reactivate a TikTok ad group.

## Search Console (18 tools, 0 write)

- `gsc_list_sites`: List all Google Search Console properties accessible with the current credentials.
- `gsc_health_check`: Verify Google Search Console read-only authentication, visible properties, configured default site, and permission levels without exposing tokens.
- `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..
- `gsc_inspect_url`: Inspect a URL for Google indexing status, crawl info, mobile usability, AMP, and rich results.
- `gsc_bulk_inspect_urls`: Inspect multiple URLs with a conservative sequential limit and normalized URL Inspection results.
- `gsc_list_sitemaps`: List sitemaps submitted for a Search Console property, including processing status and submitted/indexed counts.
- `gsc_get_sitemap_health`: Return an enriched read-only sitemap health summary with status totals, submitted/indexed content counts, warnings, and errors.
- `gsc_compare_search_types`: Compare performance across Search Console search types: web, image, video, news, discover, and Google News.
- `gsc_get_data_freshness`: Detect the most recent date with Search Analytics data by querying recent daily rows.
- `gsc_monitor_indexation_freshness`: Read-only monitoring snapshot for Search Analytics freshness, sitemap indexation totals, and an optional small URL Inspection sample.
- `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_analyze_search_appearance_trends`: Analyze structured data and rich-result trend signals via the Search Analytics searchAppearance dimension when GSC exposes it.
- `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_indexation_watchlist`: Read-only URL Inspection watchlist for critical URLs.
- `gsc_find_losses_gains`: Compare two periods for query or page performance and return click/impression/CTR/position deltas.
- `gsc_cluster_queries`: Cluster Search Console queries by simple tokens and intent signals: brand/non-brand, question, category, and topic tokens.
- `gsc_detect_cannibalization`: Detect queries where multiple pages compete for clicks/impressions in Search Analytics query-page rows.
- `gsc_validate_query`: Validate a Search Console metric/dimension/search type combination before executing it.

## Google Analytics 4 (27 tools, 0 write)

- `ga4_health_check`: Read-only GA4 health check. Verifies configured credentials, accessible properties, and metadata/property access without exposing OAuth tokens.
- `ga4_list_properties`: List all GA4 properties accessible with the current credentials.
- `ga4_run_report`: Run a GA4 analytics report with intelligent query planning.
- `ga4_run_realtime_report`: Run a read-only GA4 Data API realtime report. Realtime supports only a limited subset of dimensions and metrics.
- `ga4_get_metadata`: Get the complete list of dimensions and metrics available for a specific GA4 property.
- `ga4_get_custom_definitions`: List custom dimensions and custom metrics exposed by GA4 Data API metadata.
- `ga4_get_key_events`: Inventory GA4 key events/conversions using metadata-aware Data API reports.
- `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.
- `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_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_audience_diagnostics`: Read-only audience diagnostics from Admin API audiences, Data API recurring audience lists, and observed audienceName report fallback.
- `ga4_get_bigquery_export_diagnostics`: Detect GA4 BigQuery export links and diagnose export modes, stream coverage, excluded events, and dataset location.
- `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_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_get_channel_groups`: List custom channel groups defined for a GA4 property.
- `ga4_validate_query`: Validate a metric/dimension combination BEFORE executing.
- `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_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.
- `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_query_audience_export`: Query rows from an existing GA4 Audience Export.
- `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.