Connect & Manage
Set up the Paperguide MCP server in your AI assistant, understand credit usage, and manage your connections.
Connect your AI assistant
The same MCP URL works across all clients: https://mcp.paperguide.ai/mcp. Find your assistant below and follow the steps.
Claude
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.
Claude Code
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 on first use, or run /mcp in a session.
ChatGPT
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.
Codex
Add and log in to Paperguide
Run these commands:
codex mcp add paperguide --url https://mcp.paperguide.ai/mcp
codex mcp login paperguide
Cursor
Open MCP settings
Go to Settings → Tools & MCP → New MCP Server, or edit the config file directly.
Add the server configuration
Add this 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"].
VS Code (GitHub Copilot)
Add the MCP server configuration
Add this to your MCP server config:
{
"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.
Windsurf
Open MCP server settings
Go to Settings → Cascade → MCP Servers, or edit the config file.
Add the server configuration
Add this configuration:
{
"mcpServers": {
"paperguide": {
"serverUrl": "https://mcp.paperguide.ai/mcp"
}
}
}
Other MCP clients
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 is no separate MCP allowance.
| Action | Credits |
|---|---|
| Search | 10 |
| Fetch a paper's full details | 2 |
| Plan | Monthly credits | Approx. searches |
|---|---|---|
| Free | 1,000 | 100 |
| Plus | 12,500 | 1,250 |
| Pro | 50,000 | 5,000 |
| Max | 150,000 | 15,000 |
| Enterprise | Custom | — |
A realistic research exchange — one search plus three fetches — costs 16 credits.
- Failed calls are not charged. An error or a fetch for a paper that doesn't exist costs nothing.
- Credits reset at the start of each billing cycle — the subscription anniversary for paid plans, the calendar month for Free.
- Usage is visible at Settings → Usage, under Connected Apps (MCP).
- When credits run out, the assistant receives a message with the reset date. The connection stays active and resumes when credits reset or the plan is upgraded.
Organization credits
Paperguide can bill MCP usage from your personal plan or your organization's shared credit pool. If you belong to an organization, Paperguide asks you to choose a billing account when you connect each app.
- Per connected app — Claude can bill the organization while Cursor bills personal.
- Fixed once chosen — to switch, disconnect and reconnect.
- Automatic fallback — if you leave the organization, the connection falls back to your personal credits.
If you are not in an organization, Paperguide skips this choice and uses your personal credits automatically.
Manage connections
Go to Settings → Profile → Connected Apps to see every AI assistant connected to your account, when it was connected, and which credit account it spends from.
Disconnect an assistant
Disconnect 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
Now that your assistant is connected, you can start searching and fetching papers directly from your MCP client.