List review requests

Review request emails with their status, customer, product and send date.

MCP tool judge_me_read → list_review_requests

read

Lists the requests on Reviews > Review requests, with next_cursor for the next page. request_id is the ID for send_review_request. source shows Manual for requests added by hand. A request for an unsubscribed email or with no email found carries that reason in status_note, and send_review_request cannot send it.

Parameters

Parameters: list_review_requests
NameTypeDescription
status string string Status as the Review requests page filter names it: Sent, Will send, Will skip, Waiting for delivery and the others it lists.
search string string Customer email or order number.
limit integer integer Reviews per page. Default: 20.
cursor string string Next page cursor from the previous call.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "judge_me_read",
    "arguments": {
      "operation": "list_review_requests",
      "arguments": {}
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "requests": [
      {
        "request_id": "rr_7731",
        "customer": "Dana K.",
        "email": "dana.k@example.com",
        "order": "#4790",
        "product": "Trail Jacket",
        "status": "Will send",
        "status_note": "",
        "source": "automatic",
        "scheduled_for": "2026-10-24"
      },
      {
        "request_id": "rr_7702",
        "customer": "Marcus R.",
        "email": "marcus.r@example.com",
        "order": "#4776",
        "product": "Camp Stove",
        "status": "Will skip",
        "status_note": "Unsubscribed email",
        "source": "automatic",
        "scheduled_for": "2026-10-22"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.