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

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

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.

Papersflow MCP

Install / Use

README