Skip to Content

AI assistants (MCP)

ReviewerZero is available as a remote Model Context Protocol (MCP) server. An AI assistant connected to it can list and read your reviews, start a review of a manuscript at a URL or in a PDF file, and find peer reviewers, using the same account, workspace and credits as the API.

Endpoint

https://www.reviewerzero.ai/api/mcp

The server uses the Streamable HTTP transport and keeps no session between requests.

Connecting by signing in

Add the endpoint to your assistant without any credentials. The assistant opens a ReviewerZero page in your browser: sign in, choose the workspace it should work in, and allow access. The connection works in that workspace only, and uses its credits.

  • claude.ai and Claude Desktop: add a custom connector named ReviewerZero with the endpoint URL.
  • ChatGPT: add ReviewerZero as a custom connector with the endpoint URL.
  • Claude Code: add the server, then run /mcp and choose Authenticate.
claude mcp add --transport http ReviewerZero https://www.reviewerzero.ai/api/mcp
  • Cursor and VS Code: add the endpoint URL without headers; they ask you to sign in.

A connection lasts 15 days from when you allowed it; the assistant then asks you to sign in again. Each connection is listed in Settings → Integrations → Connected AI assistants, where Disconnect ends it at once.

The server follows the MCP authorization specification: a request without credentials is answered with 401 and a WWW-Authenticate header pointing to https://www.reviewerzero.ai/.well-known/oauth-protected-resource/api/mcp.

Connecting with an API key

For clients that send fixed headers, send your API key on every request, exactly as with the API. The x-organization-id header is optional and works as it does there: with it, the assistant works in that organization's workspace; without it, in your personal account.

HeaderValueRequired
AuthorizationBearer rz_xxxxxxxxxxxxYes
x-organization-idorg_xxxxxxxxNo

A revoked key is answered with 401, and more than 10 requests a second with one key with 429.

Claude Code

claude mcp add --transport http ReviewerZero https://www.reviewerzero.ai/api/mcp \
  --header "Authorization: Bearer $REVIEWERZERO_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ReviewerZero": {
      "url": "https://www.reviewerzero.ai/api/mcp",
      "headers": { "Authorization": "Bearer rz_xxxxxxxxxxxx" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "ReviewerZero": {
      "type": "http",
      "url": "https://www.reviewerzero.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${input:reviewerzero-api-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "reviewerzero-api-key", "description": "ReviewerZero API key", "password": true }
  ]
}

Add x-organization-id next to Authorization to connect to an organization's workspace.

Tools

ToolWhat it doesUses credits
list_reviewsLists the reviews in the workspace, newest first, with their statusNo
get_reviewReturns a review as its feedback letter, in the v2 beta shapeNo
start_reviewStarts a review of a manuscript PDF at a public URL and returns its review_idOne review
start_review_uploadReturns a link to upload a manuscript PDF file to; the upload starts the reviewOne review, on upload
find_reviewersStarts a reviewer search from a manuscript's title, abstract, keywords and authorsOne reviewer search
get_reviewer_searchReturns a reviewer search's progress, then its reviewersNo
list_reviewer_searchesLists the reviewer searches you started in the workspaceNo

A review takes several minutes and a reviewer search a few. start_review and find_reviewers answer at once with an id; the assistant reads the result later with get_review or get_reviewer_search. Text in a review's quote fields is quoted from the manuscript.

Reviewing a PDF file

A tool call cannot carry a file, so for a manuscript on your computer the assistant asks start_review_upload for an upload link and sends the PDF to it as the multipart form field file:

curl -sS -F "file=@paper.pdf" "https://www.reviewerzero.ai/api/mcp/upload/..."

The upload starts the review with the options given to start_review_upload and answers as POST /reviews does, with the review_id. A link works once and expires after 15 minutes. An assistant that runs commands in a sandbox with limited network access needs www.reviewerzero.ai among the sandbox's allowed domains.

When a request is refused (no credits left, a review that does not exist or is not yours, invalid input), the tool returns the same message the API would.