biorxiv-mcp-server
Server Details
Search and retrieve bioRxiv and medRxiv preprints — by DOI, date interval, or keyword — via MCP.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/biorxiv-mcp-server
- GitHub Stars
- 4
- Server Listing
- @cyanheads/biorxiv-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 7 tools
Each tool targets a distinct resource+action: full text extraction, preprint metadata, journal crosswalk, category listing, two clearly differentiated date-based listings (posting vs journal publication), and keyword/author search. The descriptions explicitly cross-reference each other (e.g. get_published_version is framed as what to call after get_preprint reveals a publishedJournalDoi), resolving the only plausible confusions around DOI-based lookups.
All seven tools use a uniform biorxiv_ prefix followed by a verb_noun pattern (get_fulltext, get_preprint, get_published_version, list_categories, list_published_versions, list_recent, search_preprints). No mixed conventions or stylistic drift.
Seven tools map cleanly onto a preprint server's core jobs: metadata, full text, publication crosswalk, categories, recent listings, published-version listings, and search. Nothing feels redundant or missing at the count level.
The surface covers the full lifecycle well — discovery, metadata, full text, and preprint-to-journal crosswalk in both directions, with batch and pagination handling. Minor gaps: table cells must be fetched from an external URL outside the tool set, and there is no tool for retrieving a journal version's full text, which the description hints at as a richer alternative.
Available Tools
7 toolsbiorxiv_get_fulltextGet Preprint Full TextARead-onlyInspect
Retrieve a preprint's full text as best-effort Markdown, extracted from its rendered HTML article page. Reads the latest version unless one is requested (the version input, or a vN suffix on the DOI), confirms it via the details API, then fetches and extracts the body — abstract, sections, inline citation labels, and the reference list. Table cells are not on the article page: each table appears as its caption, and omittedTables names it with the URL that serves its cells. bioRxiv and medRxiv share the 10.1101/ DOI prefix, so server="both" (the default) resolves the DOI against both in parallel and the response reports which server answered. This is HTML-to-Markdown extraction, not structured JATS: section structure is approximate and not guaranteed. Long articles exceed a single response, so use offset and limit to page through them (the response reports totalChars, remainingChars, and hasMore); paging is cheap because the extracted article is cached per version for an hour after the first read, so only the first chunk pays for a fetch. Not every preprint has an extractable HTML page — some are PDF-only and some origins block programmatic access — in which case a fulltext_unavailable error routes you to biorxiv_get_preprint for the title, metadata, and current abstract. For a preprint that has been published in a journal, the journal's version may have richer full text elsewhere.
Inputs: doi (required), limit, offset, server, +1 more. Returns: cap, doi, error, shown, +15 more
biorxiv_get_preprintGet Preprint by DOIARead-onlyIdempotentInspect
Fetch full metadata, the abstract, all revision history, JATS XML full-text links, and published-journal DOI for one or more preprints by DOI. Each DOI returns all revisions in one response, with the abstract on the latest revision only — the API keeps one abstract per preprint. Each call looks up the first 10 distinct DOIs and returns the rest, never looked up, in unprocessed[] — pass that list as dois in another call to continue; a repeated DOI is looked up once and an unparseable entry is reported in failed[], so neither counts toward the 10. When server="both" (default), each DOI is checked against both bioRxiv and medRxiv; the response includes which server the preprint was found on. Failed lookups are reported per-DOI in failed[] rather than aborting the batch, each carrying a reason (not_found, invalid_doi_format, upstream_unavailable, rate_limited) and a retryable flag; a rate_limited entry also carries the wait in seconds the origin asked for. preprints[], failed[], and unprocessed[] follow input order. DOIs must match the pattern 10.NNNN/…; a doi.org or article URL, a doi: label, and a trailing vN / .full suffix are stripped first, and results report the bare DOI.
Inputs: dois (required), server. Returns: cap, error, shown, failed, +4 more
biorxiv_get_published_versionGet Published Journal VersionARead-onlyIdempotentInspect
Resolve a DOI to its preprint-to-journal crosswalk record — preprint DOI, journal DOI, journal name, published date, and corresponding author details — from either side: a preprint DOI (10.1101/ or 10.64898/) finds the journal article it was published as, and any other DOI is read as a journal article's and finds the bioRxiv or medRxiv preprint it was posted as. Use when biorxiv_get_preprint shows a publishedJournalDoi and you need the journal details, or when you hold a journal article and want its preprint. bioRxiv and medRxiv share their DOI prefixes, so server="both" (the default) checks both in parallel and the response reports which server answered. When the crosswalk holds no record for a published preprint, the journal DOI still comes back from the preprint's own record, without journal name or date, and a notice says so. Returns a not-found error when no server holds the preprint, it lists no journal version, or no preprint is recorded for the journal DOI.
Inputs: doi (required), server. Returns: error, notice, server, preprintDoi, +10 more
biorxiv_list_categoriesList bioRxiv/medRxiv CategoriesARead-onlyIdempotentInspect
List valid subject category strings for bioRxiv and medRxiv — the categories the listing API actually filters on. Use these strings as the category filter in biorxiv_list_recent to narrow results to a specific field; case, and "_" or "-" in place of a space, do not matter there. Run this tool before filtering to get the current valid values.
Inputs: no named parameters. Returns: error, biorxiv, medrxiv
biorxiv_list_published_versionsList Published Journal VersionsARead-onlyInspect
List preprints that appeared as journal articles within a journal publication-date interval, each with its journal DOI, journal name, publication date, and preprint metadata — the same record biorxiv_get_published_version returns for one DOI. The dates filter on journal publication, not preprint posting, so most rows were posted months or years earlier; use biorxiv_list_recent for preprints posted in an interval. publisher, a journal DOI prefix such as 10.7554 for eLife, limits the listing to the bioRxiv preprints published under it; those rows carry no journal name, authors, or abstract, and a prefix api.biorxiv.org does not recognize raises invalid_publisher. Returns limit publications per server (default 25, up to 100 — the page api.biorxiv.org serves; a larger limit returns 100 and says so). Continue at the nextCursor a page returns rather than stepping cursor by a fixed amount; limit: 100 walks an interval in the fewest calls. When server="both" (default), per-server pagination state is returned separately, since one cursor can be past the end of one server and inside the other — to continue a single server, pass its nextCursor with server set to that server. One server failing under server="both" does not abort the call: the other server's page is still returned and the failed one is named in failed[]. Every attempted server failing raises a retryable upstream_unavailable (or rate_limited) error rather than an empty page. Abstracts are omitted by default to keep the page small — pass include_abstract: true for the whole page. Every preprintDoi, 10.1101/ and 10.64898/ alike, is accepted by biorxiv_get_preprint and the other DOI tools.
Inputs: end_date (required), start_date (required), limit, cursor, +3 more. Returns: cap, error, shown, failed, +4 more
biorxiv_list_recentList Recent PreprintsARead-onlyInspect
List preprints posted or revised within a date interval, optionally scoped to one server or a subject category. Returns 30 preprints per page (fixed by the API); pass cursor as an integer offset (0, 30, 60, …) to step through additional pages. Abstracts are omitted by default to keep the page small — pass include_abstract: true for the whole page (each row carries the latest-revision abstract of its preprint, whichever revision the row is), or call biorxiv_get_preprint (up to 10 DOIs per call) for a few. When server="both" (default), per-server pagination state is returned separately — use each server's cursor field for independent advancement. One server failing under server="both" does not abort the call: the other server's page is still returned and the failed one is named in failed[], marking the result set as partial rather than complete. Every attempted server failing is a different case and does abort the call, with a retryable upstream_unavailable (or rate_limited) error — an empty page would otherwise be indistinguishable from an interval that genuinely holds nothing. Call biorxiv_list_categories for valid category strings; a server that answers a category filter with its unfiltered listing is left out with a notice, and invalid_category is raised when no server applied it. funder limits the listing to bioRxiv preprints funded by that organization, given its ROR ID; an ID api.biorxiv.org has no funder record for raises invalid_funder rather than returning an empty page.
Inputs: end_date (required), start_date (required), cursor, funder, +3 more. Returns: error, failed, notice, preprints, +2 more
biorxiv_search_preprintsSearch Preprints by KeywordARead-onlyInspect
Search preprints by keyword and/or author using EuropePMC for relevance ranking, then enrich matching DOIs with full bioRxiv/medRxiv metadata. Provide a keyword query, an author name, or both — author maps to an EuropePMC AUTH: field query and is ANDed with the keyword query. Covers both servers by default. EuropePMC indexes new preprints within 1–2 days of posting; for preprints posted within the last day, prefer biorxiv_list_recent. Abstracts are included by default; include_abstract: false omits them from every result for a response about a third the size, and biorxiv_get_preprint returns the abstract for up to 10 DOIs per call. A EuropePMC rate limit (HTTP 429) fails the call with a retryable rate_limited error carrying the wait in seconds — a rate-limited metadata enrichment does not, and instead marks the affected record enrichment_error: "rate_limited".
Inputs: limit, query, author, server, +4 more. Returns: cap, error, shown, notice, +6 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Peer-reviewed scientific paper & arXiv preprint search MCP with citations, abstracts & PDF links.
Unofficial Crossref MCP — wraps the Crossref REST API (academic papers, free, no auth)
PubMed MCP — wraps the NCBI E-utilities API (biomedical literature, free, no auth)
Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that turns a medRxiv DOI into clean markdown full text and provides free, relevance-ranked preprint search via Europe PMC.21Apache 2.0
- AlicenseAqualityDmaintenanceProvides access to bioRxiv and medRxiv preprints via a unified tool with seven methods, including keyword search, metadata retrieval, and statistics.11MIT
- AlicenseNot gradedqualityBmaintenanceEnables searching bioRxiv preprints by topic, date window, or field, looking up any DOI's latest version, publication status, journal and retraction flag, browsing the newest preprints, and exporting results or digests as JSON, Markdown, CSV, or BibTeX. All tools return a stable JSON envelope with request metadata and structured error codes.MIT
- AlicenseNot gradedqualityCmaintenanceEnables querying bioRxiv and medRxiv preprints, including metadata, publication status, and submission counts, through natural language or direct tool calls.96 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.