PapersFlow
Academic research MCP server for paper search, citation checks, graphs, and deep research.
Open source Repository Open in the app JSON README (API)
About
Academic research MCP server for paper search, citation checks, graphs, and deep research.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- papersflow-ai
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 14
- Forks
- 1
- Last push
- 2026-03-11T23:39:21Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:00:59
- Updated
- 2026-08-29 04:00:59
- Origin id
io.github.papersflow-ai/papersflow
README
# 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.
<a href="https://glama.ai/mcp/servers/papersflow-ai/papers-flow">
<img width="380" height="200" src="https://glama.ai/mcp/servers/papersflow-ai/papers-flow/badge" alt="PapersFlow MCP server" />
</a>
## 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
- `search`
- `fetch`
- `verify_citation`
- `search_literature`
- `find_related_papers`
- `get_citation_graph`
- `get_paper_neighbors`
- `expand_citation_graph`
Authenticated and paid tools are available through PapersFlow account access and plan entitlements.
## Documentation
- [Setup tutorial](./docs/TUTORIAL.md)
- [MCP release guide](./docs/README.md)
## 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:
```bash
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:
```text
papersflow-mcp (from papersflow-mcp) - Disconnected (OAuth not authenticated)
```
that is expected until OAuth is completed inside Gemini:
```text
/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:
```json
{
"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.