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/mcpThe 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
/mcpand 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.
| Header | Value | Required |
|---|---|---|
Authorization | Bearer rz_xxxxxxxxxxxx | Yes |
x-organization-id | org_xxxxxxxx | No |
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
| Tool | What it does | Uses credits |
|---|---|---|
list_reviews | Lists the reviews in the workspace, newest first, with their status | No |
get_review | Returns a review as its feedback letter, in the v2 beta shape | No |
start_review | Starts a review of a manuscript PDF at a public URL and returns its review_id | One review |
start_review_upload | Returns a link to upload a manuscript PDF file to; the upload starts the review | One review, on upload |
find_reviewers | Starts a reviewer search from a manuscript's title, abstract, keywords and authors | One reviewer search |
get_reviewer_search | Returns a reviewer search's progress, then its reviewers | No |
list_reviewer_searches | Lists the reviewer searches you started in the workspace | No |
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.