io.github.cyanheads/pubmed-mcp-server

REMOTE · PUBMED.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3

Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.

Available components

remote · pubmed.caseyjhand.com 70 npm · @cyanheads/pubmed-mcp-server 35

+4 this week 70 70 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security66

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation not fully verified: no authorisation is required to call this server, and 11 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability75

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 2895 tokens (~241/item across 12 items; 11 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · pubmed.caseyjhand.com

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add --transport http cyanheads-pubmed-mcp-server https://pubmed.caseyjhand.com/mcp

# ~/.codex/config.toml

[mcp_servers.cyanheads-pubmed-mcp-server]
url = "https://pubmed.caseyjhand.com/mcp"

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-pubmed-mcp-server": {
      "type": "remote",
      "url": "https://pubmed.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add cyanheads-pubmed-mcp-server --url https://pubmed.caseyjhand.com/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  cyanheads-pubmed-mcp-server:
    url: "https://pubmed.caseyjhand.com/mcp"

// mcp.json

{
  "mcpServers": {
    "cyanheads-pubmed-mcp-server": {
      "type": "http",
      "url": "https://pubmed.caseyjhand.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
31 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
28 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
27 Jul 26 +1
- Stability: unverified → 0.03 ▲ functional
26 Jul 26 65

First indexed and scored.

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://pubmed.caseyjhand.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=caseyjhand.com	CN=WE1,O=Google Trust Services,C=US	7 Jul 2026	5 Oct 2026	ECDSA 256	ECDSA-SHA256	5aad900eb2055a0b0ea55912ec19680c
SANs: caseyjhand.com, *.caseyjhand.com
CN=WE1,O=Google Trust Services,C=US (CA)	CN=GTS Root R4,O=Google Trust Services LLC,C=US	13 Dec 2023	20 Feb 2029	ECDSA 256	ECDSA-SHA384	7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA)	CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE	15 Nov 2023	28 Jan 2028	ECDSA 384	SHA256-RSA	7fe530bf331343bedd821610493d8a1b

DNSSEC secure

Validation of pubmed.caseyjhand.com. — Secure

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
com.	present	19718	13	Verified
caseyjhand.com.	present	2371	13	Verified
pubmed.caseyjhand.com.				Verified address RRset verified with the apex keys

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Header	Value
strict-transport-security	max-age=63072000; includeSubDomains; preload
x-content-type-options	nosniff

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://pubmed.caseyjhand.com/mcp	Verified	200
http (plaintext)	http://pubmed.caseyjhand.com/mcp	HTTPS enforced	301	https://pubmed.caseyjhand.com/mcp

MCP tools — 11 exposed · ~2,681 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

pubmed_convert_ids Pubmed Convert Ids ~156

Convert between article identifiers (DOI, PMID, PMCID). Accepts up to 50 IDs of a single type per request. Only resolves articles indexed in PubMed Central — for articles not in PMC, use pubmed_search_articles instead.

Input Output Examples

Name	Type	Req	Description
idType	string	yes	The type of IDs being submitted. Required so the API can unambiguously resolve them.
ids	array	yes	Article identifiers to convert. All IDs must be the same type. DOIs: "10.1093/nar/gks1195", PMIDs: "23193287", PMCIDs: "PMC3531190" (the "PMC" prefix is optional — bare digits like "3531190" are also…

Name	Type	Req	Description
records	array	yes	Conversion results, one per input ID
totalConverted	number	yes	Number of IDs successfully converted
totalSubmitted	number	yes	Number of IDs submitted

No examples provided.

pubmed_europepmc_fetch Pubmed Europepmc Fetch ~201

Fetch complete Europe PMC records — including the full, untruncated abstract — for records addressed by `source` plus `epmcId`. Pairs with `pubmed_europepmc_search`, which returns bounded `abstractSnippet` values and flags cut ones with `abstractTruncated: true`; pass those hits' `source` and `epmcId` here to read the whole abstract. This is the retrieval path for preprint (`PPR`), patent (`PAT`), and Agricola (`AGR`) records, which frequently carry no PMID and no DOI, so `pubmed_fetch_articles` and `pubmed_fetch_fulltext` cannot address them. Up to 25 records per call.

Input Output Examples

Name	Type	Req	Description
records	array	yes	Records to retrieve, each addressed by the `source` and `epmcId` of a `pubmed_europepmc_search` hit. The whole batch resolves in one Europe PMC request.

Name	Type	Req	Description
notFound	array	—	Requested `source` + `epmcId` pairs Europe PMC returned no record for
notice	string	—	Guidance when one or more requested records could not be resolved. Absent when every record came back.
records	array	yes	Resolved records, in the order Europe PMC returned them

No examples provided.

pubmed_europepmc_search Pubmed Europepmc Search ~551

Search Europe PMC, a broad open-access biomedical corpus. Surfaces preprints (`source: PPR`), patents (`source: PAT`), Agricola (`source: AGR`), plus everything in PubMed (`MED`) and PMC. Use when additional coverage is needed — preprints and EPMC-only OA records are the typical recovery. Paginate via `cursorMark`. Defaults to `MED`, `PMC`, and `PPR`; pass `sources` to include `PAT` / `AGR`. Abstracts arrive as a bounded `abstractSnippet` with `abstractTruncated` marking the cut ones — pass a hit’s `source` and `epmcId` to `pubmed_europepmc_fetch` for the complete abstract.

Input Output Examples

Name	Type	Req	Description
cursorMark	string	—	Pagination cursor. Use `*` (default) for the first page; pass the previous response's `nextCursorMark` for subsequent pages.
pageSize	integer	—	Results per page. Max 100 per EPMC API.
query	string	yes	Europe PMC search query. Supports field tokens like `AUTH:"<name>"`, `JOURNAL:"<title>"`, `TITLE:"<words>"`, `PUB_YEAR:[2020 TO 2024]`, `DOI:"..."`, `EXT_ID:<pmid> AND SRC:MED`, `PMCID:PMC<digits>`.…
resultType	string	—	`core` returns abstract, IDs, dates, license; `lite` is a smaller payload with IDs and titles only.
sort	string	—	Optional EPMC sort: `<field> asc\|desc`. Documented sortable fields: `P_PDATE_D` (publication date), `CITED` (citation count), `AUTH_FIRST` (first author surname), `PUB_YEAR` (publication year). Examp…
sources	array	—	Filter to specific EPMC sources. Defaults to MED, PMC, PPR when omitted. Pass an explicit array including PAT or AGR to broaden coverage. Allowed values: MED, PMC, PPR, PAT, AGR.

Name	Type	Req	Description
appliedSources	array	yes	Sources the query was filtered against (defaults applied)
cursorMark	string	yes	Cursor used for this response (echoed from the request)
hits	array	yes	Matching Europe PMC records, in the order EPMC returned them
nextCursorMark	string	—	Cursor to pass back as `cursorMark` for the next page. Absent on the final page.
notice	string	—	Optional guidance when results are empty or paging overshot
query	string	yes	Effective query string echoed by Europe PMC
searchUrl	string	yes	Europe PMC's website search URL for this query
totalCount	number	yes	Total matching records across all pages

No examples provided.

pubmed_fetch_articles Pubmed Fetch Articles ~71

Fetch full article metadata by PubMed IDs. Returns detailed article information including abstract, authors, journal, MeSH terms.

Input Output Examples

Name	Type	Req	Description
includeGrants	boolean	—	Include grant information
includeMesh	boolean	—	Include MeSH terms
pmids	array	yes	PubMed IDs to fetch

Name	Type	Req	Description
articles	array	yes	Parsed articles
notice	string	—	Optional guidance when no articles were returned — points to discovery tools. Absent on successful fetches.
totalReturned	number	yes	Number of articles returned
unavailablePmids	array	—	PMIDs that returned no article data

No examples provided.

pubmed_fetch_fulltext Pubmed Fetch Fulltext ~763

Fetch full-text articles from PubMed Central with structured sections and references. When PMC misses, transparently falls back to Europe PMC `fullTextXML` (structured JATS for records with a PMC counterpart), then to Unpaywall — publisher-hosted or institutional open-access copies as HTML-as-Markdown or PDF-as-text. Provide exactly one of `pmcids` (PMC IDs directly), `pmids` (PubMed IDs, auto-resolved), or `dois` (DOIs, auto-resolved to PMC via the ID Converter; preprints and EPMC-only OA fall through to the Europe PMC and Unpaywall layers).

Input Output Examples

Name	Type	Req	Description
dois	array	—	DOIs to resolve (e.g. ["10.21203/rs.3.rs-9010375/v1"]). Provide exactly one of `pmcids`, `pmids`, or `dois`. Resolved to a PMCID via the PMC ID Converter and returned as structured JATS when the arti…
includeReferences	boolean	—	Include reference list. Applies to `source=pmc` results only.
maxCharacters	integer	—	Per-article budget for body text, in characters. Counts `source=pmc` section and subsection text, or the `source=unpaywall` `content` body; titles, abstracts, identifiers, and references are never co…
maxCharactersPerSection	integer	—	Budget for a single top-level body section, in characters, counting the section text plus its subsections. Combine with `maxCharacters` to cap both one section and the article; the tighter of the two…
maxSections	integer	—	Maximum top-level body sections. Applies to `source=pmc` results only.
overflowMode	string	—	How to spend `maxCharacters` across an article that exceeds it. truncate: fill sections in document order, so early sections stay whole and sections past the budget are dropped (counted in `truncatio…
pmcids	array	—	PMC IDs to fetch (e.g. ["PMC9575052"]). Provide exactly one of `pmcids`, `pmids`, or `dois`. PMC IDs with no retrievable full text fall through to Europe PMC, then to Unpaywall on the DOI the chain r…
pmids	array	—	PubMed IDs. Provide exactly one of `pmcids`, `pmids`, or `dois`. Articles in PMC are returned as structured JATS; articles not in PMC fall through to Europe PMC (when EPMC has a `fullTextXML`), then…
sections	array	—	Filter to specific sections by title, case-insensitive (e.g. ["Introduction", "Methods", "Results", "Discussion"]). Applies to `source=pmc` results only.

Name	Type	Req	Description
articles	array	yes	Full-text articles
notice	string	—	Optional guidance for a partial or empty body. A `sections`-filter miss names the requested terms and affected article id(s) and suggests retrying without `sections` or using broader headings. A meta…
totalReturned	number	yes	Number of articles returned
truncation	object	—	Character accounting for full text the budget shortened. Present only when a budget actually removed characters — its absence means every returned article carries its full post-filter body.
unavailable	array	—	Per-identifier explanations for any requested PMIDs, PMCIDs, or DOIs with no returnable full text. `idType` discriminates which branch the id came from.

No examples provided.

pubmed_find_related Pubmed Find Related ~142

Find articles related to a source article — similar content (similar), articles citing this one (cited_by), or articles this one cites (references). Uses NCBI ELink as the primary source; falls back to Europe PMC then OpenAlex when NCBI is unavailable.

Input Output Examples

Name	Type	Req	Description
maxResults	integer	—	Maximum related articles
offset	integer	—	Result offset for pagination (0-based); page through results by incrementing by maxResults
pmid	string	yes	Source PubMed ID
relationship	string	—	Relationship type: similar (content-based), cited_by (articles citing this one), references (articles this one cites)

Name	Type	Req	Description
articles	array	yes	Related articles
notice	string	—	Guidance when results are empty, a fallback provider answered, or offset overshot. Absent on a clean NCBI result page.
offset	number	yes	Result offset used
relationship	string	yes	Relationship type used
source	string	yes	Provider that answered this request
sourcePmid	string	yes	Source PubMed ID
totalCount	number	yes	Total related articles found before windowing

No examples provided.

pubmed_format_citations Pubmed Format Citations ~99

Get formatted citations for PubMed articles in one or more formats (apa, mla, bibtex, ris, vancouver). Pass a single format as a string or multiple as an array.

Input Output Examples

Name	Type	Req	Description
format	—	—	Citation format(s) to generate — single style as a string or multiple as an array. Allowed values: apa, mla, bibtex, ris, vancouver.
pmids	array	yes	PubMed IDs to cite

Name	Type	Req	Description
citations	array	yes	Citations per article
notice	string	—	Optional guidance when no citations were produced — points to discovery tools. Absent when at least one citation was produced.
totalFormatted	number	yes	Number of PMIDs successfully formatted
totalSubmitted	number	yes	Number of PMIDs submitted for citation formatting
unavailablePmids	array	—	Requested PMIDs that did not return article metadata

No examples provided.

pubmed_lookup_citation Pubmed Lookup Citation ~117

Look up PubMed IDs from partial bibliographic citations. Useful when you have a reference (journal, year, volume, page, author) and need the PMID — deterministic citation matching, more reliable than free-text search for structured references. Each citation must include at least journal or year (ECitMatch primary-keys on journal+volume+page; author-only or volume-only inputs guarantee no match); more fields = better match accuracy.

Input Output Examples

Name	Type	Req	Description
citations	array	yes	Citations to look up. More fields = better match accuracy.

Name	Type	Req	Description
results	array	yes	Match results, one per input citation
totalMatched	number	yes	Number of citations with PMID matches
totalSubmitted	number	yes	Number of citations submitted
totalWarnings	number	yes	Number of matched citations that carry at least one warning

No examples provided.

pubmed_lookup_mesh Pubmed Lookup Mesh ~144

Search and explore the MeSH (Medical Subject Headings) controlled vocabulary. Returns descriptor records with tree numbers, scope notes, and entry terms, plus pagination via offset for paging past the maxResults cap.

Input Output Examples

Name	Type	Req	Description
includeDetails	boolean	—	Fetch full MeSH records (scope notes, tree numbers, entry terms)
maxResults	integer	—	Maximum results
offset	integer	—	Result offset for pagination (0-based). Pass the `nextOffset` from the previous response to get the following page; the exact-descriptor match is pinned to the first page only.
query	string	yes	MeSH descriptor name or free-text term to look up

Name	Type	Req	Description
nextOffset	number	—	Offset to request for the next page. Omitted when this is the last page, so its absence is the end-of-results signal.
notice	string	—	Optional guidance when no descriptors matched or the offset overshot the result set — suggests spell-check, free-text search, or resetting the offset. Absent on successful result pages.
offset	number	yes	Result offset this page was read from
query	string	yes	Original search query
results	array	yes	Matching MeSH records
totalCount	number	yes	Total MeSH descriptors matching the query upstream, before the maxResults cap

No examples provided.

pubmed_search_articles Pubmed Search Articles ~394

Search PubMed with full query syntax, filters, and date ranges. Returns PMIDs and optional brief summaries. Supports field-specific filters (author, journal, MeSH terms), common filters (language, species, free full text), and pagination via offset for paging through large result sets.

Input Output Examples

Name	Type	Req	Description
author	string	—	Filter by author name (e.g. "Smith J")
dateRange	object	—	Filter by date range. The filter is applied only when both `minDate` and `maxDate` are non-empty; either one empty disables the entire date range.
freeFullText	boolean	—	Only include free full text articles
hasAbstract	boolean	—	Only include articles with abstracts
journal	string	—	Filter by journal name
language	string	—	Filter by language (e.g. "english")
maxResults	integer	—	Maximum results to return
meshTerms	array	—	Filter by MeSH terms. Multiple terms are AND'd — all must match.
offset	integer	—	Result offset for pagination (0-based). PubMed serves at most the first 9999 records of a result set, so this caps at 9998; narrow the query or add filters to reach anything beyond it.
publicationTypes	array	—	Filter by publication type (e.g. "Review", "Clinical Trial", "Meta-Analysis"). Multiple values are OR'd — any match qualifies.
query	string	yes	PubMed search query (supports full NCBI syntax)
sort	string	—	Sort order: relevance (default), pub_date (newest first), author, or journal
species	string	—	Filter by species
summaryCount	integer	—	Fetch brief summaries for top N results (0 = PMIDs only). Above the 50 cap, pass the remaining PMIDs to pubmed_fetch_articles.

Name	Type	Req	Description
appliedFilters	object	yes	Normalized filter values that were applied to the PubMed query
effectiveQuery	string	yes	Sanitized query sent to PubMed after applying all active filters
notice	string	—	Optional guidance when the result set does not reflect what was asked for — a field tag PubMed ignored, a phrase it matched nothing for, a dateRange dropped for having one bound, no matches at all, o…
offset	number	yes	Result offset used
pmids	array	yes	PubMed IDs
query	string	yes	Original query
searchUrl	string	yes	PubMed search URL
summaries	array	yes	Brief summaries (empty array when summaryCount is 0)
totalCount	number	yes	Total matching articles

No examples provided.

pubmed_spell_check Pubmed Spell Check ~43

Spell-check a query and get NCBI's suggested correction. Useful for refining search queries.

Input Output Examples

Name	Type	Req	Description
query	string	yes	PubMed search query to spell-check

Name	Type	Req	Description
corrected	string	yes	Corrected query (same as original if no suggestion)
hasSuggestion	boolean	yes	Whether NCBI suggested a correction
original	string	yes	Original query

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	65
27 Jul	66
28 Jul	67
30 Jul	68
31 Jul	69
1 Aug	69
2 Aug	70
3 Aug	70