app-pain-api
MCP server: what users hate about any iOS/Android app — clustered complaints, evidence, trends. No key needed.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/hawkmill--app-pain-api)HTML
<a href="/listings/hawkmill--app-pain-api"><img src="/api/listings/hawkmill--app-pain-api/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Server URL — paste it into any MCP client, **no key needed**:
https://hawkmill.com/mcp
| Client | How | |---|---| | **Claude Code** | `claude mcp add --transport http app-pain-api https://hawkmill.com/mcp` | | **Claude Desktop / claude.ai** | Settings → Connectors → *Add custom connector* → paste the URL | | **ChatGPT** | Settings → 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 Code** | `code --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 clients** | `npx -y mcp-remote https://hawkmill.com/mcp` |
**Keyless limits**: unlimited cached results plus a few new analyses per day. Want your own quota? Every new key starts with a **14-day Starter trial** (no card), then 10/month free — more on paid tiers. Register at [`POST /v1/register`](https://hawkmill.com/docs) 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.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 98 lines
- <div align="center">
- <img src="logo.svg" width="96" alt="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.**
- [](https://modelcontextprotocol.io)
- [](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports)
- [](#install)
- [](https://sealkeeper.run/agents/app-pain-api.quiet-delta.workers.dev/app-pain-api-quiet-delta-workers-dev)
- [Live server](https://hawkmill.com/mcp) · [Docs](https://hawkmill.com/docs) · [OpenAPI 3.1](https://hawkmill.com/openapi.json) · [Pain index (101 apps)](https://hawkmill.com/pains) · [Pricing](https://hawkmill.com/#pricing)
- </div>
- ---
- 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.
- ```json
- {
- "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."
- }
- ```
- <sub>↑ real output — TikTok, US App Store. Cached analyses return instantly; ~100 popular apps are pre-analyzed and always free to read.</sub>
- ## The tools
- | Tool | What 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_trend` | Compare two snapshots: what got worse, what got fixed (new / resolved / rising / falling) |
- | `get_version_history` | Rating per release — catch the version that broke things |
- | `get_app_reviews` | Raw reviews, unified schema across stores (dev replies, thumbsUp) |
- | `get_app_details` | Metadata: rating histogram, category, price, IAP |
- | `watch_competitors` | Paid: 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
- ```
- | Client | How |
- |---|---|
- | **Claude Code** | `claude mcp add --transport http app-pain-api https://hawkmill.com/mcp` |
- | **Claude Desktop / claude.ai** | Settings → Connectors → *Add custom connector* → paste the URL |
- | **ChatGPT** | Settings → 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 Code** | `code --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 clients** | `npx -y mcp-remote https://hawkmill.com/mcp` |
- **Keyless limits**: unlimited cached results plus a few new analyses per day. Want your own quota? Every new key starts with a **14-day Starter trial** (no card), then 10/month free — more on paid tiers. Register at [`POST /v1/register`](https://hawkmill.com/docs) 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](https://hawkmill.com/openapi.json) — same cache, same quota, one `GET`:
- ```bash
- curl -s "https://hawkmill.com/v1/apps/ios/835599320/painpoints"
- ```
- ## Pricing
- Free tier forever (no credit card) · **Starter $9/mo** or $90/yr (any country, 500-review depth, watch 2 competitors) · **Pro $29/mo** or $290/yr (daily alerts for 15 competitors, unlimited analyses) — details on the [site](https://hawkmill.com/#pricing).
- ## 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](https://hawkmill.com/privacy) · [Terms](https://hawkmill.com/terms) · [Acceptable use](https://hawkmill.com/aup)
- - Contact: [support@hawkmill.com](mailto:support@hawkmill.com)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.