Examples

License: MIT MCP API docs

Ready-to-run scripts and MCP configs for the ReputeMap Google review management API: read and export Google reviews, watch review stats, trigger review-request emails — from Python, Node, cron, Zapier, or straight from Claude and Cursor via a hosted MCP server for Google reviews.

What you can automate:

• 📥 Pull every Google review you manage (filter by location, rating, unanswered, date) — with owner replies inlined
• 📊 Review stats per location: averages, 1–5 breakdowns, unanswered counts, trends
• ✉️ Trigger honest review-request emails from your CRM, billing system or a cron job
• 🤖 Talk to your reviews from Claude Code, Claude Desktop or Cursor via the hosted MCP server — zero code

Docs: API reference · MCP setup

Get an API key

1. Start a ReputeMap trial (14 days) or sign in
2. Settings → API keys → Create key — copy the rmk_… key (shown once)
3. Export it where the examples can find it:

export REPUTEMAP_API_KEY="rmk_your_key_here"

Every paid plan (and the trial) includes 1,000 API credits/month — one credit per billable call, GET /api/v1/me and GET /api/v1/usage are free. Never commit the key; all examples read it from the environment.

Connect Claude / Cursor (MCP)

The MCP server lives at https://api.reputemap.com/mcp and exposes five tools: list_locations, list_reviews, get_review_stats, send_review_request, get_usage.

Claude Code — one command:

claude mcp add --transport http reputemap https://api.reputemap.com/mcp \
  --header "Authorization: Bearer $REPUTEMAP_API_KEY"

Claude Desktop — merge mcp/claude_desktop_config.json into your config (Settings → Developer → Edit Config; needs Node.js for the mcp-remote bridge).

Cursor — copy mcp/cursor-mcp.json into ~/.cursor/mcp.json.

Then just ask:

"Show me every unanswered review under 3 stars from the last week, worst first." "How did the Downtown location's rating move this month?" "We finished the Hendersons' job — send them a review request."

Example scripts

No frameworks, no dependencies beyond the language runtime (jq for the shell tour).

Script	Language	What it does
examples/python/export_reviews_csv.py	Python 3 (stdlib)	Export all reviews to reviews.csv — pagination handled
examples/python/unanswered_reviews_digest.py	Python 3 (stdlib)	Weekly digest of unanswered reviews → stdout or Slack webhook
examples/python/low_rating_alert.py	Python 3 (stdlib)	Cron-able: new ≤3★ reviews from the last day → Slack alert
examples/node/send-review-request.js	Node 18+	Fire a review-request email after a sale ("deal won" hook)
examples/shell/api-tour.sh	bash + curl + jq	2-minute tour of every endpoint

# e.g.
python3 examples/python/export_reviews_csv.py
node examples/node/send-review-request.js --location <LOCATION_ID> --email [email protected] --name Sam
bash examples/shell/api-tour.sh

API cheatsheet

Base URL https://api.reputemap.com · auth Authorization: Bearer rmk_… (also X-API-Key or ?api_key=)

Endpoint	Credits	Notes
GET /api/v1/me	free	identity check (Zapier "Test Authentication")
GET /api/v1/usage	free	credits used / remaining this month
GET /api/v1/locations	1	locations + ids
GET /api/v1/reviews	1	filters: location_id, rating_min/max, has_reply, since_days, limit/offset
GET /api/v1/stats	1	per-location + totals; days window
POST /api/v1/review-requests	1	{location_id, email, name?} → sent | skipped | failed

Rate limit 60 req/min per org. Billable responses carry X-Credits-Remaining. Full details: API reference.

FAQ

Is there an official Google Reviews API? Google's Business Profile API exists but requires a lengthy approval process and only covers profiles you own. ReputeMap handles that integration for you — you get a simple key-authed REST API and an MCP server over every location you manage.

Does the MCP server work with any MCP client? Yes — it speaks standard MCP over streamable HTTP. Claude Code and Cursor connect natively; Claude Desktop connects through the mcp-remote bridge. Configs for all three are in mcp/.

Can Claude accidentally spam my customers? No. The single write action (send_review_request) goes through the same suppression/opt-out engine as in-app campaigns and is idempotent per location. Everything else is read-only. Revoke the key and access dies instantly.

What does it cost? The API and MCP server are included in every ReputeMap plan (from $29/mo, 14-day trial) — 1,000 credits/month, no separate API tier.

More from ReputeMap

• API reference · MCP setup guide
• Free Google review tools — review link generator, QR codes, Review Health Grader (no signup)
• Google review statistics — 29 sourced stats, free to cite (CC BY 4.0)
• How to get more Google reviews — the honest, FTC-compliant playbook

About ReputeMap

ReputeMap is Google review management software for local businesses and the agencies that serve them: unified review inbox, AI reply drafts, honest review requests (email + QR), negative-review alerts and white-label reports. Flat pricing from $29/mo, no sales calls.

License

MIT — use these examples in anything, commercial or not.