Skip to main content
Glama
Medical Literature MCP Server

Medical Literature MCP Server

Medical Literature MCP Server

Zero-hallucination medical literature search across PubMed, Europe PMC, Semantic Scholar, OpenAlex, and CrossRef.

Every result is passed through from the source APIs; nothing is generated or inferred.

Quick Start

Requires Node.js 18+ and git. In a terminal (macOS, Linux, or Windows PowerShell):

git clone https://github.com/uglobetrotter/verified-medical-literature-mcp.git
cd verified-medical-literature-mcp
npm install
claude mcp add medical-literature -s user -- node "$PWD/dist/index.js"

npm install also builds dist/. Keep the clone where it is; Claude Code starts the server from that path. In Windows cmd.exe use %CD%\dist\index.js instead of $PWD/dist/index.js. CI runs these steps on Linux, macOS and Windows with Node 18 and 22. Update later with git pull and npm install.

The companion Claude Code plugin clinical-manuscript-gates calls these tools under the server name medical-literature; keep that name.

node tests/acceptance.mjs runs the acceptance tests (network mocked) and node tests/smoke.mjs node dist/index.js starts the server and lists its tools.

A one-line npx --package=github:uglobetrotter/verified-medical-literature-mcp medical-literature-mcp install works on some machines but failed in CI under npm 10 ("GitFetcher requires an Arborist constructor"); use the clone until that is resolved.

Related MCP server: litcheck-mcp

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "medical-literature": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/medical-literature-mcp/dist/index.js"],
      "env": {
        "NCBI_API_KEY": "YOUR_NCBI_KEY_HERE",
        "SEMANTIC_SCHOLAR_API_KEY": "YOUR_S2_KEY_HERE",
        "CONTACT_EMAIL": "your@email.com"
      }
    }
  }
}

Key

Where to get

Effect

NCBI_API_KEY

https://www.ncbi.nlm.nih.gov/account/

PubMed rate limit: 3 → 10 req/s

SEMANTIC_SCHOLAR_API_KEY

https://www.semanticscholar.org/product/api

S2 rate limit: 1 → 100 req/s

CONTACT_EMAIL

Your email

CrossRef + OpenAlex polite pool

SCOPUS_API_KEY

https://dev.elsevier.com/

Required by scopus_search

SCOPUS_INSTTOKEN

Institution / Elsevier

Optional; sent with the key when set

WOS_API_KEY

https://developer.clarivate.com/apis/wos-starter

Required by wos_search

Available Tools

Tool

Description

pubmed_search

PubMed/MEDLINE with MeSH, date range, publication type, author and journal filters, relevance or date order; reports total hits, PubMed's query translation and warnings

pubmed_fetch_by_pmid

Fetch full metadata + abstracts by PMID

europe_pmc_search

Europe PMC (PubMed + preprints + guidelines)

semantic_scholar_search

Semantic/AI-powered search + citation counts

openalex_search

200M+ works, open-access detection

scopus_search

Scopus query syntax, year range, sort by relevance, date or citations. First author only, no abstract (the COMPLETE view returned HTTP 401 on the tested key). Not part of multi_database_search

wos_search

Web of Science Core Collection (Starter API) with field tags, year range, sort by relevance, year or citations. No abstract; the free plan omits citation counts and allows 50 requests/day. Not part of multi_database_search

crossref_search

DOI-verified bibliographic search

resolve_doi

Resolve a DOI to verified CrossRef metadata

trace_citations

Forward/backward citation tracing via Semantic Scholar

multi_database_search

All databases simultaneously, deduplicated

retraction_status

Retraction / withdrawal / expression of concern / correction notices from CrossRef (incl. Retraction Watch data) and PubMed; each source reported CHECKED or NOT RUN

claim_context

Passages of the cited article (Europe PMC OA full text, else PubMed abstract) that match a claim, each shown with its section heading and neighbouring paragraphs (or the whole section); lists claim numbers absent from the source. The caller must then give SUPPORTS / PARTIAL / CONTRADICTS / NOT FOUND with a quoted sentence, labelled ABSTRACT-ONLY when only the abstract was available.

get_full_text

Open-access full text paragraph by paragraph with section headings; section filter and character cap

convert_ids

PMID ↔ PMCID ↔ DOI via Europe PMC

export_citation

BibTeX / RIS / CSL-JSON from doi.org content negotiation (registry metadata verbatim)

pubmed_cited_by

PubMed records citing a PMID (NCBI elink pubmed_pubmed_citedin, built from PMC reference lists, so it under-counts)

pubmed_references

A PMID's reference list as PubMed records (NCBI elink pubmed_pubmed_refs, where deposited)

pubmed_similar

PubMed "Similar articles", ordered by NCBI's relatedness score

pubmed_recent

Newest PubMed records for a topic within the last N days (recency, not attention)

verify_bibliography

Every BibTeX entry: identifier resolves, title/year/journal match, retraction status → PASS/WARN/FAIL with counts

Test with MCP Inspector

npm run inspector

Project Integration

Copy SKILL.md into your Claude Project as a Knowledge document. Claude will use it as the operating protocol for all literature searches.

Licence

MIT, see LICENSE. Each database's own terms of use apply to the data it returns.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to conduct academic research workflows such as paper discovery, literature mapping, citation chasing, author pivots, citation repair, and regulatory or species document retrieval.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables scientists and their AI agents to check quoted passages against pinned open-access PubMed Central full texts, look up retraction status from PMC and Crossref, and run recorded literature searches. Every quote check, search and annotation is written to an append-only, hash-chained log that can be verified, giving a dated record of what was searched and found.
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables keyless, read-only literature research by searching OpenAlex, Crossref, Europe PMC, PubMed and arXiv at once, merging and ranking results, following citations, retrieving open-access full text, looking up clinical trials, verifying citations, and exporting BibTeX, RIS or CSL-JSON without any accounts or API keys.
      10
      2
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables users to search scientific literature metadata across OpenAlex, Europe PMC, and Crossref, verify citations, retractions, source quotes, and claims, and build or export hash-chained evidence ledgers with explicit provenance and limitations.
      35
      5
      Apache 2.0