Creativescope Ai Mcp Tools List

{
  "result": {
    "tools": [
      {
        "name": "get_game_trend",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "game_id": {
              "description": "Game token returned by this service. Pass unchanged.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Default: 90 days ago; maximum range 180 days.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD. Default: today.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "game_id"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_game_rank_markets",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "game_id": {
              "description": "Encrypted game ID returned by search_games or as game_id/advertiser_id in other results.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date in YYYY-MM-DD. Defaults to 89 days before date_to.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date in YYYY-MM-DD. Defaults to today.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "store": {
              "description": "Store: all, google_play, or app_store. Defaults to all.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "rank_types": {
              "description": "Ranking types: free, store_paid, grossing. Defaults to all three.",
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "default": null
            },
            "limit": {
              "description": "Maximum dimension rows to return. Maximum 200; defaults to 100.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "game_id"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_game_investment_trend",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "game_id": {
              "description": "Game token returned by game search, rankings or details. Pass the token unchanged.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints. Maximum range 180 days.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "metrics": {
              "description": "Comma-separated metrics: materials, ads, or all (default). Chinese aliases are also accepted.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "game_id"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_game_overview",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "game_id": {
              "description": "Game token returned by game search, rankings or details. Pass the token unchanged.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints. Required.",
              "type": "string"
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required. Required. Maximum range 180 days.",
              "type": "string"
            },
            "sections": {
              "description": "Optional sections: identity, summary, markets, platforms, trend_summary. Omit for all.",
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "default": null
            }
          },
          "required": [
            "game_id",
            "date_from",
            "date_to"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_game_summary",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "game_id": {
              "description": "Game token returned by this service. Pass unchanged.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Default: 90 days ago; maximum range 180 days.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD. Default: today.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "game_id"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_material_detail_v2",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "detail_url": {
              "description": "Opaque material_reference returned by creative search. Pass unchanged in this legacy-named detail_url parameter. Previously issued detail URLs remain accepted as input only.",
              "type": "string"
            },
            "include": {
              "description": "Requested sections: summary (default, including owning-game and download/delivery information), media. Multiple sections are allowed.",
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "default": null
            }
          },
          "required": [
            "detail_url"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "search_games",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "keyword": {
              "description": "Search text in the user's original language. Supply keyword or category.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "category": {
              "description": "Game category in English or Chinese, such as strategy, RPG or casual. Supply keyword or category.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "sort_by": {
              "description": "Sort order: ad_heat, material_count, ad_count, downloads. The first value is the default.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "limit": {
              "description": "Number of results; default 20; maximum 50.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "offset": {
              "description": "Pagination offset; default 0.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "region": {
              "description": "Optional delivery region or ISO2 country code.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "publisher_platform": {
              "description": "Optional delivery platform alias, such as facebook or tiktok.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            }
          }
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_game_install_trend",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "game_id": {
              "description": "Game token returned by game search, rankings or details. Pass the token unchanged.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "game_id"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_similar_materials_v2",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "detail_url": {
              "description": "Opaque material_reference returned by creative search. Pass unchanged in this legacy-named detail_url parameter. Previously issued detail URLs remain accepted as input only.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints. Required.",
              "type": "string"
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required. Required. Maximum range 180 days.",
              "type": "string"
            },
            "cross_game": {
              "description": "true (default) searches all games; false restricts results to the seed creative's game.",
              "type": [
                "boolean",
                "null"
              ],
              "default": null
            },
            "sort_by": {
              "description": "Sort order: similarity, heat, latest. The first value is the default.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "limit": {
              "description": "Number of results; default 10; maximum 20.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "offset": {
              "description": "Pagination offset; default 0. Maximum 5000.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "detail_url",
            "date_from",
            "date_to"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "search_materials_by_keyword",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "keyword": {
              "description": "Search text in the user's original language. Required; 2-200 characters.",
              "type": "string"
            },
            "game_id": {
              "description": "Game token returned by game search, rankings or details. Pass the token unchanged.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "video_type": {
              "description": "Creative format: 0=image, 1=video, 2=playable. Do not combine with material_type/material_types.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "sort_by": {
              "description": "Sort order: heat, latest. The first value is the default.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "limit": {
              "description": "Number of results; default 20; maximum 50.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "offset": {
              "description": "Pagination offset; default 0.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "keyword"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_material_reuse_clues",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "detail_url": {
              "description": "Opaque material_reference returned by creative search. Pass unchanged in this legacy-named detail_url parameter. Previously issued detail URLs remain accepted as input only.",
              "type": "string"
            },
            "limit": {
              "description": "Number of results; default 20; maximum 50.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "detail_url"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_reference_image_search_status",
        "description": "Get the processing status of a reference-image search job. Example: 'Is my reference-image search finished yet?'",
        "inputSchema": {
          "type": "object",
          "properties": {
            "job_id": {
              "description": "Job ID returned by submit_reference_image_search.",
              "type": "string"
            }
          },
          "required": [
            "job_id"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_context",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {}
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_store_game_rank",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "country_code": {
              "description": "ISO 3166-1 alpha-2 country code, such as US or TR. Follow this tool's country-selection rules.",
              "type": "string"
            },
            "platform": {
              "description": "Store platform: 1=Google Play, 2=iPhone App Store.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "rank_type": {
              "description": "Chart type: 0=free (default), 1=paid, 2=grossing.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "period": {
              "description": "Chart period: day (default), week, month.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date": {
              "description": "Chart date: YYYY-MM-DD, or YYYY-MM for monthly charts. Omit for the latest available period.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "categories": {
              "description": "Official store category code or canonical category name. Use get_store_game_rank_filter to obtain valid platform-specific values.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "limit": {
              "description": "Number of results; default 20; maximum 100.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "offset": {
              "description": "Pagination offset; default 0.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "country_code"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_filter_options",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "types": {
              "description": "Comma-separated filter dictionaries: game_category, country, platform. Omit or use all for every dictionary.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            }
          }
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_store_game_rank_trend",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "package_name": {
              "description": "Optional Android package name or numeric iOS app ID. Resolves the owning game through the official package mapping; supply this or game_id, not both.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "country_code": {
              "description": "ISO 3166-1 alpha-2 country code, such as US or TR. Follow this tool's country-selection rules.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required. Maximum range 365 days.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "categories": {
              "description": "Official store category code or canonical category name. Use get_store_game_rank_filter to obtain valid platform-specific values.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "rank_types": {
              "description": "Array of chart types: 0=free, 1=paid, 2=grossing. Omit for all.",
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "integer"
              },
              "default": null
            },
            "include_rank_curve": {
              "description": "Include a fixed 24-entry hourly rank curve for each day; default false.",
              "type": [
                "boolean",
                "null"
              ],
              "default": null
            },
            "game_id": {
              "description": "Game token from search_games or store rankings. Queries every associated official-store package, matching the game-level API.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "mode": {
              "description": "best selects the strongest observed dimensions across both stores; exact fixes platform, country and category. Defaults to exact when country_code is supplied, otherwise best.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "platform": {
              "description": "Store for exact mode: 1=Google Play, 2=iPhone App Store. Defaults to the supplied app identifier's store, otherwise Google Play.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "max_series": {
              "description": "Maximum chart series in best mode; default 20, maximum 50.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            }
          }
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "get_game_materials",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "game_id": {
              "description": "Game token returned by game search, rankings or details. Pass the token unchanged.",
              "type": "string"
            },
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "publisher_platform": {
              "description": "Delivery platform: facebook, instagram, messenger, audience_network, threads, admob, youtube, tiktok, mintegral, unity, applovin, ironsource, vungle or pangle. admob includes the Google advertising subchannels.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "video_type": {
              "description": "Creative format: 0=image, 1=video, 2=playable. Do not combine with material_type/material_types.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "sort_by": {
              "description": "Sort order: heat, reinvestment, latest, ending. The first value is the default.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "limit": {
              "description": "Number of results; default 20; maximum 100.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            },
            "offset": {
              "description": "Pagination offset; default 0.",
              "type": [
                "integer",
                "null"
              ],
              "default": null
            }
          },
          "required": [
            "game_id"
          ]
        },
        "execution": {
          "taskSupport": "optional"
        }
      },
      {
        "name": "search_materials_distribution",
        "description": "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.",
        "inputSchema": {
          "type": "object",
          "properties": {
            "date_from": {
              "description": "Start date, YYYY-MM-DD. Follow this tool's required-date and range constraints. Required.",
              "type": "string"
            },
            "date_to": {
              "description": "End date, YYYY-MM-DD; defaults to today unless explicitly required. Required. Maximum range 180 days.",
              "type": "string"
            },
            "game_ids": {
              "description": "Game tokens returned by this service; maximum 20. For compare_games, supply 2-5 tokens.",
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "default": null
            },
            "keyword": {
              "description": "Search text in the user's original language. Maximum 100 characters.",
              "type": [
                "string",
                "null"
              ],
              "default": null
            },
            "country_codes": {
              "description": "Array of ISO 3166-1 alpha-2 delivery-country codes, for example [\"TR\",\"US\"]; maximum 20.",
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "default": null
            },
            "country_match": {
              "des

# --- truncated at 32 KB (74 KB total) ---
# Full source: https://artifacts.apis.io/creativescope-ai/json-schema/creativescope-ai-mcp-tools-list.json