Guides

Tools reference

The full catalog of read tools the Moloco Ads MCP exposes, grouped by different entities.

Last updated: 2026-07-21

All tools are read-only and return Ads API's full response verbatim (no field projection — what you see in the docs is what Claude gets back).

Each tool links to the underlying REST endpoint in the Moloco Ads API reference — open it to see the full request/response schema.

💡

The fastest way to see what's live is to ask Claude directly: "What Moloco Ads tools do you have?" The list below mirrors the current server; new tools roll out continuously, so the live answer is authoritative.

Workplaces

moloco_ads_list_workplaces

List the workplaces (a.k.a. platforms) you can access. This is the entry point: every other tool requires a workplace_id, and this is the only tool that doesn't — call it first to discover the ID to pass to everything else. An OAuth connection authenticates you as a user and isn't bound to a single workplace, so each call chooses which workplace it targets.

moloco_ads_get_workplace

Get one workplace in full by workplace_id.

Identity

moloco_ads_user_info

Return the caller's user profile and their workplace / ad-account roles (the identity you're connected as). Call this when you want to know "who am I signed in as" or "what do I have access to".

Ad accounts

moloco_ads_list_ad_accounts

List the ad accounts under a workplace, in full. Ad accounts own campaigns — call this to discover an ad_account_id for the per-account tools.

moloco_ads_get_ad_account

Get one ad account in full.

Products

moloco_ads_list_products

List products (advertised apps/sites) under an ad account, in full.

moloco_ads_get_product

Get one product in full.

moloco_ads_get_product_app_event_summary

App-event summary (event counts, revenue) for one product.

moloco_ads_get_product_skan_conversion_config

SKAdNetwork conversion config for one product.

moloco_ads_get_product_mmp_skan_conversion_config

MMP-sourced SKAdNetwork conversion config for one product.

Campaigns & ad groups

moloco_ads_list_campaigns

List campaigns under an ad account, in full.

  • Inputs: workplace_id, ad_account_id, optional product_id
  • Ads API: List Campaigns

moloco_ads_get_campaign

Get one campaign in full (targeting, budget, schedule, etc.).

moloco_ads_list_ad_groups

List ad groups under an ad account, in full.

  • Inputs: workplace_id, ad_account_id, optional campaign_id / product_id
  • Ads API: List AdGroups

moloco_ads_get_ad_group

Get one ad group in full (audience, capper, creative groups, etc.). Both IDs come from moloco_ads_list_ad_groups.

  • Inputs: workplace_id, ad_group_id, campaign_id
  • Ads API: Read AdGroup

Audiences

moloco_ads_list_audience_targets

List audience targets (reusable targeting conditions) under an ad account, in full.

moloco_ads_get_audience_target

Get one audience target in full.

moloco_ads_list_customer_sets

List customer sets (uploaded audience / customer lists) under an ad account, in full.

moloco_ads_get_customer_set

Get one customer set in full.

Creatives & tracking links

moloco_ads_list_creatives

List creatives under an ad account, in full.

  • Inputs: workplace_id, ad_account_id, optional product_id / types / order_by_key
  • Ads API: List Creatives

moloco_ads_get_creative

Get one creative in full.

moloco_ads_list_creative_reviews

List creative reviews (creatives + review status).

  • Inputs: workplace_id, optional ad_account_id / review_states / campaign_states
  • Ads API: List CreativeReviews

moloco_ads_list_creative_groups

List creative groups under an ad account, in full.

moloco_ads_get_creative_group

Get one creative group in full.

moloco_ads_list_tracking_links

List tracking links under an ad account, in full.

moloco_ads_get_tracking_link

Get one tracking link in full. Set include_attempts to also return validation attempts.

  • Inputs: workplace_id, tracking_link_id, optional include_attempts
  • Ads API: Read TrackingLink

moloco_ads_validate_tracking_link

Validate a candidate tracking link — returns PASSED/FAILED plus any errors.

  • Inputs: workplace_id, ad_account_id, tracking_link object (needs device_os, tracking_company, and at least one of click_through_link / view_through_link)
  • Ads API: Validate TrackingLink

Summary

moloco_ads_entity_counts

Current vs. limit entity counts (e.g. how many campaigns exist vs. the cap) for one entity type.

  • Inputs: workplace_id, entity_type, plus a conditional scope (ad_account_id / product_id / campaign_id) depending on the type
  • Ads API: Read entity counts

moloco_ads_workplace_summary

Monthly spend / discount summary for a workplace over a month range.

moloco_ads_cohort_summary

Cohort performance summary for an ad account over a date range.

  • Inputs: workplace_id, ad_account_id, date_start, date_end (YYYY-MM-DD), optional type / actions
  • Ads API: Read cohort summary

Analytics

The three analytics tools query the /cm/v1/analytics-* endpoints. Dimensions and metrics are passed through as enum-name strings.

moloco_ads_analytics_overview

Aggregated ad-performance overview for an ad account over a date range.

  • Inputs: workplace_id, ad_account_id, date_start, date_end (YYYY-MM-DD), dimensions, metrics
  • Ads API: Analytics overview

moloco_ads_analytics_detail

Detailed ad-performance analytics — finer breakdowns than the overview (e.g. HOUR, sub-publisher, exchange).

  • Inputs: workplace_id, ad_account_id, date_start, date_end (YYYY-MM-DD), dimensions, metrics
  • Ads API: Analytics detail

moloco_ads_analytics_skan

SKAdNetwork ad-performance analytics for an ad account over a date range.

  • Inputs: workplace_id, ad_account_id, date_start, date_end (YYYY-MM-DD), dimensions, skan_conversion_dimensions, metrics
  • Ads API: Analytics SKAdNetwork

Updated about 1 month ago