Connect & Manage
Set up Paperguide in your AI assistant once, then search and read papers without leaving your chat.
Connect your AI assistant
You only need to do this once. After connecting, your assistant can search Paperguide and pull up paper details whenever you ask.
The same MCP URL works across all clients:
https://mcp.paperguide.ai/mcp
Find your assistant below and follow the steps.
Not sure which assistant to use? Claude and ChatGPT are the most popular for research questions. Cursor and VS Code are great if you also write code.
- Open connector settings — Go to Settings → Connectors → Add custom connector.
- Add the Paperguide server — Name it Paperguide and paste:
https://mcp.paperguide.ai/mcp
- Leave OAuth fields empty — Leave the OAuth client ID and secret fields empty. Registration is automatic.
- Connect and sign in — Click Connect. A browser window opens for you to sign in to Paperguide.
- Choose a billing account if needed — If you belong to an organization, choose which credit account pays for MCP usage.
- Open Apps and Connectors — Go to Settings → Apps & Connectors.
- Add the Paperguide server — Add a custom remote MCP server and paste:
https://mcp.paperguide.ai/mcp
- Enable developer mode if required — Developer mode may be required until Paperguide is listed in the ChatGPT app directory.
In ordinary chat, sources from an unlisted connector are used by the model but not shown as visible citations. This is ChatGPT's behavior for connectors outside its directory. Citations do render in Deep Research — select Paperguide as a source before starting the run.
- Open MCP settings — Go to Settings → Tools & MCP → New MCP Server, or edit the config file directly.
- Add the server configuration:
{
"mcpServers": {
"Paperguide": {
"url": "https://mcp.paperguide.ai/mcp"
}
}
}
Older Cursor versions cannot connect to remote servers directly. Use the mcp-remote bridge instead: set command to npx and args to ["-y", "mcp-remote@latest", "https://mcp.paperguide.ai/mcp"].
- Add the MCP server configuration:
{
"servers": {
"Paperguide": {
"url": "https://mcp.paperguide.ai/mcp"
}
},
"inputs": []
}
- Enable Paperguide tools in chat — Enable the Paperguide tools from the + button → Tools in the chat panel.
- Open MCP server settings — Go to Settings → Cascade → MCP Servers, or edit the config file.
- Add the server configuration:
{
"mcpServers": {
"paperguide": {
"serverUrl": "https://mcp.paperguide.ai/mcp"
}
}
}
- Add the MCP server — Run this command in your terminal:
claude mcp add --transport http paperguide https://mcp.paperguide.ai/mcp
- Sign in on first use — Sign in when prompted, or run
/mcpin a session.
- Add and log in to Paperguide — Run these commands:
codex mcp add paperguide --url https://mcp.paperguide.ai/mcp
codex mcp login paperguide
Add https://mcp.paperguide.ai/mcp as a remote server over HTTP transport. Clients that support the MCP OAuth flow handle sign-in automatically.
Credits
MCP uses the same AI credit balance as the rest of Paperguide — there's no separate allowance for it.
| Action | Credits |
|---|---|
| Search | 10 |
| Fetch a paper's full details | 2 |
Each question you ask your assistant typically costs around 15 credits — one search (10 credits) plus two or three fetches (2 credits each).
| Plan | Monthly credits | Approx. questions |
|---|---|---|
| Free | 1,000 | ~65 |
| Plus | 12,500 | ~830 |
| Pro | 50,000 | ~3,300 |
| Max | 150,000 | ~10,000 |
| Enterprise | Custom | — |
- If a call fails, you are not charged. The same applies if your assistant tries to fetch a paper that does not exist.
- Credits reset at the start of each billing cycle — on your subscription anniversary for paid plans, or at the start of each calendar month on Free.
- You can check usage at Settings → MCP.
- If you run out of credits, your assistant sees a message with the reset date. The connection stays active and starts working again when credits reset or you upgrade.
Organization credits
If you're part of an organization on Paperguide, you can choose whether MCP usage is billed from your personal plan or your organization's shared credits.
- Choose per connected app — one assistant can use organization credits while another uses your personal credits.
- Your choice stays fixed — if you want to switch later, disconnect and reconnect the app.
- Personal credits take over automatically — if you leave the organization, the connection falls back to your personal plan.
If you are not in an organization, Paperguide skips this choice and uses your personal credits automatically.
Manage connections
You can see and manage every AI assistant connected to your account at Settings → MCP.
- Disconnect an assistant — Revokes the app's access immediately. It stops being able to search until you reconnect it.
- Reconnect an assistant — Reconnect at any time. During reconnection, Paperguide asks for the billing account again.
Multiple entries with the same assistant name are normal. Each reconnection creates a separate authorization, and each one can be revoked independently.
What to do next
Your assistant is connected — you're ready to go! Start asking research questions and let Paperguide find the papers for you.