ReputeMap

List every business location this ReputeMap org manages, with ids to use in the other tools.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List Google reviews for the org (newest first) with the published reply text inlined. Filter by location, star-rating range, replied/unreplied, or a trailing day window. Google moderates owner replies: reply_state is approved, pending (Google is checking it) or rejected (not shown on Google - has_reply is false and reply_policy_violation says why; write a new reply).

{
  "type": "object",
  "properties": {
    "location_id": {
      "type": "string",
      "description": "UUID from list_locations; omit for all locations"
    },
    "rating_min": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "rating_max": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "unanswered_only": {
      "type": "boolean",
      "description": "true = only reviews without an owner reply on Google (a reply Google rejected counts as none)"
    },
    "since_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "only reviews from the last N days"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    }
  },
  "additionalProperties": false
}

Review stats per location and org totals: review counts, average rating, 1-5 star breakdown, unanswered count, and activity in the trailing window (default 30 days).

{
  "type": "object",
  "properties": {
    "location_id": {
      "type": "string",
      "description": "UUID from list_locations; omit for all locations"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "default": 30
    }
  },
  "additionalProperties": false
}

Send ONE review-request email to a real customer, through ReputeMap's campaign engine (respects unsubscribes and the suppression list). This emails a real person - only use it when the user explicitly asks to request a review. Returns status 'sent', 'skipped' (opted out or suppressed), 'already_requested' (this location already asked this address - no second email is sent and no credit is spent) or 'failed'.

{
  "type": "object",
  "properties": {
    "location_id": {
      "type": "string",
      "description": "UUID from list_locations"
    },
    "email": {
      "type": "string",
      "description": "customer email address"
    },
    "name": {
      "type": "string",
      "description": "customer name (optional)"
    }
  },
  "required": [
    "location_id",
    "email"
  ],
  "additionalProperties": false
}

Generate 2-3 reply drafts for one review using ReputeMap's tuned generator (the same one the app uses, with the business's saved voice and sign-off), and save the draft so it appears in the app's editor. NEVER publishes anything - drafts only.

{
  "type": "object",
  "properties": {
    "review_id": {
      "type": "string",
      "description": "UUID from list_reviews"
    },
    "instructions": {
      "type": "string",
      "maxLength": 300,
      "description": "optional one-off guidance for this draft, e.g. 'mention the new units' or 'keep it under 40 words'"
    }
  },
  "required": [
    "review_id"
  ],
  "additionalProperties": false
}

PUBLISH a reply to this review's public Google profile. This is a public, customer-visible action - call it ONLY when the user has explicitly approved this exact text (Google's policy: a person approves every reply; one call per approved reply, never in bulk). If Google refuses the request, the text is preserved in ReputeMap with a manual fallback (status 'manual_required') - words are never lost. Google also moderates replies: google_state 'pending' = it is checking the reply before showing it; status 'rejected_by_google' = it will not show it (policy_violation and detail say why) - write a different reply.

{
  "type": "object",
  "properties": {
    "review_id": {
      "type": "string",
      "description": "UUID from list_reviews"
    },
    "text": {
      "type": "string",
      "description": "the exact reply text the user approved"
    }
  },
  "required": [
    "review_id",
    "text"
  ],
  "additionalProperties": false
}

Current month's API credit usage for this org (shared between the REST API and MCP tools).

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}