mcp

{'type': 'object', 'required': ['keywords'], 'properties': {'store': {'enum': ['apple', 'google'], 'type': 'string', 'title': 'Store', 'default': 'apple', 'description': "Store to score against: 'apple' or 'google'."}, 'country': {'type': 'string', 'title': 'Country', 'default': 'US', 'maxLength': 2, 'minLength': 2, 'description': "Two-letter ISO country code of the storefront, e.g. 'US', 'DE' (default 'US')."}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Keywords', 'maxItems': 10, 'minItems': 1, 'description': "Up to 10 search terms to score in one call, e.g. ['habit tracker', 'daily planner']."}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en', 'maxLength': 5, 'minLength': 2, 'description': "Language code the keywords are written in, e.g. 'en', 'de' (default 'en')."}}}

{'type': 'object', 'required': ['tool', 'credits_charged', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'items': {'type': 'array', 'description': 'Score rows, one per keyword.'}, 'total': {'type': 'integer', 'description': 'How many keywords were scored.'}}, 'description': 'One score row per submitted keyword, each shaped like the get_keyword_difficulty result.'}, 'tool': {'type': 'string', 'description': 'Name of the tool that produced this result.'}, 'credits_charged': {'type': 'integer', 'description': 'API credits debited from the account balance for this call.'}}}

{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'title': 'App Id', 'description': "The app to look up. Accepts the canonical '<store>:<store_id>' form ('apple:284882215', 'google:com.spotify.music'), a bare Apple track id ('284882215'), an Android package name ('com.spotify.music'), or a full App Store / Google Play URL."}}}

{'type': 'object', 'required': ['tool', 'credits_charged', 'data'], 'properties': {'data': {'type': 'object', 'description': "The app's full record: title, developer, category, price, rating and review counts, download and revenue estimates, store description, icon and screenshot URLs, release and last-update dates, and developer_url — the developer's own website when the App Store lists one (Apple only; null for Google Play and for apps without a site)."}, 'tool': {'type': 'string', 'description': 'Name of the tool that produced this result.'}, 'credits_charged': {'type': 'integer', 'description': 'API credits debited from the account balance for this call.'}}}

{'type': 'object', 'required': ['store_id'], 'properties': {'days': {'type': 'integer', 'title': 'Days', 'default': 30, 'maximum': 730, 'minimum': 7, 'description': 'Length of the history window in days, 7-730 (default 30). Points are daily up to 90 days and weekly beyond that.'}, 'store': {'enum': ['apple', 'google'], 'type': 'string', 'title': 'Store', 'default': 'apple', 'description': "Which store the store_id belongs to: 'apple' or 'google'."}, 'store_id': {'type': 'string', 'title': 'Store Id', 'maxLength': 80, 'minLength': 1, 'description': "Store-native app id without the store prefix: numeric track id for Apple ('284882215'), bundle id for Google ('com.spotify.music')."}}}

{'type': 'object', 'required': ['tool', 'credits_charged', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'items': {'type': 'array', 'description': 'Dated metric points, oldest first.'}}, 'description': 'Time series for the requested window. Each item is one dated point with rating, rating_count, reviews_delta_7d, downloads_est_monthly, revenue_est_monthly and growth_reviews_7d_pct.'}, 'tool': {'type': 'string', 'description': 'Name of the tool that produced this result.'}, 'credits_charged': {'type': 'integer', 'description': 'API credits debited from the account balance for this call.'}}}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'How many reviews to return, 1-50 (default 10).'}, 'store': {'anyOf': [{'enum': ['apple', 'google'], 'type': 'string'}, {'type': 'null'}], 'title': 'Store', 'default': None, 'description': "Filter to reviews from one store: 'apple' or 'google'."}, 'topic': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Topic', 'default': None, 'description': "Filter by an extracted topic label, e.g. 'pricing', 'onboarding', 'bugs'."}, 'app_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'App Id', 'default': None, 'description': "Any app to read reviews for, whether or not the workspace tracks it. Accepts 'apple:284882215', 'google:com.duolingo', a bare Apple track id, an Android package name, or a store URL. Reviews come straight from the store and carry no sentiment/topic enrichment; Google Play rows have no title."}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0, 'minimum': 0, 'description': "How many reviews to skip before returning results. Live store reads ('app_id' set) reach the 200 newest reviews per app and storefront, so page until 'has_more' is false rather than to a fixed depth; workspace reads page the full stored history."}, 'country': {'type': 'string', 'title': 'Country', 'default': 'US', 'maxLength': 2, 'minLength': 2, 'description': "Two-letter storefront code the reviews are read from, e.g. 'US', 'DE' (default 'US'). Only applies when 'app_id' is used. For Google Play this also picks the review language of that storefront."}, 'store_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Store Id', 'default': None, 'description': "Filter to one app by its store-native id, e.g. '284882215' or 'com.spotify.music'."}, 'sentiment': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Sentiment', 'default': None, 'description': "Filter by review sentiment: 'positive', 'neutral' or 'negative'."}, 'tracked_app_id': {'anyOf': [{'type': 'string', 'format': 'uuid'}, {'type': 'null'}], 'title': 'Tracked App Id', 'default': None, 'description': "UUID of one tracked app in the caller's workspace. Omit to read reviews across all tracked apps."}}}

{'type': 'object', 'required': ['tool', 'credits_charged', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'items': {'type': 'array', 'description': 'Review rows for this page.'}, 'source': {'type': 'string', 'description': "'workspace' for tracked, enriched reviews; 'store_feed' for live store reviews."}, 'enriched': {'type': 'boolean', 'description': 'True when sentiment/topics/improvement areas are present.'}}, 'description': "One page of reviews. Every item carries title, body, star rating, author, version, country and publish date. Workspace rows add the enrichment layer (sentiment, topics, improvement areas); live store rows do not. The result's 'source' field is 'workspace' or 'store_feed' and 'enriched' says which."}, 'tool': {'type': 'string', 'description': 'Name of the tool that produced this result.'}, 'credits_charged': {'type': 'integer', 'description': 'API credits debited from the account balance for this call.'}}}

{'type': 'object', 'required': ['keyword'], 'properties': {'store': {'enum': ['apple', 'google'], 'type': 'string', 'title': 'Store', 'default': 'apple', 'description': "Store to score against: 'apple' or 'google'."}, 'country': {'type': 'string', 'title': 'Country', 'default': 'US', 'maxLength': 2, 'minLength': 2, 'description': "Two-letter ISO country code of the storefront, e.g. 'US', 'DE' (default 'US')."}, 'keyword': {'type': 'string', 'title': 'Keyword', 'maxLength': 80, 'minLength': 2, 'description': "Search term to score as an ASO target, e.g. 'habit tracker'."}, 'language': {'type': 'string', 'title': 'Language', 'default': 'en', 'maxLength': 5, 'minLength': 2, 'description': "Language code the keyword is written in, e.g. 'en', 'de', 'pt-BR' (default 'en')."}}}

{'type': 'object', 'required': ['tool', 'credits_charged', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'keyword': {'type': 'string', 'description': 'The keyword that was scored.'}, 'difficulty': {'type': 'integer', 'description': 'How hard it is to rank, 0 (easy) to 100 (hard).'}, 'popularity': {'type': 'integer', 'description': 'Estimated search demand, 0 (none) to 100 (highest).'}, 'traffic_score': {'type': 'integer', 'description': 'Expected traffic if the app ranks well, 0-100.'}, 'opportunity_score': {'type': 'integer', 'description': 'Combined demand-vs-competition attractiveness, 0-100.'}}, 'description': 'Scores for the keyword in the requested storefront: difficulty and popularity (0-100), traffic_score and opportunity_score, echoed back with the keyword, store, country and language.'}, 'tool': {'type': 'string', 'description': 'Name of the tool that produced this result.'}, 'credits_charged': {'type': 'integer', 'description': 'API credits debited from the account balance for this call.'}}}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['tool', 'credits_charged', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'items': {'type': 'array', 'description': 'Supported storefronts.'}, 'total': {'type': 'integer', 'description': 'How many storefronts are supported.'}}, 'description': 'Storefronts this server can score keywords for. Each item has a two-letter code and the country name.'}, 'tool': {'type': 'string', 'description': 'Name of the tool that produced this result.'}, 'credits_charged': {'type': 'integer', 'description': 'API credits debited from the account balance for this call.'}}}

{'type': 'object', '$defs': {'AppSortBy': {'enum': ['downloads', 'revenue', 'growth', 'reviews', 'rating', 'title', 'released', 'updated'], 'type': 'string', 'title': 'AppSortBy'}, 'SortDirection': {'enum': ['asc', 'desc'], 'type': 'string', 'title': 'SortDirection'}}, 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'How many apps to return, 1-50 (default 10).'}, 'store': {'anyOf': [{'enum': ['apple', 'google'], 'type': 'string'}, {'type': 'null'}], 'title': 'Store', 'default': None, 'description': "Limit results to one store: 'apple' (App Store) or 'google' (Google Play). Omit to search both."}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0, 'minimum': 0, 'description': 'How many apps to skip before returning results; use for paging.'}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None, 'description': "Free-text query matched against app title and developer name, e.g. 'calorie tracker'."}, 'sort_by': {'$ref': '#/$defs/AppSortBy', 'default': 'downloads', 'description': "Column to sort by: 'downloads' (default), 'revenue', 'growth', 'reviews', 'rating', 'title', 'released' or 'updated'."}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None, 'description': "Store category name to filter by, e.g. 'Health & Fitness', 'Productivity', 'Games'. Use 'categories' to include several at once."}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 5, 'minLength': 2}, {'type': 'null'}], 'title': 'Language', 'default': None, 'description': "Single app-language code the listing supports, e.g. 'en', 'de', 'pt-BR'."}, 'sort_dir': {'$ref': '#/$defs/SortDirection', 'default': 'desc', 'description': "Sort direction: 'desc' (default, highest first) or 'asc'."}, 'languages': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20}, {'type': 'null'}], 'title': 'Languages', 'default': None, 'description': "Several app-language codes to include, e.g. ['en', 'es']."}, 'search_in': {'anyOf': [{'enum': ['all', 'title', 'developer'], 'type': 'string'}, {'type': 'null'}], 'title': 'Search In', 'default': None, 'description': "Which field 'search' matches: 'title', 'developer', or 'all' (default). Use 'developer' to list a publisher's portfolio."}, 'categories': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20}, {'type': 'null'}], 'title': 'Categories', 'default': None, 'description': "Several category names to include, e.g. ['Health & Fitness', 'Lifestyle']. Takes precedence over 'category'."}, 'max_rating': {'anyOf': [{'type': 'number', 'maximum': 5, 'minimum': 0}, {'type': 'null'}], 'title': 'Max Rating', 'default': None, 'description': 'Highest average star rating to include, 0-5; use to find weak incumbents.'}, 'min_rating': {'anyOf': [{'type': 'number', 'maximum': 5, 'minimum': 0}, {'type': 'null'}], 'title': 'Min Rating', 'default': None, 'description': 'Lowest average star rating to include, 0-5, e.g. 4.'}, 'max_revenue': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'title': 'Max Revenue', 'default': None, 'description': 'Highest estimated monthly revenue in USD, e.g. 50000 for $50K/month.'}, 'max_reviews': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'title': 'Max Reviews', 'default': None, 'description': 'Highest lifetime review count, e.g. 1000 to exclude entrenched giants.'}, 'min_revenue': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'title': 'Min Revenue', 'default': None, 'description': 'Lowest estimated monthly revenue in USD, e.g. 10000 for $10K/month.'}, 'min_reviews': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'title': 'Min Reviews', 'default': None, 'description': 'Lowest lifetime review count, e.g. 1000.'}, 'price_model': {'anyOf': [{'enum': ['Free', 'Freemium', 'Paid'], 'type': 'string'}, {'type': 'null'}], 'title': 'Price Model', 'default': None, 'description': "Monetisation model: 'Free', 'Freemium' or 'Paid'. Case-insensitive on input."}, 'growth_metric': {'anyOf': [{'type': 'string', 'const': 'reviews'}, {'type': 'null'}], 'title': 'Growth Metric', 'default': None, 'description': "Metric the growth filter measures — currently only 'reviews'."}, 'growth_period': {'anyOf': [{'enum': ['7d', '14d', '30d', '60d', '90d'], 'type': 'string'}, {'type': 'null'}], 'title': 'Growth Period', 'default': None, 'description': "Window growth is measured over: '7d', '14d', '30d', '60d' or '90d'. Only '7d' covers Google Play; the longer windows are App Store data, so combining them with store='google' is rejected and leaving the store unset ranks App Store apps only."}, 'max_downloads': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'title': 'Max Downloads', 'default': None, 'description': 'Highest estimated monthly downloads.'}, 'min_downloads': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'title': 'Min Downloads', 'default': None, 'description': 'Lowest estimated monthly downloads, e.g. 10000.'}, 'not_languages': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20}, {'type': 'null'}], 'title': 'Not Languages', 'default': None, 'description': "Localization-gap filter: return only apps NOT localized in any of these language codes, e.g. ['it'] finds apps without an Italian localization. App Store data only — combine with languages=['en'] to shortlist English apps missing a target market's language."}, 'updated_after': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Updated After', 'default': None, 'description': "Only apps last updated on or after this date, 'YYYY-MM-DD'."}, 'min_growth_pct': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'title': 'Min Growth Pct', 'default': None, 'description': "Lowest absolute growth percentage over 'growth_period', e.g. 20 for at least ±20%."}, 'released_after': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Released After', 'default': None, 'description': "Only apps released on or after this date, 'YYYY-MM-DD'."}, 'updated_before': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Updated Before', 'default': None, 'description': "Only apps last updated on or before this date, 'YYYY-MM-DD'."}, 'released_before': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Released Before', 'default': None, 'description': "Only apps released on or before this date, 'YYYY-MM-DD'."}, 'growth_direction': {'anyOf': [{'enum': ['up', 'down'], 'type': 'string'}, {'type': 'null'}], 'title': 'Growth Direction', 'default': None, 'description': "Keep only apps growing ('up') or declining ('down') over 'growth_period'."}, 'max_days_since_update': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'title': 'Max Days Since Update', 'default': None, 'description': 'Only apps updated within this many days, e.g. 30 for actively maintained apps.'}, 'max_days_since_release': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'title': 'Max Days Since Release', 'default': None, 'description': 'Only apps first released within this many days, e.g. 90 for fresh launches.'}}, 'description': 'Explore-grade app search. Every filter is optional; supplied ones combine (AND).'}

{'type': 'object', 'required': ['tool', 'credits_charged', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'items': {'type': 'array', 'description': 'Matching rows for this page.'}, 'limit': {'type': 'integer', 'description': 'Page size that was applied.'}, 'total': {'type': 'integer', 'description': 'Total rows matching the query.'}, 'offset': {'type': 'integer', 'description': 'Row offset that was applied.'}}, 'description': 'One page of matching apps. Each item carries app_id, title, developer, category, rating, review count, monthly download and revenue estimates, and recent review-growth percentages.'}, 'tool': {'type': 'string', 'description': 'Name of the tool that produced this result.'}, 'credits_charged': {'type': 'integer', 'description': 'API credits debited from the account balance for this call.'}}}