MCP
Paperpal MCP
Run Paperpal's pre-submission checks directly from Claude or ChatGPT.
10 min read
Paperpal MCP Server
Run Paperpal's manuscript checks on your own document from inside your AI assistant. Upload a .docx or .pdf file in the chat and get Grammar, Plagiarism, Reference, and Journal Fit results back on a live card, with links straight into the full Paperpal reports and editor.
The Paperpal MCP server is available through the official Claude and ChatGPT connector directories. It requires a Paperpal account: you sign in once when you connect, and every check runs on your own account, under your own plan and quota.
What it does
Paperpal MCP exposes Paperpal's pre-submission checks over the Model Context Protocol, so your AI assistant can:
- Take a manuscript you attach directly in the chat, or let you pick a file in a Paperpal upload card.
- Run up to four checks in one pass: Grammar, Plagiarism, References, Journal Fit.
- Show a live progress card that refreshes itself while checks run, then turns into a results card.
- Hand you deep links into Paperpal: the Plagiarism sources report, the Reference Check report, the Journal Fit report, and the Paperpal editor with grammar suggestions ready to review and incorporate in your document.
- Answer follow-up questions in plain language about results already shown ("what's my similarity score?", "which references need fixing?", "help me fix the plagiarism issues") without re-running anything.
- Show your remaining words / edits for each check and tell you when a check is available or excluded from your current Paperpal plan.
Use it to run pre-submission checks, checking similarity, verifying references and citations, polishing grammar, and checking journal compliance.
The four checks
| Check | What you get back | Notes |
|---|---|---|
| Grammar | Hands your document to the Paperpal editor, where grammar and language suggestions are already generated. The card gives you a View Edits link into the editor. | Runs on .docx files only. Not available for PDF — if you ask for Grammar on a PDF, the assistant tells you to upload a .docx instead. Consumes your Paperpal Grammar balance. |
| Plagiarism | An overall similarity percentage (or percentage range) plus a See sources link to the full matched-sources report. | Consumes words from your plagiarism quota, based on document length. Full report available on Prime and Pro plans. |
| References | A count of references to review, or "No References Flagged" when the list is clean, plus a View Report link. While it runs, the card shows its real progress stage ("Extracting references", "Analysing references"). | This is a paid feature. Available on Paperpal Prime and Pro plans only. |
| Journal Fit | A compliance verdict: No issues found, Warning, or Critical issues, plus a View Report link to the full journal-fit report. | Checks your manuscript against common journal submission requirements. Full report available on Paperpal Pro plans only. |
You can run any combination in a single request. Checks that can't run (Grammar on a PDF, References on a free plan, a check whose monthly quota is used up) are reported with the reason.
Not part of this connector
Paperpal's other features — AI Detection, AI Review, Rewrite / Paraphrase / Trim, Research and Cite, Translate, Templates, Chat with PDF, Agents, Illustrate, Library and Literature Search, are not available through the MCP connector. Use paperpal.com for those.
Available tools
Four tools are model-callable. These are what you'll see your assistant use:
| Tool | What it does |
|---|---|
| show_document_upload | Opens the Paperpal upload card so you can select or drag in a file and tick which checks to run. Used for generic requests like "check my paper" when nothing is attached. |
| check_attached_document | Takes a document you attached to your message, uploads it to Paperpal and starts the requested checks in one step. |
| get_check_run_status | Read-only refresh of a check run that's already in flight. Never starts a new run. |
| get_check_run_findings | Returns the findings as plain data (no card) so the assistant can answer a follow-up question about results already on screen. |
Setting it up
Claude (claude.ai and Claude Desktop)
- 1Open Settings > Connectors.
- 2Find Paperpal in the connector directory and click Connect.
- 3Sign in with your Paperpal account when prompted. The connector uses your own account for every check.
- 4Start a new chat and attach a manuscript, or just ask "check my paper." Claude opens the Paperpal card.
Team and Enterprise owners can enable it for a workspace from Admin settings > Connectors.
ChatGPT
- 1Open Apps.
- 2Locate Paperpal and add it.
- 3Sign in with your Paperpal account.
- 4Open a new chat, attach your manuscript and ask for a check.
After connecting, always start a new conversation. Existing chats do not always pick up a newly added connector's tools.
Files and limits
- Formats: .docx and .pdf
- Maximum file size: 25 MB
- Grammar and AI Detection: .docx only
- Everything else runs on both .docx and .pdf.
Results typically start appearing within a minute or two; the card keeps refreshing on its own until every requested check is done, so you don't have to ask for an update.
Example prompts
- "Check this manuscript for plagiarism and reference errors." (with the file attached)
- "Is my paper ready to submit?" opens the upload card with all available checks pre-selected.
- "Run a journal fit check on the draft I just attached."
- "Proofread this — run a grammar check." (.docx)
- "What's my similarity score?" — answered from the results already on screen.
- "Which references need fixing, and what's wrong with them?"
- "Help me fix the plagiarism issues you found."
Plans and quota
Every check runs against your own Paperpal plan and consumes your own balance. Plan details are available here: https://paperpal.com/pricing
Privacy and data handling
- You authenticate with your own Paperpal account. Your access token is used only to call the Paperpal API as you — there is no shared service credential, and the connector has no access to other users' documents.
- Documents uploaded via the connector are not used by Paperpal for training or any other purposes.
- The connector never lists or searches your Paperpal library. It can only see documents you upload or attach in the current conversation.
- Further details on Paperpal’s data security policies are outlined here: https://paperpal.com/data-security
Troubleshooting
The connector shows as connected but no Paperpal tools appear in chat.
Start a new conversation. Existing chats may not pick up newly added tools.
I attached a file but got the upload card instead of a check starting.
Some hosts don't give the connector a downloadable link for an attachment, only a private sandbox reference. In that case the connector opens the portable upload card instead. Select the same file there and continue; nothing is lost.
The connector won’t enable or sign-in fails.
Sign out of your ChatGPT/Claude account and sign back in, then reconnect Paperpal. If it still fails, remove the connector, add it again, and test in a new conversation.
I asked for a grammar check and got told to upload a .docx.
Grammar is .docx-only. Convert or export your PDF to `.docx` and re-upload. If you asked for Grammar alongside other checks on a PDF, the other checks still run — only Grammar is skipped.
Start a new conversation. Existing chats may not pick up newly added tools.
I attached a file but got the upload card instead of a check starting.
Some hosts don't give the connector a downloadable link for an attachment, only a private sandbox reference. In that case the connector opens the portable upload card instead. Select the same file there and continue; nothing is lost.
The connector won’t enable or sign-in fails.
Sign out of your ChatGPT/Claude account and sign back in, then reconnect Paperpal. If it still fails, remove the connector, add it again, and test in a new conversation.
I asked for a grammar check and got told to upload a .docx.
Grammar is .docx-only. Convert or export your PDF to `.docx` and re-upload. If you asked for Grammar alongside other checks on a PDF, the other checks still run — only Grammar is skipped.
FAQ
Do I need a Paperpal account?
Yes. The connector runs every check on your own Paperpal account, under your own plan and quota. You sign in once when you connect.
Does it use my Paperpal plan's words/credits?
Yes, the MCP uses the same balance you'd use on paperpal.com. The results card shows your usage for each check.
Can it find documents I've already uploaded to Paperpal?
No, the connector only works with a document you upload or attach in the current conversation; it never lists or searches your Paperpal library.
Will asking a follow-up question re-run my checks and spend more quota?
No. Follow-up questions are answered from the results already retrieved. Checks are only re-run if you explicitly ask for a re-run.
Can I keep editing in Paperpal after a check?
Yes. The Grammar card links straight into the Paperpal editor with suggestions ready, and the report links open the full Paperpal reports where you can act on each finding.
Are the results the same as on paperpal.com?
Yes, the connector calls the same Paperpal services. The card is a compact view; the linked reports are the full ones.
Can I use this for a thesis or a journal submission?
Yes, that's the intended use. Always review findings in the full Paperpal report before acting on them.
Yes. The connector runs every check on your own Paperpal account, under your own plan and quota. You sign in once when you connect.
Does it use my Paperpal plan's words/credits?
Yes, the MCP uses the same balance you'd use on paperpal.com. The results card shows your usage for each check.
Can it find documents I've already uploaded to Paperpal?
No, the connector only works with a document you upload or attach in the current conversation; it never lists or searches your Paperpal library.
Will asking a follow-up question re-run my checks and spend more quota?
No. Follow-up questions are answered from the results already retrieved. Checks are only re-run if you explicitly ask for a re-run.
Can I keep editing in Paperpal after a check?
Yes. The Grammar card links straight into the Paperpal editor with suggestions ready, and the report links open the full Paperpal reports where you can act on each finding.
Are the results the same as on paperpal.com?
Yes, the connector calls the same Paperpal services. The card is a compact view; the linked reports are the full ones.
Can I use this for a thesis or a journal submission?
Yes, that's the intended use. Always review findings in the full Paperpal report before acting on them.
Support
- Website: http://paperpal.com/
- Email: hello@paperpal.com