Repository avatar
AI Tools
v1.0.0
active

app-pain-api

io.github.hawkmill/app-pain-api

What users hate about ANY iOS/Android app: clustered complaints, evidence, trends. No key needed.

Documentation

App Pain API logo

App Pain API

What users hate about any iOS/Android app — clustered complaints, evidence quotes, trends. One MCP server, no API key.

MCP Streamable HTTP No key required SealKeeper Service SEAL

Live server · Docs · OpenAPI 3.1 · Pain index (101 apps) · Pricing


Review intelligence for any app on the App Store or Google Play — not just your own. Feed it an app id, a store link, or a bare package name; get back ranked pain-point clusters mined from real 1–2★ reviews, each with its share of complaints, a severity score, and verbatim evidence.

Built for competitive research and agent workflows: one tool call replaces a week of reading reviews by hand.

{
  "painPoints": [
    { "rank": 1, "title": "Intrusive ads & ad frequency", "sharePercent": 16, "severity": 4 },
    { "rank": 2, "title": "Shadowbanning & algorithm suppression", "sharePercent": 12, "severity": 4 }
  ],
  "overview": "Monetization pressure (ads) and opaque algorithm changes dominate complaints."
}

↑ real output — TikTok, US App Store. Cached analyses return instantly; ~100 popular apps are pre-analyzed and always free to read.

The tools

ToolWhat it does
search_apps ★Find apps on both stores (merged results, rich fields) — the step 1 of every teardown
mine_app_pain_points ★The core tool: fetch recent reviews, keep the negative ones, cluster them into ranked pain points with evidence quotes
get_pain_trendCompare two snapshots: what got worse, what got fixed (new / resolved / rising / falling)
get_version_historyRating per release — catch the version that broke things
get_app_reviewsRaw reviews, unified schema across stores (dev replies, thumbsUp)
get_app_detailsMetadata: rating histogram, category, price, IAP
watch_competitorsPaid: push new 1–2★ reviews and rising pain points to Slack/Discord/webhooks

Also ships two prompts (competitor_pain_report, app_pain_deep_dive) so an agent can run a full teardown from one sentence.

Install

Server URL — paste it into any MCP client, no key needed:

https://hawkmill.com/mcp
ClientHow
Claude Codeclaude mcp add --transport http app-pain-api https://hawkmill.com/mcp
Claude Desktop / claude.aiSettings → Connectors → Add custom connector → paste the URL
ChatGPTSettings → Apps & Connectors → Developer mode → Create → paste the URL, auth: No authentication
Cursor~/.cursor/mcp.json → {"mcpServers":{"app-pain-api":{"url":"https://hawkmill.com/mcp"}}}
VS Codecode --add-mcp '{"name":"app-pain-api","type":"http","url":"https://hawkmill.com/mcp"}'
Windsurf~/.codeium/windsurf/mcp_config.json → {"mcpServers":{"app-pain-api":{"serverUrl":"…/mcp"}}}
Codex CLI~/.codex/config.toml → [mcp_servers.app-pain-api] url = "…/mcp"
Gemini CLI~/.gemini/settings.json → {"mcpServers":{"app-pain-api":{"httpUrl":"…/mcp"}}}
stdio-only clientsnpx -y mcp-remote https://hawkmill.com/mcp

Keyless limits: unlimited cached results plus a few new analyses per day. Want your own quota (10/month free, more on paid tiers)? Register at POST /v1/register and add an x-api-key header. When the server-side allowance runs out, mine_app_pain_points degrades gracefully — it hands your agent the prepared negative reviews to cluster with its own model.

Try asking your agent

  • "What do users hate most about Duolingo, and is it getting better?"
  • "Compare the top 4 habit-tracker apps' pain points and find a product gap."
  • "Watch my 3 biggest competitors and alert our Slack when their users start complaining about something new."

Also a plain REST API

Everything the MCP server does is available over REST with JSON responses and a full OpenAPI 3.1 spec — same cache, same quota, one GET:

curl -s "https://hawkmill.com/v1/apps/ios/835599320/painpoints"

Pricing

Free tier forever (no credit card) · Starter $9/mo (any country, 500-review depth, watch 2 competitors) · Pro $29/mo (daily alerts for 15 competitors, unlimited analyses) — details on the site.

Notes

  • Data comes from public app-store pages, normalized into one schema. Not affiliated with Apple or Google.
  • All tools are read-only (readOnlyHint annotations set).
  • Speaks the classic initialize handshake (2024-11-05 → 2025-11-25) and answers the mandatory server/discover RPC from the 2026-07-28 spec — modern clients probe, see the supported version list, and fall back to the handshake automatically.
  • Cold analyses take 30–120s and stream progress notifications; repeat calls hit a 7-day cache and return in milliseconds.
  • Privacy · Terms · Acceptable use
  • Contact: support@hawkmill.com

No installation packages available.

Remote