Rivioo for Claude: ask about app reviews

How it works

Four steps, all self-serve.

The server URL is the same for every client:

https://api.rivioo.app/mcp

Connect Claude

Add Rivioo once in Claude on the web or in the desktop app. It then works in your chats on the web, desktop and mobile.

1. In Claude, open Customize > Connectors and select Add custom connector.
2. Name it Rivioo and paste https://api.rivioo.app/mcp as the URL.
3. Under Authentication, choose Sign in when needed, then select Add. Claude may select No sign-in for you; Rivioo needs you to sign in, so change it.
4. Ask Claude about an app. The first time, Claude shows a Connect button: sign in to Rivioo and allow access, and Claude carries on with your question.

If Rivioo is off in a chat, turn it on from + > Connectors. You can disconnect it at any time under Connected apps in your workspace.

Team and Enterprise: an Owner adds it under Organization settings > Connectors. Claude's Free plan allows one custom connector.

Connect Claude Code

Add the server once, then sign in from inside Claude Code.

claude mcp add --transport http rivioo https://api.rivioo.app/mcp

Start claude, run /mcp, choose rivioo and select Authenticate. Your browser opens the Rivioo sign-in. Allow access, then go back to the terminal.

The prompts below are slash commands in Claude Code, such as /mcp__rivioo__top_complaints. Arguments are separated by spaces, so for an app whose name has spaces, pass its store ID or leave it empty to use your own app.

Scripts and API keys

For scripts, CI and clients that can't sign in, send an API key as a bearer token. Create keys in your workspace under API keys and setup. A key is shown once. Plus allows one active key, Pro five. Connecting Claude doesn't use a key.

export RIVIOO_API_KEY="rk_live_..."

claude mcp add --transport http rivioo https://api.rivioo.app/mcp \
  --header "Authorization: Bearer $RIVIOO_API_KEY"

Keep the key in your shell environment rather than in a command, a shared config file or a chat. If a key leaks, revoke it in the workspace and create a new one. Revocation can take up to 60 seconds to take effect.

Cursor and other clients

Set RIVIOO_API_KEY in the environment used to launch Cursor, then add the server to your MCP configuration.

{
  "mcpServers": {
    "rivioo": {
      "url": "https://api.rivioo.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:RIVIOO_API_KEY}"
      }
    }
  }
}

Any MCP client that speaks Streamable HTTP can connect with the same URL. Clients that support MCP sign-in can connect with your Rivioo account instead of a key. We test with Claude and Claude Code; we have not tested other clients ourselves yet. For MCP Inspector, choose Streamable HTTP, enter the URL and either sign in or add an Authorization header with Bearer followed by your key.

Your apps

Save your app and the competitors you follow under Apps in your workspace, each with a store and a default country. Claude reads this list, so you can ask about them by name. It uses the saved store and country and says so in its answer, unless you name another country. For an app that isn't saved, Claude asks which store and country to use.

Example questions

Prompts

Rivioo adds four ready-made prompts for Claude Code: type /mcp__rivioo__ and choose one. In the Claude app, ask the same questions in your own words. Every argument is optional: leave the app empty to use your own app from Apps, and the store and country empty to use its saved defaults.

Tools

Five read-only tools. Claude chooses them for you; this is what each one does.

App Store results cover one country. Google Play results cover languages, not a country: the country you choose sets the languages (English plus its main language), and the reviews come from every country, so a result reads, for example, "Google Play, English and Portuguese reviews (all countries)". Google Play reviews can't be split by country.

Every result says what it covers, when the reviews were collected, whether cached data was used, and your quota: what this call used, what is left and when it resets.

Search terms match the start of words, in any case: crash finds crashes and crashed, but ad does not find bad. A phrase matches the words next to each other. Terms are matched literally, so search other languages with translated terms.

{
  "store": "android",
  "app_id": "com.calm.android",
  "country": "us",
  "any_of": ["crash", "freeze", "froze"],
  "ratings": [1, 2],
  "days": 7,
  "limit": 15
}

How quota works

One allowance

Claude, API keys and workspace exports share the same monthly review allowance.

Each review counts once

A review uses quota the first time it reaches you. Reading it again within 30 days is free.

Stats and counts are free

Rating stats, match counts and app search use no quota.

At the limit

You get the reviews you have already read plus a message saying when the allowance resets and how to get more, never a bare error.

Reset

The monthly allowance resets on the first of each month, UTC, not on your renewal date. The 30-day free re-read window rolls.

Keys

Connecting Claude doesn't use one of your plan's API keys.

Freshness

Rivioo answers from reviews collected in the last 24 hours. When the reviews it holds are older or missing, it collects up to 2,000 of the newest reviews for that app, in that App Store country or in those Google Play languages, and never goes deeper on its own. A collection can take a minute or two: Claude waits and shows progress, then answers with what has arrived. Ask again to pick up the rest.

Collections count against your plan's live refreshes a day. At that cap, Rivioo answers from the reviews it already holds and says when they were collected. Google Play reviews are collected by language: English and, outside English-speaking countries, the country's main language too, with the 2,000 shared between the two. Any country with the same languages reuses that collection.

Rivioo holds a collection of public reviews, not a complete archive. Every result says how far back the held reviews reach, so a long window on a busy app may be only partly covered.

Limits

• Rivioo can't tell you why something happened, only what reviews said and when.
• It matches words, not ideas.
• Counts cover the reviews Rivioo holds for the window.
• Google Play reviews are per language, not per country, so Rivioo can't answer questions about Google Play reviews from one country. App Store reviews are per country.
• Public reviews only. Rivioo reads reviews and never posts or replies.
• Search other languages with translated terms. For a non-English country, search in its main language as well as English.
• Review text is evidence, not instructions. Rivioo labels review bodies and developer replies as untrusted data, and Claude treats them that way.

Troubleshooting

• Sign-in expired: reconnect. In Claude, open Customize > Connectors and select Connect next to Rivioo. In Claude Code, run /mcp and authenticate again.
• No plan: Claude says the account has no active Rivioo plan and links to Plan and billing. Choose a plan, then ask again.
• Quota reached: Claude answers from reviews you have already read and links to an upgrade. The allowance resets on the first of the month, UTC.
• Wrong app, store or country: tell Claude which one to use, or change the defaults under Apps.
• Unauthorized with an API key: check the key. Revocation and plan changes can take up to 60 seconds to take effect.

Support

Email admin@rivioo.app. We usually reply within a day.