What users hate about ANY iOS/Android app: clustered complaints, evidence, trends. No key needed.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional API key for a personal quota; omit to use the keyless daily allowance
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
App metadata: name, developer, category, price, average rating, rating count and 1-5★ histogram (when available).
App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps
optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable
ISO country code, default "us"
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http app-pain-api https://hawkmill.com/mcp
Headers
x-api-key (optional, not in the config above): Optional API key for a personal quota; omit to use the keyless daily allowanceApp metadata: name, developer, category, price, average rating, rating count and 1-5★ histogram (when available).
| Argument | Type | Description |
|---|---|---|
| appId* | string | App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps |
| store | string | optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable |
| country | string | ISO country code, default "us" |
{
"type": "object",
"required": [
"appId"
],
"properties": {
"appId": {
"type": "string",
"description": "App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps"
},
"store": {
"enum": [
"ios",
"macos",
"android",
"steam"
],
"type": "string",
"description": "optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass \"macos\" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable"
},
"country": {
"type": "string",
"description": "ISO country code, default \"us\""
}
}
}Fetch raw app reviews (unified schema across stores: rating/title/body/version/date/devReply/thumbsUp), 50 per page. Use for drill-down after mine_app_pain_points.
| Argument | Type | Description |
|---|---|---|
| page | integer | page number, default 1 (50/page) |
| sort | string | default recent (Android: both supported; iOS/macOS use the store default order) |
| appId* | string | App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps |
| store | string | optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable |
| country | string | ISO country code, default "us" |
{
"type": "object",
"required": [
"appId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "page number, default 1 (50/page)"
},
"sort": {
"enum": [
"recent",
"helpful"
],
"type": "string",
"description": "default recent (Android: both supported; iOS/macOS use the store default order)"
},
"appId": {
"type": "string",
"description": "App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps"
},
"store": {
"enum": [
"ios",
"macos",
"android",
"steam"
],
"type": "string",
"description": "optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass \"macos\" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable"
},
"country": {
"type": "string",
"description": "ISO country code, default \"us\""
}
}
}How an app's pain points changed over time: compares two archived analyses and labels each theme new / resolved / rising / falling / stable with share deltas (percentage points). Instant (archive read, no LLM). Default: latest vs ~30 days earlier. Returns a note when the app has fewer than two snapshots yet.
| Argument | Type | Description |
|---|---|---|
| to | string | comparison date YYYY-MM-DD (optional, default newest) |
| from | string | baseline date YYYY-MM-DD (optional) |
| appId* | string | App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps |
| store | string | optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable |
{
"type": "object",
"required": [
"appId"
],
"properties": {
"to": {
"type": "string",
"description": "comparison date YYYY-MM-DD (optional, default newest)"
},
"from": {
"type": "string",
"description": "baseline date YYYY-MM-DD (optional)"
},
"appId": {
"type": "string",
"description": "App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps"
},
"store": {
"enum": [
"ios",
"macos",
"android",
"steam"
],
"type": "string",
"description": "optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass \"macos\" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable"
}
}
}Per-version review stats (review count, average rating, first/last seen) — spot a rating crash right after a bad release. Android: aggregated from recent reviews. iOS: current version + release notes. Steam: not available (Steam exposes no per-version data — returns an empty list).
| Argument | Type | Description |
|---|---|---|
| appId* | string | App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps |
| store | string | optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable |
| country | string | ISO country code, default "us" |
{
"type": "object",
"required": [
"appId"
],
"properties": {
"appId": {
"type": "string",
"description": "App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps"
},
"store": {
"enum": [
"ios",
"macos",
"android",
"steam"
],
"type": "string",
"description": "optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass \"macos\" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable"
},
"country": {
"type": "string",
"description": "ISO country code, default \"us\""
}
}
}THE core tool: fetch recent reviews of any iOS/Android app, keep the negative ones, and cluster them into ranked pain points (title, sharePercent, severity 1-5, verbatim evidence quotes). Ideal for competitive research and product discovery. Cached 7 days (instant on repeat); a COLD server-side analysis takes 30-120s. If the result has "mode":"agent", it contains prepared negative reviews and "instructions" — do the clustering yourself and present it to the user. Not available for Steam (mine the game's mobile counterpart instead).
| Argument | Type | Description |
|---|---|---|
| appId* | string | App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps |
| model | string | premium refinement model (paid keys only). Omit for the free default. |
| store | string | optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable |
| analyze | string | who clusters on a cold run: "server" = our model; "agent" = you get the prepared negative reviews + instructions and cluster them with your own model; "auto" (default) = server, switching to agent when the server-side allowance is used up |
Search the iOS App Store and Google Play (both merged by default) to find apps and their ids; WordPress plugins / Chrome extensions / Steam games via store:"wordpress"|"chrome"|"steam". Use this FIRST when you only know an app name or a category.
| Argument | Type | Description |
|---|---|---|
| q* | string | search query, e.g. "habit tracker" or "notion" |
| limit | integer | max results per store, default 10 |
| store | string | limit to one store (default: iOS + Android merged; the others need to be passed explicitly) |
| country | string | ISO country code, default "us" |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "search query, e.g. \"habit tracker\" or \"notion\""
},
"limit": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "max results per store, default 10"
},
"store": {
"enum": [
"ios",
"macos",
"android",
"steam",
"wordpress",
"chrome"
],
"type": "string",
"description": "limit to one store (default: iOS + Android merged; the others need to be passed explicitly)"
},
"country": {
"type": "string",
"description": "ISO country code, default \"us\""
}
}
}Continuous competitor monitoring (paid plans: Starter 2 apps weekly, Pro 15 apps daily). Manage the watchlist and the alert destination; digests of NEW 1-2★ reviews and NEW/RISING pain points are pushed to a Slack / Discord / any https webhook. action: list | add | remove | set_webhook | test.
| Argument | Type | Description |
|---|---|---|
| appId | string | for add/remove: store URL, iOS/Mac id, Android package or Steam appid |
| store | string | optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass "macos" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable |
| action* | string | |
| webhookUrl | string | for set_webhook (or add): https URL, e.g. a Slack incoming webhook or Discord channel webhook |
{
"type": "object",
"required": [
"action"
],
"properties": {
"appId": {
"type": "string",
"description": "for add/remove: store URL, iOS/Mac id, Android package or Steam appid"
},
"store": {
"enum": [
"ios",
"macos",
"android",
"steam"
],
"type": "string",
"description": "optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass \"macos\" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable"
},
"action": {
"enum": [
"list",
"add",
"remove",
"set_webhook",
"test"
],
"type": "string"
},
"webhookUrl": {
"type": "string",
"description": "for set_webhook (or add): https URL, e.g. a Slack incoming webhook or Discord channel webhook"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 20, 2026.
| country | string | ISO country code, default "us" |
| reviews | integer | reviews to analyze, default 300 (other values round up to these tiers; Apple rate limiting can occasionally cap depth below the target) |
| maxRating | integer | ratings <= this count as negative, default 3 |
{
"type": "object",
"required": [
"appId"
],
"properties": {
"appId": {
"type": "string",
"description": "App Store / Google Play / Steam / WordPress.org / Chrome Web Store URL, iOS / Mac App Store numeric id (e.g. 324684580), Android package (e.g. com.spotify.music), Steam appid (e.g. 730), WordPress plugin slug (e.g. woocommerce) or Chrome extension id — get ids from search_apps"
},
"model": {
"enum": [
"glm-5.3-flash"
],
"type": "string",
"description": "premium refinement model (paid keys only). Omit for the free default."
},
"store": {
"enum": [
"ios",
"macos",
"android",
"steam"
],
"type": "string",
"description": "optional — inferred from appId (App Store URL or 5-12 digit id → ios, Play URL / package → android, Steam URL or 1-4 digit appid → steam); iOS and Mac App Store share the same URL shape, so pass \"macos\" explicitly for Mac apps. steam: details/search only for now — mining/reviews return steam_reviews_unavailable"
},
"analyze": {
"enum": [
"auto",
"server",
"agent"
],
"type": "string",
"description": "who clusters on a cold run: \"server\" = our model; \"agent\" = you get the prepared negative reviews + instructions and cluster them with your own model; \"auto\" (default) = server, switching to agent when the server-side allowance is used up"
},
"country": {
"type": "string",
"description": "ISO country code, default \"us\""
},
"reviews": {
"enum": [
100,
300,
500
],
"type": "integer",
"description": "reviews to analyze, default 300 (other values round up to these tiers; Apple rate limiting can occasionally cap depth below the target)"
},
"maxRating": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "ratings <= this count as negative, default 3"
}
}
}