TheWebRatings is built for coding agents. Mint a scoped setup token, paste one prompt into Claude Code or Cursor, and your agent claims your site, verifies ownership, and installs the review widgets — end to end.
In your TWR dashboard, generate a scoped setup token. It's limited to one site, expires in 7 days, and can be revoked anytime.
Copy the generated prompt (or MCP config) into Claude Code, Cursor, or any coding agent working in your site's repository.
It claims your site, adds the verification meta tag, deploys, verifies ownership, and installs the review widgets — then reports back.
Sign in to your dashboard to generate this prompt with a real setup token filled in. Your agent fetches the agent onboarding guide and follows it step by step.
Set up TheWebRatings (TWR) verified reviews for my site.
Site domain: detect it from this repository (check config, env, or deployment files).
Setup token: <your-setup-token>
First, fetch the agent onboarding guide at https://docs.thewebratings.com/agent-onboarding.md and follow it exactly. Authenticate every TWR API call with the header "X-Setup-Token: <your-setup-token>".
Then complete these steps in order:
1. Claim the site on TWR using the setup token.
2. Add the TWR verification meta tag returned by the claim step to this codebase (in the site's <head>).
3. Deploy the change.
4. Call the verify endpoint to confirm domain ownership.
5. Install the TWR collection widget — in the authenticated area of the app only (behind login), never on public pages.
6. Install the display badge only if the plan allows it. If the plan does not allow it, do not install the badge — report the upgrade link from the API response instead.
7. Run the validate endpoint to confirm everything is installed correctly.
8. Summarize what was done: what was claimed, what was installed and where, verification status, and anything that needs my attention.
Do not skip the guide — it is the source of truth for endpoints and payloads.Add the TWR MCP server and your agent gets first-class tools for claiming, verifying, and installing — no prompt engineering required.
claude mcp add thewebratings -e TWR_SETUP_TOKEN=<your-setup-token> -- npx -y @thewebratings/mcp{
"mcpServers": {
"thewebratings": {
"command": "npx",
"args": [
"-y",
"@thewebratings/mcp"
],
"env": {
"TWR_SETUP_TOKEN": "<your-setup-token>"
}
}
}
}A setup token is not an account credential. It expires after 7 days (configurable, 30 days max), is scoped to a single site, and can only perform setup actions — claim, verify, and install. You can revoke it anytime from your dashboard settings, and the full token value is shown exactly once when minted.
Create a free account, mint a setup token, and let your coding agent handle the entire TWR setup while you review the diff.