Skip to main content
Glama

medrxiv-mcp

MCP server that turns a medRxiv DOI into clean markdown full text — plus free, relevance-ranked preprint search.

  • 📄 Full-text retrieval — give it a DOI, get the whole paper as clean markdown (sections, tables, figure captions)

  • 🔍 Free search — relevance-ranked medRxiv search via Europe PMC, returns DOI + title + abstract + date

  • 🩺 Source of truth — full text comes from the official medRxiv .meca Text-and-Data-Mining archive, not scraped HTML

  • ⚡ Lazy local index — a DOI→file index is built on demand and cached in sqlite, so repeat fetches in a month are instant

  • 🔓 Your data, your key — full text reads a Requester-Pays S3 bucket with your own AWS key; nothing is shipped or shared

bioRxiv has its own package: biorxiv-mcp.

What is this?

This is a Model Context Protocol (MCP) server that gives AI assistants the full text of medRxiv preprints. Search is free (via the Europe PMC REST API). Full text is resolved from the official s3://medrxiv-src-monthly archive: the server maps a DOI to its month, scans that month's .meca archives once to build a local DOI→file index, downloads the one matching archive, extracts its JATS XML, and converts it to GitHub-flavored markdown with pandoc.

Designed for AI assistants like Claude to read primary literature directly. Works with any MCP-compatible client (Claude Desktop, Claude Code, or custom integrations).

Related MCP server: medRxiv-MCP-Server

Installation

uvx --from git+https://github.com/yogsoth-ai/medrxiv-mcp medrxiv-mcp

No manual install needed — uvx fetches and runs it. The bundled pandoc binary ships with the package, so you do not need a system pandoc.

Quick Start

1. Add to your MCP client

Claude Code — .mcp.json in your project root Claude Desktop — claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows)

{
  "mcpServers": {
    "medrxiv": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/yogsoth-ai/medrxiv-mcp", "medrxiv-mcp"],
      "env": {
        "AWS_ACCESS_KEY_ID": "<your key id>",
        "AWS_SECRET_ACCESS_KEY": "<your secret>",
        "AWS_DEFAULT_REGION": "us-east-1"
      }
    }
  }
}

2. Supply your AWS key

search_preprints is free and needs no key. fetch_fulltext reads a Requester-Pays bucket and does — see below.

3. Restart your MCP client

The server starts automatically when the client needs it.

Requires your own AWS key (Requester-Pays)

medRxiv full text is only reliably reachable through the official s3://medrxiv-src-monthly Text-and-Data-Mining bucket, which is Requester-Pays: you supply an AWS key, and your account pays the (tiny) transfer cost. The package never ships a key — each user brings their own.

Costs are small:

Action

Cost

search_preprints

free (Europe PMC, no AWS)

First fetch_fulltext in a given month

~$0.03 one-time (indexes that month)

Each fetch_fulltext after that

well under $0.01

Setup: in the AWS IAM console, create a user, attach the AmazonS3ReadOnlyAccess policy, create an access key, and put it in the env block above. Deactivate the key whenever you're done.

Optional env:

Variable

Default

Purpose

RXIV_CACHE_DIR

~/.cache/rxiv-mcp/

where the local DOI→file sqlite cache lives

RXIV_SCAN_CONCURRENCY

16

threads used when indexing a month

Available Tools

Tool

Description

search_preprints

Search medRxiv by keyword (relevance-ranked, free via Europe PMC). Returns [{doi, title, abstract, date}].

fetch_fulltext

Given a DOI, return the preprint's full text as markdown (reads the Requester-Pays S3 archive).

The intended workflow: search_preprints to find a paper and get its DOI cheaply, then fetch_fulltext on that DOI when you want to read it.

Example Queries

Ask Claude things like:

  • "Search medRxiv for recent preprints on long-COVID cardiovascular outcomes and summarize the top 3 abstracts"

  • "Fetch the full text of a medRxiv DOI and walk me through its statistical methods"

  • "Find preprints on a vaccine-efficacy trial, then read the most relevant one in full"

For Developers

git clone https://github.com/yogsoth-ai/medrxiv-mcp.git
cd medrxiv-mcp
pip install -e .
python -m pytest -v          # offline suite — no AWS, no network
python -m medrxiv_mcp.server # run the server locally (needs AWS env for fetch)

The offline test suite covers the non-trivial logic (JATS→markdown conversion and the .meca DOI parser) against fixtures it builds itself — no AWS spend, no network. Live search and S3 fetch are smoke-tested manually.

📄 License

Apache-2.0

Available Tools

2 tools
fetch_fulltextA

Fetch the full text of a preprint as markdown, given its DOI.

Downloads the paper's source package from the Requester-Pays S3 bucket (your AWS account pays a fraction of a cent), extracts the JATS XML, and converts it to markdown. First use of a given month is slower (it indexes that month once); later DOIs in the same month are fast.

Inputs: doi (required). Returns: result

search_preprintsA

Search bioRxiv/medRxiv preprints by keyword (relevance-ranked, free).

Returns a list of {doi, title, abstract, date}. Use the doi with fetch_fulltext to read the full text.

Inputs: query (required), limit. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one searches for preprints by keyword, the other fetches the full text of a specific preprint by DOI. There is no overlap or ambiguity.

    Naming Consistency5/5

    Both tools follow the verb_noun pattern consistently: 'search_preprints' and 'fetch_fulltext'. The naming is clear and predictable.

    Tool Count3/5

    With only two tools, the server feels minimal but covers the essential use case of finding and reading preprints. However, it is borderline thin and could benefit from additional tools for filtering or listing.

    Completeness3/5

    The tool surface covers the core workflow—search and fetch—but lacks features like filtering by date, author, or category, or listing recent preprints. Minor gaps exist that agents can work around.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      🔍 Enable AI assistants to search and access bioRxiv papers through a simple MCP interface. The bioRxiv MCP Server provides a bridge between AI assistants and bioRxiv's preprint repository through the Model Context Protocol (MCP). It allows AI models to search for biology preprints and access their
      27
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      🔍 Enable AI assistants to search and access medRxiv papers through a simple MCP interface. The medRxiv MCP Server provides a bridge between AI assistants and medRxiv's preprint repository through the Model Context Protocol (MCP). It allows AI models to search for health sciences preprints and acce
      10
      -
    • A
      license
      A
      quality
      C
      maintenance
      A local MCP server for searching scientific papers, retrieving metadata and abstracts, and legally downloading Open Access PDFs via OpenAlex, CrossRef, and Unpaywall APIs.
      5
      4
      MIT