Find Research Papers README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the Find Research Papers listing page.

Scientific Research Papers MCP Server πŸ“„

Scientific literature grounding MCP server for AI agents: unified search across 250M+ scholarly papers on arXiv, PubMed, OpenAlex, CrossRef, and Semantic Scholar.

CI PyPI version npm version OpenSSF Scorecard License: MIT

🌐 Live Documentation & Web Portal: https://papers.builditwithai.xyz


⚑ Quickstart

bash
# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://papers.builditwithai.xyz/install" | bash

# Or run directly via your preferred runtime:
uvx find-research-papers-mcp
npx -y find-research-papers-mcp


πŸ€– Client Setup

A. Claude Code (CLI)

Terminal
claude mcp add papers -- uvx find-research-papers-mcp

B. Cursor & Google Antigravity (mcp.json)

config.json
{
  "mcpServers": {
    "papers": {
      "command": "uvx",
      "args": ["find-research-papers-mcp"]
    }
  }
}

C. Claude Desktop (claude_desktop_config.json)

config.json
{
  "mcpServers": {
    "papers": {
      "command": "uvx",
      "args": ["find-research-papers-mcp"]
    }
  }
}

D. VS Code (Cline / Roo Code / Continue)

config.json
{
  "mcpServers": {
    "papers": {
      "command": "npx",
      "args": ["-y", "find-research-papers-mcp"]
    }
  }
}

πŸ› οΈ Tools & Capabilities

Tool NameParametersDescriptionReturn Type
search_papersquery (string), sources (list), limit (int)Unified multi-index search across arXiv, PubMed, OpenAlex, CrossRef, Semantic Scholar.JSON / Markdown
get_paperdoi (string) or id (string)Retrieves paper metadata, abstract, authors, publication date, and open-access PDF link.JSON
get_referencesdoi (string)Fetches complete bibliography and referenced papers via CrossRef.JSON
get_citationsdoi (string)Fetches citing papers and citation graph via OpenAlex.JSON
verify_paperdoi (string)HEAD-checks landing page accessibility and cross-checks retraction databases.JSON
list_sources(none)Returns live status and latency metrics for all 5 scholarly indexes.JSON
skill_readskill_name (string)Dynamically loads research methodology skills from GitHub.Markdown
skills_list(none)Lists all available scientific research skills.JSON

πŸ”’ Telemetry & Privacy

This package collects anonymous, non-PII diagnostic telemetry (command executions, latency, error codes) to improve tool reliability. No research queries, paper results, personal data, source code, or environment variables are ever collected or stored.

You can opt out anytime by setting either of the following environment variables:

server.ts
export DO_NOT_TRACK=1
# or
export MCP_TELEMETRY_OPT_OUT=1

πŸ“„ License

MIT License. See LICENSE for details.