Review rules for developers: API, MCP server and npm package

Three ways to check review text against Trustpilot's and Google's published rules: a REST API, an MCP server for AI assistants, and an MIT-licensed package with a command-line tool. All three run the same code and the same 20 rules. It is a heuristic, and the platform decides.

Get a free audit

100% risk-free. You only pay for the reviews that come down.

Is there an API for checking reviews against Trustpilot and Google rules?

Yes, and it is free with no key. POST /api/v1/check takes a review, or up to 50, and returns the rules each may break with the words that matched. The same checks run as an MCP server for AI assistants and as the MIT-licensed review-rule-check package. It is a heuristic, and the platform decides every report.

What is available

The REST API. POST /api/v1/check for one review or up to 50, and GET /api/v1/rules. The OpenAPI 3.1 spec describes both. Live now.
The MCP server. Five tools for AI assistants (check_review, check_reviews, get_rule, list_rules, get_removal_process), hosted at https://www.removeonestar.com/api/mcp. Live now, over Streamable HTTP. The same server runs locally over stdio from the review-rules-mcp package on npm.
The package. review-rule-check: TypeScript, zero dependencies, ESM and CommonJS, with a CLI. Read the package docs. It is on npm, with its source on GitHub.

The rules: 8 for Trustpilot and 12 for Google, each with a short quote from the platform’s own page, the link and the date we read it. They are the same rules as our bulk review checker and the rest of our free tools.

Add the MCP server to your assistant

Claude Code

claude mcp add --transport http review-rules https://www.removeonestar.com/api/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "review-rules": {
      "url": "https://www.removeonestar.com/api/mcp"
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "review-rules": {
      "command": "npx",
      "args": [
        "-y",
        "review-rules-mcp"
      ]
    }
  }
}

On Claude plans with custom connectors, Claude Desktop can use the hosted URL instead: add it under Settings, Connectors.

Any MCP client, over stdio

npx -y review-rules-mcp

Call the API

Check one review

curl -X POST https://www.removeonestar.com/api/v1/check \
  -H "Content-Type: application/json" \
  -d '{"platform":"trustpilot","text":"Use code SAVE20 at the other shop."}'

Check up to 50

curl -X POST https://www.removeonestar.com/api/v1/check \
  -H "Content-Type: application/json" \
  -d '{"platform":"google","reviews":["Call me on 555-0142.",{"text":"Friendly staff.","stars":5}]}'

List the rules

curl "https://www.removeonestar.com/api/v1/rules?platform=google"

Try it

Use the package

Install

npm install review-rule-check

In code

import { checkReview } from "review-rule-check";

const result = checkReview({ platform: "google", text: "Call me on 555-0142 for a better deal." });
result.verdict;        // "worth-flagging"
result.rules[0].name;  // "Advertising and solicitation"

From the command line

npx review-rule-check "Use code SAVE20 at the other shop" --platform trustpilot

Embed this checker

Put the review checker on your own site, free. Paste one of the two snippets below. The check runs inside the frame, in your visitor’s browser, and sends nothing anywhere. The embed keeps its attribution link, “Rule check by Remove One Star”, which opens the rule page for the result.

iframe snippet

<iframe src="https://www.removeonestar.com/embed/review-check" title="Review rule check by Remove One Star" loading="lazy" style="display:block;width:100%;max-width:640px;height:480px;border:1px solid #e7e5e0;border-radius:12px"></iframe>

Script snippetunder 2 kB, no dependencies. Set data-removeonestar-check to "google" for Google.

<div data-removeonestar-check="trustpilot"></div>
<script src="https://www.removeonestar.com/embed.js" async></script>

Live preview

Rate limits, privacy and what it cannot do

60 check requests a minute per IP address, with bursts of 30. A batch costs 1 plus 1 for every 10 reviews. The rules endpoint allows 120 a minute.
The MCP endpoint allows 60 requests a minute per IP address. A limited request gets a 429 and a Retry-After header.
No key, no account, and no review text stored or logged. Each request is checked in memory and answered. The browser extension sends nothing at all: see its privacy policy.
It is a keyword heuristic. It reads words, not facts, so it cannot see who wrote a review or when. It never predicts a decision. Every result carries the line: “Heuristic from removeonestar.com; the platform makes the decision.”

Licence

Both packages are MIT-licensed, copyright Remove One Star. Use them in anything, commercial or not; keep the copyright and licence notice. The API is free to use within the rate limits and our terms.

Where the code and the films live

YouTube: One short film for each of the 20 Trustpilot and Google review rules
GitHub: The source of review-rule-check, MIT-licensed
npm: The review-rule-check and review-rules-mcp packages

Free developer tools for Trustpilot and Google review rules. A REST API, an MCP server for AI assistants and an MIT-licensed package all run the same checks: which published rule a review may break, and which words matched. It is a heuristic, not a verdict, and the platform decides every report.

Questions from developers

No. The API and the MCP endpoint are free and open. They are rate limited per IP address: 60 check requests a minute, with bursts of up to 30.

No. The text is checked in memory and returned in the response. It is not stored, and our logs never contain it.

No. It names the rule a review may break and the words that matched. Trustpilot and Google decide every case, and they can see facts the text does not show. For a real count of your own reviews, ask for a free audit.

MIT. You can use it in commercial products, change it and ship it, as long as the copyright and licence notice stay with it.

Primary sources used on this page

For which reasons can businesses flag service reviews?. Trustpilot Help CenterLast verified September 21, 2026

Our tools and the free audit share one rule check, a transparent heuristic. How the rule check works explains what it looks for and what it cannot know.

Find out how many of your 1-star reviews we can remove

Send your Trustpilot or Google profile link. The audit is free, and you only pay for the reviews that come down.