papersflow-ai/papersflow-mcp
📇 ☁️ - Hosted MCP server by PapersFlow for academic research with 7 specialized AI agents and 474M+ papers from Semantic Scholar and OpenAlex. Literature search, citation verification, citation graph exploration, and autonomous deep research workflows.
Quick Install
{
"mcpServers": {
"papersflow-ai-papersflow-mcp": {
"command": "npx",
"args": [
"-y",
"papersflow-ai-papersflow-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
papersflow-mcp
papersflow-mcp is PapersFlow's production / GA hosted MCP server for literature search, citation verification, related-paper discovery, and authenticated research workflows across Claude, Codex, Gemini, ChatGPT-style MCP apps, and other MCP clients.
Production Endpoint
- MCP URL:
https://doxa.papersflow.ai/mcp - OAuth protected resource metadata:
https://doxa.papersflow.ai/.well-known/oauth-protected-resource - OAuth authorization server metadata:
https://doxa.papersflow.ai/.well-known/oauth-authorization-server - Dynamic client registration:
https://doxa.papersflow.ai/oauth/register
Public Tool Surface
searchfetchverify_citationsearch_literaturefind_related_papersget_citation_graphget_paper_neighborsexpand_citation_graph
Authenticated and paid tools are available through PapersFlow account access and plan entitlements.
Documentation
Gemini CLI Extension
This repository also includes a root gemini-extension.json so Gemini CLI can install it as an extension wrapper around the hosted MCP server.
Official Gemini CLI flow supported by the docs:
gemini extensions install https://github.com/papersflow-ai/papersflow-mcp
The extension manifest lives at the repository root and points Gemini CLI at the hosted MCP endpoint using Gemini's remote MCP config shape.
If Gemini shows:
papersflow-mcp (from papersflow-mcp) - Disconnected (OAuth not authenticated)
that is expected until OAuth is completed inside Gemini:
/mcp auth papersflow-mcp
/mcp refresh
/mcp list
gemini extensions install installs the extension package. It does not complete OAuth during install. The browser opens when Gemini starts the remote MCP auth flow, typically via /mcp auth papersflow-mcp or the first auth-required connection attempt.
Gemini CLI references:
https://geminicli.com/docs/extensions/releasing/https://geminicli.com/docs/extensions/reference/https://geminicli.com/docs/extensions/writing-extensions/
Client Setup
Cline (VS Code)
Add PapersFlow as a remote MCP server in your Cline MCP settings:
{
"mcpServers": {
"papersflow": {
"url": "https://doxa.papersflow.ai/mcp",
"transportType": "streamable-http"
}
}
}
On first use, Cline will open a browser window for OAuth sign-in to your PapersFlow account. Public tools (literature search, citations, paper discovery) work immediately; authenticated tools require a PapersFlow plan.
Other Clients
Supported client paths today:
- Codex
- Claude Code
- Gemini CLI
- ChatGPT-style hosted MCP apps
The setup guide includes both command-style and config-style snippets where supported.
Support And Policies
- Website:
https://papersflow.ai - Privacy:
https://papersflow.ai/privacy - Terms:
https://papersflow.ai/terms - Support:
https://papersflow.ai/contact - Support email:
developer@papersflow.ai
Notes
- This repository is the public documentation and submission surface for the hosted MCP service.
- The production service is operated by PapersFlow and backed by the main PapersFlow platform.