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

• Setup tutorial

• MCP release guide

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.