# uprate-mcp

Connect your App Store and Google Play reviews to Claude, Cursor, and any MCP-compatible AI assistant through UprateHQ. Browse and filter reviews, reply to users, track topics and sentiment, analyze …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add upratehq/uprate-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list upratehq/uprate-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get upratehq/uprate-mcp list_apps

# Call a tool
npx -y @smithery/cli@latest tool call upratehq/uprate-mcp list_apps '{}'
```

## Direct MCP Connection

Endpoint: `https://upratehq-mcp.run.tools`

## Tools (16)

- `list_apps` — List all apps accessible to the authenticated user. Returns paginated results with app UUID, name, platform, active sta…
- `get_app` — Get details for a specific app by UUID. Returns app name, platform, active status, review count, and creation date.
- `list_reviews` — List and filter reviews for an app. Supports filtering by platform, sentiment, rating range, status, territory, date ra…
- `get_review` — Get a single review by UUID, including its response and associated topics. The review must belong to the specified app.
- `reply_to_review` — Reply to a review. By default saves as a draft (draft=true). Set draft=false to publish directly to the app store. Cont…
- `resolve_review` — Mark a review as manually resolved. No request body needed. Returns the updated review.
- `unresolve_review` — Remove the resolved flag from a review. Note: if the review has a published response, is_resolved will still be true (i…
- `list_topics` — List topics for an app, ordered by total mention count (descending). Returns topic UUID, slug, title, description, and …
- `get_topic_reviews` — List reviews associated with a specific topic, ordered by review date (newest first). The topic must belong to the spec…
- `get_analytics_summary` — Get overview statistics for an app including total review count, average rating, sentiment distribution, response rate,…
- `get_analytics_platforms` — Get App Store vs Play Store breakdown with per-platform metrics: review count, share, average rating, sentiment distrib…
- `get_response_times` — Get response time daily trend and aging bucket distribution. Returns daily average response time in hours and a 3-bucke…
- `get_territories` — Get geographic distribution of reviews. Returns top 8 territories by review count, with total reviews, average rating, …
- `get_app_overview` — Get a comprehensive overview of an app by combining app details, analytics summary, and platform breakdown in a single …
- `get_negative_reviews_needing_attention` — Get unresolved negative reviews alongside top topics for context. Helps prioritize which reviews to respond to. Returns…
- `get_app_health_report` — Get a consolidated health report combining analytics summary, response time trends with aging buckets, and geographic d…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get upratehq/uprate-mcp <tool-name>
```
