Asonix MCP
An MCP server providing App Store Optimization (ASO) intelligence, allowing AI agents to research keywords, analyze competitors, track rankings, and monitor ad activity across 2.5M+ App Store apps.
Endpoint and access
API key: create a key with the vendor first; your client sends it as an authorization header on every request.
https://api.asonix.io/mcpWhat its tools do
33 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (22)
get_ai_visibility_overviewget_ai_visibility_reasonsget_ai_visibility_evidencesearch_appslist_appslist_tracked_keywordsget_app_meta_adsget_ranking_refresh_statusget_workspace_keyword_opportunitiescheck_tracked_keywordsget_app_overviewget_app_visibility_historyget_app_rank_historyget_app_rating_historyget_app_chartsget_public_app_rankingssearch_keywordsget_keyword_relevanceget_keyword_top_appsget_keyword_top_advertisersget_app_search_ads_keywordsget_keyword_history
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to asonix.io ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Research keywords with real demand and difficulty metrics
- Analyze competitor rankings and ad strategies
- Track app rank, rating, and visibility history
- Localize metadata for different storefronts
Source and maintenance
Protocol and capabilities
- Server
- asonix-aso-research 0.1.0
- MCP protocol negotiated in check
- 2025-06-18
- Tools
- 33 advertised
- Resources
- Sign-in required
- Resource templates
- Sign-in required
- Prompts
- Sign-in required
{
"tools": {},
"prompts": {},
"resources": {}
}Tools
33 advertised
get_ai_visibility_overview — AI Visibility Overview
Read a tracked app's stored AI recommendation benchmark: coverage, mention/recommendation/App Store citation rates, weekly history and topic/prompt summaries with run IDs. Not ASO visibility. No collection or model calls. Defaults to four weeks; no benchmark returns NOT_STARTED. Use list_apps to resolve the app and storefront.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"weeks": {
"type": "integer",
"default": 4,
"maximum": 12,
"minimum": 1
},
"country": {
"type": "string",
"description": "Exact storefront, e.g. us. Defaults to us; use the tracked app's home country."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"status",
"scope",
"data",
"interpretation"
],
"properties": {
"data": {
"type": [
"object",
"null"
]
},
"scope": {
"type": "object",
"required": [
"appStoreId",
"country",
"platform"
],
"properties": {
"country": {
"type": "string",
"description": "Exact storefront, e.g. us. Defaults to us; use the tracked app's home country."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"status": {
"enum": [
"READY",
"NOT_STARTED",
"NOT_FOUND",
"LIMIT_EXCEEDED"
],
"type": "string"
},
"message": {
"type": "string"
},
"interpretation": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_ai_visibility_reasons — AI Recommendation Reasons
Read cached recommendation themes, exact answer quotes and description passage matches. Includes analysis status, timestamps and its own evidence denominator (which can differ from the overview). No generation or refresh. Full descriptions stay in get_app_overview; this returns matched passages and description metadata. Use theme and evidenceLimit to drill into supporting quotes.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"theme": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"country": {
"type": "string",
"description": "Exact storefront, e.g. us. Defaults to us; use the tracked app's home country."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"evidenceLimit": {
"type": "integer",
"default": 3,
"maximum": 10,
"minimum": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"status",
"scope",
"data",
"interpretation"
],
"properties": {
"data": {
"type": [
"object",
"null"
]
},
"scope": {
"type": "object",
"required": [
"appStoreId",
"country",
"platform"
],
"properties": {
"country": {
"type": "string",
"description": "Exact storefront, e.g. us. Defaults to us; use the tracked app's home country."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"status": {
"enum": [
"READY",
"NOT_STARTED",
"NOT_FOUND",
"LIMIT_EXCEEDED"
],
"type": "string"
},
"message": {
"type": "string"
},
"interpretation": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_ai_visibility_evidence — AI Visibility Evidence
Read a saved AI Visibility answer by runId, or recent answers for one promptId (exactly one required). Defaults to one run; use nextBefore for older prompt runs. Citations, resolved mentions and classification coverage are included. includeTrace adds captured searches; their sources belong to a search call, not an individual query. No external requests or collection.
{
"type": "object",
"oneOf": [
{
"required": [
"runId"
]
},
{
"required": [
"promptId"
]
}
],
"required": [
"appStoreId"
],
"properties": {
"limit": {
"type": "integer",
"default": 1,
"maximum": 5,
"minimum": 1
},
"runId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"before": {
"type": "string",
"format": "date-time",
"description": "Exclusive scheduledFor cursor from nextBefore; only with promptId."
},
"country": {
"type": "string",
"description": "Exact storefront, e.g. us. Defaults to us; use the tracked app's home country."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"promptId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"appStoreId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"includeTrace": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"status",
"scope",
"data",
"interpretation"
],
"properties": {
"data": {
"type": [
"object",
"null"
]
},
"scope": {
"type": "object",
"required": [
"appStoreId",
"country",
"platform"
],
"properties": {
"country": {
"type": "string",
"description": "Exact storefront, e.g. us. Defaults to us; use the tracked app's home country."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"status": {
"enum": [
"READY",
"NOT_STARTED",
"NOT_FOUND",
"LIMIT_EXCEEDED"
],
"type": "string"
},
"message": {
"type": "string"
},
"interpretation": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}add_app — Add App
Add an App Store app to the current Asonix workspace by App Store ID or app name/search query.
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"name": {
"type": "string"
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}create_unreleased_app — Create Unreleased App
Create a private unreleased app idea in the current Asonix workspace. Use this when the user's app is not on the App Store yet; then add researched keywords with add_keywords.
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}search_apps — Search Apps
Find App Store apps by name or developer, to get an app's appStoreId; use it before add_app when the user gives an app name. Returns at most 12 apps, in Apple's name-search order, which is not the keyword ranking: for who ranks for a keyword, use get_keyword_top_apps. Screenshot URLs only with includeScreenshots.
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"includeScreenshots": {
"type": "boolean",
"description": "Include each app's screenshot URLs. Omitted by default: they were two thirds of an answer."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}add_keywords — Add Keywords
Add one or more tracked keywords to an app in the current Asonix workspace and queue ranking refresh so popularity, difficulty, opportunity, and rank evidence can be collected. For agent-researched candidates, call evaluate_keywords first and add app-relevant primary or secondary terms.
{
"type": "object",
"required": [
"appStoreId",
"keywords"
],
"properties": {
"country": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}star_keyword — Star Keyword
Star/favorite a keyword research keyword in the current workspace by keywordId or term.
{
"type": "object",
"properties": {
"term": {
"type": "string"
},
"country": {
"type": "string"
},
"keywordId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}unstar_keyword — Unstar Keyword
Remove a keyword research keyword from the current workspace favorites by keywordId or term.
{
"type": "object",
"properties": {
"term": {
"type": "string"
},
"country": {
"type": "string"
},
"keywordId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}list_apps — List Apps
List apps tracked in the current Asonix workspace: names, App Store IDs, platforms, tracked storefronts, ratings and tracked-keyword counts. Pages with limit (default 20, max 100) and offset; q filters by name, developer, genre or ID. For one app's details use get_app_overview; for its keywords, list_tracked_keywords.
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_tracked_keywords — Tracked Keywords
One tracked app's tracked keywords with rank, popularity, difficulty, relevance and an ad summary, in one storefront or all. Use it for "how are my keywords doing". For the app's listing or ratings, or an untracked app, use get_app_overview. Paged: limit (default 30, max 100) and offset. relatedTools gives the next page, refresh_app_rankings when ranks are over 18 hours old, and the overview.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_app_meta_ads — App Meta Ads
An App Store app's Meta ads (Facebook, Instagram, Messenger, Audience Network) from Asonix's monthly Ad Library crawl, worldwide, for any app: active ads with text, call to action, start date, platforms and an Ad Library link, and past ads with their dates. status not_found is not proof it never ran Meta ads: the crawl covers the App Store ads it found.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}refresh_app_rankings — Refresh App Rankings
Queue a ranking refresh for one tracked app's keywords not checked in the last 18 hours, and return at once with jobIds. Omit country for every tracked storefront; one refreshed recently is listed in coolingDown. A refresh can take 10 minutes or more, so do not wait in a loop: tell the user ranks are updating, then call get_ranking_refresh_status after pollAfterSeconds, or read list_tracked_keywords later.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}get_ranking_refresh_status — Ranking Refresh Status
Report progress of a ranking refresh started by refresh_app_rankings, or of the rankingRefreshJob id returned by add_keywords: keywords done, failed, and remaining per storefront. Poll no more often than pollAfterSeconds. When finished is true, read the full updated ranks with list_tracked_keywords.
{
"type": "object",
"required": [
"jobIds"
],
"properties": {
"jobIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_workspace_keyword_opportunities — Workspace Keyword Opportunities
Return top scored keyword opportunities across all tracked apps in the current Asonix workspace, including shipped and unreleased apps, all countries, and rank/popularity/difficulty/opportunity evidence. Use this for requests like analyzing all apps or finding the top 100 opportunities without reading a local database. Each opportunity has checkedAt; call refresh_app_rankings for an app whose ranks are old.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}check_tracked_keywords — Check Tracked Keywords
Check candidate keyword terms against one tracked app's existing tracked keywords without dumping the full keyword table. iOS keyword rows include cached topAdvertisers; pending observations queue in the background. Use this before calling a candidate a missing gap, before add_keywords, and instead of inspecting local database code.
{
"type": "object",
"required": [
"appStoreId",
"keywords"
],
"properties": {
"country": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_app_overview — App Overview
An app's overview in one storefront, for any App Store app. storeListing is the storefront's listing and rating. Lists are counts: include adds the full description, countryRatings, listingCountries or keywordSuggestions. tracked says whether the workspace tracks it; its keywords: list_tracked_keywords. runsAppleSearchAds: yes if a sampled search ad showed the app in any country Asonix samples (7 days); unknown is not proof it does not advertise.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"country": {
"type": "string"
},
"include": {
"type": "array",
"items": {
"enum": [
"description",
"countryRatings",
"listingCountries",
"keywordSuggestions"
],
"type": "string"
},
"description": "Full lists to add: description, countryRatings, listingCountries, keywordSuggestions."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_app_visibility_history — App Visibility History
Return tracked ASO visibility score history for an app, useful for momentum and trend analysis.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"days": {
"type": "integer",
"maximum": 30,
"minimum": 2
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_app_rank_history — App Rank History
Return rank, popularity, or difficulty history for one tracked app keyword in a storefront.
{
"type": "object",
"required": [
"appStoreId",
"keyword"
],
"properties": {
"metric": {
"enum": [
"rank",
"popularity",
"difficulty"
],
"type": "string"
},
"country": {
"type": "string"
},
"keyword": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_app_rating_history — App Rating History
Return stored public rating history for any App Store app, tracked or not, with deltas: the history the Inspect dialog shows. Asonix records rating history only while some workspace tracks the app, so an app no workspace has tracked has none; for current ratings of any app, use get_app_overview. Omit country or pass "all" to return every observed storefront plus the all-countries aggregate; pass a country code to return only that storefront.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"country": {
"type": "string",
"description": "Optional App Store country to return. Omit it or pass \"all\" to return every stored country and the all-countries aggregate."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_app_charts — App Top Charts
Where any App Store app placed in Apple's iPhone top charts (free, paid, grossing; overall and by category) per storefront: best rank, days on chart, latest position. days: 7, 30 (default), 90 or 365. includeDailyCells adds a cell per chart per day: a number is the best position, -N absent from the top N, e empty chart, x not captured, u not collected yet, p pending; 90 and 365 days cover one storefront. iPad and Mac apps: iphone_only.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"days": {
"enum": [
7,
30,
90,
365
],
"type": "integer"
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"pattern": "^[1-9][0-9]{0,18}$"
},
"includeDailyCells": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_keyword_suggestions_for_app — App Keyword Suggestions
Refresh and return Asonix keyword suggestions for one tracked app and storefront. Includes suggestionRelevance rows and inline metadata-plan relevanceScore/relevanceStatus; missing scores queue in the background.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}research_app_keywords — Research App Keywords
Start keyword research for a tracked app in one call: Asonix suggestions, known public rankings and market keyword opportunities, each with the app's relevance. It can refresh the suggestion list, which spends the app's daily budget. Seed searches are checked privately unless storePublicly is true. Pending ad observations and relevance scores fill in on a later call. Classify candidates with evaluate_keywords before recommending or adding them.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"q": {
"type": "string"
},
"seed": {
"type": "string"
},
"sort": {
"enum": [
"revenue",
"downloads",
"opportunity",
"popularity",
"difficulty"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
},
"excludeBrands": {
"type": "boolean"
},
"storePublicly": {
"type": "boolean"
},
"competitorLimit": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"includeCompetitors": {
"type": "boolean"
},
"refreshSuggestions": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}extract_competitor_keywords — Competitor Keywords
Extract keyword opportunities from competitor public rankings and compare them against the tracked app. Includes relevanceScore/relevanceStatus for the target app, not the competitors; missing scores queue in the background. Provide competitorAppStoreIds, or provide a seed keyword to discover competitors from a private live SERP unless storePublicly is true. Rank and classify candidates with evaluate_keywords before recommending or adding them.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"q": {
"type": "string"
},
"seed": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"country": {
"type": "string"
},
"keyword": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
},
"competitors": {
"type": "array",
"items": {
"type": "string"
}
},
"competitorIds": {
"type": "array",
"items": {
"type": "string"
}
},
"storePublicly": {
"type": "boolean"
},
"competitorLimit": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"competitorAppStoreIds": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}get_localization_opportunities — Localization Opportunities
Build and return localization and translated market keyword opportunity requests for one tracked app.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}get_public_app_rankings — Public App Rankings
Return known public App Store keyword rankings where an app appears in collected SERPs.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}search_keywords — Search Keywords
Search Asonix keyword research summaries by query, market, platform, scores, and market estimates. iOS keyword rows include cached topAdvertisers; pending observations queue in the background, so retry this tool later.
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"page": {
"type": "integer",
"minimum": 1
},
"sort": {
"enum": [
"revenue",
"downloads",
"opportunity",
"popularity",
"difficulty"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"country": {
"type": "string"
},
"starred": {
"type": "boolean"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"maxRevenue": {
"type": "integer",
"minimum": 0
},
"minRevenue": {
"type": "integer",
"minimum": 0
},
"maxDownloads": {
"type": "integer",
"minimum": 0
},
"minDownloads": {
"type": "integer",
"minimum": 0
},
"excludeBrands": {
"type": "boolean"
},
"maxDifficulty": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"maxPopularity": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"minDifficulty": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"minPopularity": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"maxOpportunity": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"minOpportunity": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"maxKeywordLength": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_keyword_relevance — Keyword Relevance
App-specific relevance (0–100) of up to 100 keywords for a tracked app, from the same scorer as the UI. Returns at once with ready, pending, failed or unavailable for each keyword. Pending is not zero: call again after 3 seconds or more, backing off. retry=true retries failed work after its cooldown. Adds nothing to tracking or public research. country defaults to us and platform to ios.
{
"type": "object",
"required": [
"appStoreId",
"keywords"
],
"properties": {
"retry": {
"type": "boolean"
},
"country": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"pattern": "\\S",
"maxLength": 200,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"appStoreId",
"country",
"platform",
"profileStatus",
"scores"
],
"properties": {
"scores": {
"type": "array",
"items": {
"type": "object",
"required": [
"keyword",
"status",
"score"
],
"properties": {
"score": {
"type": [
"integer",
"null"
],
"maximum": 100,
"minimum": 0
},
"status": {
"enum": [
"ready",
"pending",
"failed",
"unavailable"
],
"type": "string"
},
"keyword": {
"type": "string"
}
}
}
},
"country": {
"type": "string"
},
"platform": {
"type": "string"
},
"appStoreId": {
"type": "string"
},
"profileStatus": {
"enum": [
"ready",
"pending",
"failed",
"unavailable"
],
"type": "string"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}evaluate_keywords — Evaluate Keywords
Rank and classify candidate keywords by Asonix popularity, difficulty and opportunity. Use it before recommending keywords or calling add_keywords. Known keywords reuse stored scores; up to 20 new ones per call are scored privately, without adding them to public research. Pass popularityScore and difficultyScore to judge your own values. appStoreId adds app relevance; pending is not zero (get_keyword_relevance).
{
"type": "object",
"required": [
"keywords"
],
"properties": {
"country": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"term": {
"type": "string"
},
"keyword": {
"type": "string"
},
"difficultyScore": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"popularityScore": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"opportunityScore": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
}
]
},
"maxItems": 50,
"minItems": 1
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"minLength": 1,
"description": "Optional tracked target app for inline relevance scores."
},
"excludeBrands": {
"type": "boolean"
},
"maxDifficulty": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"minPopularity": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"minOpportunity": {
"type": "integer",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"country",
"evaluations",
"isPartial",
"platform",
"relatedTools",
"thresholds"
],
"properties": {
"country": {
"type": "string"
},
"skipped": {
"type": "object",
"required": [
"count",
"reason"
],
"properties": {
"count": {
"type": "integer"
},
"reason": {
"type": "string"
}
}
},
"platform": {
"type": "string"
},
"isPartial": {
"type": "boolean"
},
"thresholds": {
"type": "object",
"required": [
"maxDifficulty",
"minOpportunity",
"minPopularity"
],
"properties": {
"maxDifficulty": {
"type": "number"
},
"minPopularity": {
"type": "number"
},
"minOpportunity": {
"type": "number"
}
}
},
"evaluations": {
"type": "array",
"items": {
"type": "object",
"required": [
"decision",
"difficultyScore",
"opportunityScore",
"popularityScore",
"rank",
"scoreStatus",
"term"
],
"properties": {
"rank": {
"type": "integer"
},
"term": {
"type": "string"
},
"decision": {
"enum": [
"primary",
"secondary",
"experimental",
"avoid"
],
"type": "string"
},
"scoredAt": {
"type": [
"string",
"null"
]
},
"keywordId": {
"type": "string"
},
"resultCount": {
"type": "integer"
},
"scoreStatus": {
"enum": [
"stored",
"checked",
"provided",
"failed",
"skipped"
],
"type": "string"
},
"relevanceScore": {
"type": [
"integer",
"null"
],
"maximum": 100,
"minimum": 0
},
"difficultyScore": {
"type": [
"number",
"null"
]
},
"popularityScore": {
"type": [
"number",
"null"
]
},
"rejectionReason": {
"type": "string"
},
"relevanceStatus": {
"enum": [
"ready",
"pending",
"failed",
"unavailable"
],
"type": "string"
},
"opportunityScore": {
"type": [
"number",
"null"
]
},
"averageTopAppRevenue": {
"type": "number"
},
"averageTopAppDownloads": {
"type": "number"
}
}
}
},
"relatedTools": {
"type": "array",
"items": {
"type": "object"
}
},
"relevanceAppStoreId": {
"type": "string"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}get_keyword_top_apps — Keyword Top Apps
Who ranks for a keyword in one storefront; appStoreId gives that app's rank. Uses results Asonix checked in the last 18 hours, else a private live check; saves nothing. Adds stored scores when Asonix has them; to score a new keyword, use evaluate_keywords. To find an app by name, use search_apps. runsAppleSearchAds: yes if a sampled search ad showed the app in any country Asonix samples (7 days); unknown is not proof it does not advertise.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"country": {
"type": "string"
},
"keyword": {
"type": "string",
"description": "The keyword text. Give this or keywordId."
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"keywordId": {
"type": "string",
"description": "An Asonix keyword ID, from search_keywords for example."
},
"appStoreId": {
"type": "string",
"description": "An app to find in the results: targetApp gives its rank, also beyond limit."
},
"includeScreenshots": {
"type": "boolean",
"description": "Include screenshot URLs for the first 10 apps."
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_keyword_top_advertisers — Keyword Top Advertisers
Apps seen in native App Store search ads for one iPhone keyword in one Apple Ads country: the last 7 days' check coverage, last seen, and 30 days of history. Cached only, no live Apple request; pending collection fills in on a later call. Absence does not prove an app stopped bidding or was outbid. Needs country and exactly one of keywordId or term.
{
"type": "object",
"required": [
"country"
],
"properties": {
"term": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"country": {
"enum": [
"ae",
"al",
"am",
"ar",
"at",
"au",
"az",
"be",
"bg",
"bh",
"bo",
"br",
"ca",
"ch",
"cl",
"cn",
"co",
"cr",
"cy",
"cz",
"de",
"dk",
"do",
"dz",
"ec",
"ee",
"eg",
"es",
"fi",
"fr",
"gb",
"gh",
"gr",
"gt",
"hk",
"hn",
"hr",
"hu",
"id",
"ie",
"il",
"in",
"iq",
"is",
"it",
"jo",
"jp",
"ke",
"kg",
"kh",
"kr",
"kw",
"kz",
"lb",
"lk",
"lu",
"lv",
"ma",
"mn",
"mo",
"mx",
"my",
"nl",
"no",
"np",
"nz",
"om",
"pa",
"pe",
"ph",
"pk",
"pl",
"pt",
"py",
"qa",
"ro",
"ru",
"sa",
"se",
"sg",
"si",
"sk",
"sv",
"th",
"tr",
"tw",
"ua",
"us",
"uz",
"vn",
"za"
],
"type": "string"
},
"platform": {
"enum": [
"ios"
],
"type": "string"
},
"keywordId": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"country",
"platform",
"keywordId",
"term",
"status",
"sampleCount7d",
"advertiserCount30d",
"lastCheckedAt",
"advertisers"
],
"properties": {
"term": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"observed",
"no_ads_observed",
"stale",
"pending",
"not_found",
"unavailable"
],
"type": "string"
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios"
],
"type": "string"
},
"keywordId": {
"type": [
"string",
"null"
]
},
"advertisers": {
"type": "array",
"items": {
"type": "object",
"required": [
"appStoreId",
"name",
"iconUrl",
"releaseDate",
"lastUpdatedAt",
"appearances7d",
"firstSeenAt",
"lastSeenAt",
"successfulChecksSinceLastSeen"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"iconUrl": {
"type": [
"string",
"null"
]
},
"appStoreId": {
"type": "string"
},
"lastSeenAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"releaseDate": {
"type": [
"string",
"null"
]
},
"appearances7d": {
"type": "integer"
},
"lastUpdatedAt": {
"type": [
"string",
"null"
]
},
"successfulChecksSinceLastSeen": {
"type": "integer"
}
}
}
},
"lastCheckedAt": {
"type": [
"string",
"null"
]
},
"sampleCount7d": {
"type": [
"integer",
"null"
]
},
"advertiserCount30d": {
"type": [
"integer",
"null"
]
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_app_search_ads_keywords — App Paid Keywords
Keywords where an iPhone app's App Store search ads were seen in the last 30 days, in all countries or one. Asonix checks each keyword about once a day, so a missing keyword may still be bid on. observedSharePercent7d is the share of the last 7 days' checks that showed the ad, not impression share. organicRank is null when the app is not in the latest results. status unavailable means ad data is off, not no ads.
{
"type": "object",
"required": [
"appStoreId"
],
"properties": {
"country": {
"enum": [
"ae",
"al",
"am",
"ar",
"at",
"au",
"az",
"be",
"bg",
"bh",
"bo",
"br",
"ca",
"ch",
"cl",
"cn",
"co",
"cr",
"cy",
"cz",
"de",
"dk",
"do",
"dz",
"ec",
"ee",
"eg",
"es",
"fi",
"fr",
"gb",
"gh",
"gr",
"gt",
"hk",
"hn",
"hr",
"hu",
"id",
"ie",
"il",
"in",
"iq",
"is",
"it",
"jo",
"jp",
"ke",
"kg",
"kh",
"kr",
"kw",
"kz",
"lb",
"lk",
"lu",
"lv",
"ma",
"mn",
"mo",
"mx",
"my",
"nl",
"no",
"np",
"nz",
"om",
"pa",
"pe",
"ph",
"pk",
"pl",
"pt",
"py",
"qa",
"ro",
"ru",
"sa",
"se",
"sg",
"si",
"sk",
"sv",
"th",
"tr",
"tw",
"ua",
"us",
"uz",
"vn",
"za"
],
"type": "string"
},
"appStoreId": {
"type": "string",
"pattern": "^[0-9]{1,20}$"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_keyword_history — Keyword History
Return keyword popularity or difficulty history for an Asonix keyword, with cached topAdvertisers for eligible iOS keywords. Pending advertiser observations are queued; retry later.
{
"type": "object",
"required": [
"keywordId"
],
"properties": {
"metric": {
"enum": [
"popularity",
"difficulty"
],
"type": "string"
},
"country": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"ipad",
"mac"
],
"type": "string"
},
"keywordId": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Prompts
Sign-in required
Resources
Sign-in required
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1704 ms
- 95th percentile latency
- 1704 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1704 ms · metadata changed · refuses unauthenticated resources/list (HTTP 401)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http asonix-mcp https://api.asonix.io/mcpCodex
codex mcp add asonix-mcp --url https://api.asonix.io/mcpCursor
{
"mcpServers": {
"asonix-mcp": {
"url": "https://api.asonix.io/mcp"
}
}
}Cline
{
"mcpServers": {
"asonix-mcp": {
"type": "streamableHttp",
"url": "https://api.asonix.io/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"asonix-mcp": {
"type": "http",
"url": "https://api.asonix.io/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http asonix-mcp https://api.asonix.io/mcpClaude Desktop
https://api.asonix.io/mcpWindsurf
{
"mcpServers": {
"asonix-mcp": {
"serverUrl": "https://api.asonix.io/mcp"
}
}
}Let your agent find its tools
Find servers like Asonix MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other developer tools servers
Do you run Asonix MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.