App Pain API is an MCP server published by io.github.apppainapi, hosted at hawkmill.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 7 tools, including search_apps, mine_app_pain_points, get_pain_trend, get_app_details, get_version_history.
What users hate about ANY iOS/Android app: clustered complaints, evidence, trends. No key needed.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | 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" |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "search_apps",
"title": "Search apps",
"description": "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.",
"inputSchema": {
"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\""
}
}
},
"annotations": {
"title": "Search apps",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | 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… |
| 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 |
| 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 |
{
"name": "mine_app_pain_points",
"title": "Mine app pain points",
"description": "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).",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Mine app pain points",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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… |
{
"name": "get_pain_trend",
"title": "Pain-point trend",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Pain-point trend",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}App metadata: name, developer, category, price, average rating, rating count and 1-5★ histogram (when available).
| Parameter | 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… |
| country | string | ISO country code, default "us" |
{
"name": "get_app_details",
"title": "App details",
"description": "App metadata: name, developer, category, price, average rating, rating count and 1-5★ histogram (when available).",
"inputSchema": {
"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\""
}
}
},
"annotations": {
"title": "App details",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | 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… |
| country | string | ISO country code, default "us" |
{
"name": "get_version_history",
"title": "Version history",
"description": "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).",
"inputSchema": {
"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\""
}
}
},
"annotations": {
"title": "Version history",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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… |
| action * | string | one of ["list","add","remove","set_webhook","test"] |
| webhookUrl | string | for set_webhook (or add): https URL, e.g. a Slack incoming webhook or Discord channel webhook |
{
"name": "watch_competitors",
"title": "Watch competitors (alerts)",
"description": "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.",
"inputSchema": {
"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"
}
}
},
"annotations": {
"title": "Watch competitors",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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… |
| country | string | ISO country code, default "us" |
{
"name": "get_app_reviews",
"title": "Raw reviews",
"description": "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.",
"inputSchema": {
"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\""
}
}
},
"annotations": {
"title": "Raw reviews",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}App Pain API — review intelligence for ANY iOS / Android / macOS app, WordPress plugin or Chrome extension (not just your own); Steam apps and PC games are covered for details, ratings and search (review mining for Steam is not available yet). Typical flow: search_apps → mine_app_pain_points (the core tool: ranked complaint clusters with verbatim evidence) → drill down with get_pain_trend (what got worse / fixed over time), get_version_history (rating per release) or get_app_reviews (raw text). For ongoing tracking, watch_competitors pushes new 1-2★ reviews and rising pain points to Slack/Discord/webhooks (paid plans). appId accepts an App Store / Google Play / Steam / wp.org / Chrome Web Store URL, an iOS or Mac App Store numeric id, an Android package, a Steam appid, a WordPress plugin slug or a Chrome extension id; store is inferred when omitted (numeric ids: 5+ digits → iOS, shorter → Steam; dotted names → Android; plain lowercase slugs → WordPress; 32-char ids → Chrome — pass store:"macos" for Mac App Store apps). Cached analyses return instantly (popular apps are pre-warmed); a cold analysis takes 30-120s. Without an API key the server works anonymously with a small daily allowance of server-side analyses; beyond it, mine_app_pain_points returns prepared negative reviews with "instructions" ("mode":"agent") for you to cluster with your own model — do that and present the result. Found a bug, weird result or missing app? Email support@hawkmill.com — mention the error code if you got one; it goes straight to the developer.
Names, descriptions and schemas were written by the server and are shown as data.