CreativeScope — Mobile Game Ad Creative Intelligence MCP server

Compare 2-5 games with the same date range, deduplication and metric definitions. Return creative, reused-creative and ad-plan counts plus global creative lifetime estimated exposure. Optional country filtering means target-list inclusion, not country exposure or preference. Maximum 180 days; no standalone creative/ad IDs are returned.

Find visually similar creatives using the stored vector of an existing creative. For a concept without an ID, query selects an explainable seed from available creative metadata and then uses the same vector-neighbor search. For an English concept, send the original English terms only. The service resolves Chinese source-label equivalents internally before selecting the seed. Returns creative records ordered from most to least visually similar; low-similarity and near-duplicate results are excluded, and raw similarity scores are not exposed. If request_echo.seed_basis identifies a proxy seed, clearly disclose that limitation instead of presenting the results as an exact concept match. Example: 'Show variants of the toilet run viral creative concept.'

Generate a compact creative brief from recent high-signal mobile game ads. Use this for weekly inspiration, hook mining, competitor creative planning, and UA brainstorming. Creative tag fields are normalized to English in the result. Example: 'Create this week's puzzle-game creative brief for Facebook.'

Get an advertiser or game profile, including recent ad activity, creative volume, target countries, and platforms. stats_30d and stats_180d are fixed rolling snapshots, NOT totals for a requested historical date range. Use get_game_summary for explicit dates. Creative tag fields are normalized to English in the result. Example: 'Which markets and platforms is this game scaling on?'

Get CreativeScope business context, current date, supported platforms, registered tool catalog, date limits, freshness and capability boundaries. Use the tool catalog to select the appropriate discovery, aggregate or ranking contract.

Get one creative's delivery metadata and English creative insights, including opening hook signals, scene descriptions, and creative patterns when available. Example: 'Why does this winning creative work?'

Get global or genre-level rising creative rankings by day, week, or month, or evergreen creative rankings from the monthly snapshot; platform and country filters are not supported. Evergreen data is monthly only; day/week requests are normalized to month and disclosed in request_echo. Use this to answer what's rising this week, what evergreen creatives keep working, or which hook patterns repeat in a genre. For platform- or country-filtered discovery, use search_creatives and do not describe those results as an official rising or evergreen ranking. Creative tag fields are normalized to English in the result. Example: 'Which SLG creatives are rising this month?'

Get valid game categories, countries and 14 delivery-platform aliases. Map user conditions to the returned standard values before exact filtering. Country options include codes and names. Keep canonical filter values unchanged when using them as parameters.

Discover a game's ad plans by countries, platforms, format and dates. Deduplicate cross-month snapshots; each result represents one plan with its associated creative material_reference and response-local plan_sequence, without standalone ad/creative IDs. contains matches any specified country; exclusive requires exact set equality. Pagination reports has_more, not an exact total. Use get_game_platform_stats for totals.

Get game delivery-country coverage for a date range. Country coverage can overlap and does not represent country-specific exposure or audience preference.

Get daily and cumulative estimated exposure across all Android/iOS packages associated with a game. daily_impressions is the daily increment; snapshot_impressions is cumulative through that date; daily_impressions_total is the period increment total. For historical total exposure with no date, query yesterday in Asia/Shanghai and use its snapshot_impressions. For the past N days, use daily_impressions_total. Default 90 days, maximum 365 days. Label exposure as estimated.

Get game identity, delivery platforms, countries, active ad and creative counts, and download snapshots. Exposure for active creatives is lifetime estimated exposure, not 30-day incremental exposure. Google Play download_count is the latest cumulative snapshot; download_count_label is a public store range, neither is a period increment.

Get daily Google Play net download increments and cumulative snapshots for a game. Return requested and actual coverage dates, download_increment_total and latest_download_snapshot. Sum increments only; never sum cumulative snapshots.

Get daily newly launched creatives, reused creatives, ad plans and exposure references to analyze delivery growth and creative refresh cadence. Exposure is a lifetime reference for newly launched creatives, not a daily increment. Default 90 days; maximum 180 days.

List a game advertiser's creatives by delivery performance, including material_reference, delivery dates, heat, reuse status and media. No standalone material tokens are returned. Each material_reference belongs to the same result item. No exact match total is returned. For platform totals, use get_game_platform_stats; never count by repeatedly paging.

Get a game's identity, deduplicated creatives/ad plans, market and platform coverage, and delivery-cadence summary in one call. Require explicit dates, maximum 180 days. Exposure is global creative lifetime estimated exposure, not period increments or country exposure. Country shares are overlapping ad-plan target coverage. No standalone creative/ad IDs are returned.

Get deduplicated creative count, first-discovered creative count and ad-plan count for one game, platform and explicit date range (maximum 180 days). Creative count uses lifetime overlap; first-discovered count uses first appearance within the range. No paging is needed. Always use this tool for platform totals rather than counting pages from discovery tools.

Get a game delivery-platform distribution for a date range. Platform coverage can overlap; shares are not exclusive audience or exposure shares.

Get a game delivery-platform trend for a date range. Use the returned metric and dates consistently when comparing platforms.

List the countries, app-store categories, stores, and ranking types where a game appeared on a chart during a date range. Returns each observed dimension with best rank, latest rank, and ranked-day count. Ranking types are free, store-paid, and top-grossing. Only Google Play and iPhone App Store are exposed; iPad rankings are excluded. Date range defaults to the last 90 days and cannot exceed 365 days.

Get one mobile game's daily app-store ranking performance over a date range. Returns free, store-paid, and top-grossing ranking series with best/latest rank and the matched country, category, and store. Use mode=best to select the game's best daily rank across supported countries and categories, or mode=exact for one country/category/store combination. Supported stores are Google Play, iPhone App Store, and all (Google Play plus iPhone App Store). Date range defaults to the last 90 days and cannot exceed 365 days.

Summarize creatives, ad plans, lifetime exposure references and Google Play net download increments within a date range. download_increment sums daily increments over actual coverage, not cumulative downloads or public store ranges. Includes the legacy nested summary alongside the primary delivery fields.

Get daily game delivery trends for the requested date range. Creative and ad counts represent delivery activity; exposure is a lifetime reference, not daily incremental exposure.

Get creative summary, media and owning-game information using a complete material_reference returned by this service. Resolve the exact material, game, source platform, date and month in that reference. Use material_reference for follow-up tool calls and media_url to view images, play videos or open HTML playable ads.

Get rising or evergreen creative rankings by period and optional primary/secondary category. Return rank, material_reference, video media, creative labels, delivery duration, heat, ad count and associated games. Always use the same item's material_reference when citing a creative. No standalone material identifiers are returned. Platform/country filtering is not supported.

Find directly recorded reuse relationships for a creative material_reference. Return related games, developers, first/last appearances, relative appearance days and representative material references, grouped by game. These are direct bidirectional reuse relationships, not vector similarity or proof of ownership.

Get completed reference-image search results. If the job is still running, returns polling guidance. Example: 'Show the matches from my reference-image search.'

Get the processing status of a reference-image search job. Example: 'Is my reference-image search finished yet?'

Find visually similar creatives from a complete material_reference using stored video-content vectors. Return games, developers, delivery dates, heat, media and material references. Require dates, maximum 180 days. Similarity does not establish reuse; use get_material_reuse_clues for recorded cross-game reuse and chronology.

Find games first observed in official daily app-store charts, defined per package, platform, country, category and rank type. This is not a release date. Complete coverage starts 2025-09-15; exclude the baseline day by default to avoid labeling existing games as new. Default game grouping deduplicates package/platform; dimension grouping returns original chart dimensions.

Get official Google Play or iPhone App Store free, paid or grossing charts by day, week or month and official category. country_code must be explicitly specified by the user; otherwise get_store_game_rank_filter and ask for the country. Return current, best and previous ranks, movement, hourly rank curves and game tokens.

Get valid platforms, rank types, periods, countries, official categories and dates for official app-store rankings, including the latest Google Play US free-chart date/hour. Use before querying rankings to discover valid country and platform-specific category values.

Get game-level official daily chart trends using a game token or an app identifier resolved through the official package mapping. Best mode selects leading dimensions across Google Play and iPhone App Store; exact mode fixes store, country and category. Includes current-day realtime data when available. Returns daily ranks, first-entry flags and optional 24-hour curves.

Record an unmet analysis need for future product improvements when existing tools cannot satisfy the request. Include the missing capability and an example query.

Resolve an Android package name or numeric iOS app ID to game tokens and identity. Return all matching regional editions, ordered by lifetime estimated exposure of creatives active in the last 30 days. This is a delivery-heat reference, not incremental exposure.

Search advertisers, game studios, or mobile games by name and optional genre, region, and platform filters. Use the returned advertiser_id as game_id with get_game_summary for a specified date range, or with get_advertiser_profile for fixed rolling snapshots. Example: 'Find the advertiser for Last War.'

Search mobile game ad creatives by keyword or visual-description-like natural language. For an English request, send the original English concepts only. The service internally expands genre, hook, mood, art-style, and gameplay-mechanic concepts to Chinese source-label equivalents for retrieval; generated translations must not be inserted into the public request. Use this for finding UGC-style ads, winning creatives, opening hook examples, playable ads, and platform/country/genre slices. Results include the original creative asset as media_url when available. Creative tag fields are normalized to English in the result. Example: 'Find UGC-style match-3 video ads in the US.'

Search mobile games by name or category across global markets. Return identity, active ads and creatives in the last 30 days, and their lifetime estimated exposure as a delivery-heat reference, not 30-day incremental exposure. Supply keyword or category. Category accepts English or Chinese.

Search creatives by game category, creative labels, country, platform and format. Each label dimension accepts one standard value; different dimensions may be combined. Country means the delivery list includes that country, not exclusive targeting. Exposure is global lifetime estimated exposure, not country-specific. Cite metrics and material_reference from the same item. Use get_filter_options for game categories, countries and platforms.

Search creative copy and labels by keyword, optionally within a game and date range. Return opaque material references and direct video addresses. Keyword length is 2-200 characters. This performs text matching, not arbitrary visual-description vector search. Use search_materials_v2 with query for bilingual concept expansion.

Aggregate ad-plan and creative counts/shares by delivery platform and country using discovery filters. Return aggregates only. Each creative or plan can cover multiple countries/platforms, so sums count attributions rather than deduplicated totals. Require explicit dates (maximum 180 days) and at least one of game_ids, keyword, country_codes, publisher_platforms, languages or a creative-label filter. Use get_game_platform_stats for single-game/platform deduplicated totals.

Discover creatives by games, countries, platforms, formats, languages, aspect ratio, duration, device, quality and discovery dates. Each result has an atomically associated material_reference, without standalone creative/ad IDs. country_match contains matches any country; exclusive requires exact set equality. Exposure is global lifetime estimated exposure, not country-specific. Pagination reports has_more, not an exact total. Use get_game_platform_stats for totals, never repeated paging. Arbitrary visual-description semantic search is not supported.

Submit a reference-image similarity search as an asynchronous job. Use this when the user provides a directly downloadable public HTTPS image URL. The URL must resolve to image bytes without login or hotlink protection; HTML pages, local paths, and base64 are not supported. The embedding provider validates image format and size asynchronously and returns IMAGE_FETCH_FAILED, INVALID_IMAGE, or EMBEDDING_MODEL_ERROR when processing cannot continue. Genre aliases are normalized internally. If a normalized genre produces no candidates, the completed result explicitly marks a visual-only fallback instead of silently returning an empty set. Example: 'Find ads visually similar to this reference image.'