io.github.cyanheads/pubmed-mcp-server
REMOTE · PUBMED.CASEYJHAND.COM · 2 COMPONENTS · SCANNED SEP 20
Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.
Available components
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 → Why this is hard to 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 Usability76
- 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 3962 tokens (~330/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 Management100
- No destabilizing schema changes in the last 30 days.Pass
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
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 11 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the io.github.cyanheads/pubmed-mcp-server server?
io.github.cyanheads/pubmed-mcp-server is a hosted endpoint at https://pubmed.caseyjhand.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · pubmed.caseyjhand.com
claude mcp add --transport http cyanheads-pubmed-mcp-server 'https://pubmed.caseyjhand.com/mcp'
{
"mcpServers": {
"cyanheads-pubmed-mcp-server": {
"url": "https://pubmed.caseyjhand.com/mcp"
}
}
} {
"servers": {
"cyanheads-pubmed-mcp-server": {
"type": "http",
"url": "https://pubmed.caseyjhand.com/mcp"
}
}
} [mcp_servers.cyanheads-pubmed-mcp-server] url = "https://pubmed.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-pubmed-mcp-server": {
"type": "remote",
"url": "https://pubmed.caseyjhand.com/mcp",
"enabled": true
}
}
} openclaw mcp add cyanheads-pubmed-mcp-server --url 'https://pubmed.caseyjhand.com/mcp' --transport streamable-http
mcp_servers:
cyanheads-pubmed-mcp-server:
url: "https://pubmed.caseyjhand.com/mcp" {
"McpServers": {
"cyanheads-pubmed-mcp-server": {
"Transport": "http",
"Url": "https://pubmed.caseyjhand.com/mcp"
}
}
} assistant mcp add cyanheads-pubmed-mcp-server -t streamable-http -u 'https://pubmed.caseyjhand.com/mcp'
{
"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.
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.
- 18 Sept 26 0
- Server version: 2.10.13 → 2.10.14 functional
- 13 Sept 26 0
- Server version: 2.10.12 → 2.10.13 functional
- 11 Sept 26 0
- Tool “pubmed_fetch_fulltext” rewrote its description, which is the text the model reads security
- Schema quality: 274 → 330 ▼ functional
- Schema quality: 274 → 325 ▼ functional
- Server version: 2.10.11 → 2.10.12 functional
- Server version: 2.10.10 → 2.10.11 functional
- Server version: 2.10.9 → 2.10.10 functional
- Server version: 2.10.8 → 2.10.9 functional
- “pubmed_fetch_fulltext” added an optional parameter “includeAssets” cosmetic
- “pubmed_fetch_fulltext” added an optional parameter “includeTables” cosmetic
- “pubmed_convert_ids” reworded the description of “ids” cosmetic
- “pubmed_fetch_fulltext” reworded the description of “dois” cosmetic
- “pubmed_search_articles” reworded the description of “query” cosmetic
- “pubmed_spell_check” reworded the description of “query” cosmetic
- “pubmed_lookup_mesh” reworded the description of “query” cosmetic
- “pubmed_fetch_fulltext” reworded the description of “sections” cosmetic
- “pubmed_fetch_fulltext” reworded the description of “maxCharacters” cosmetic
- 9 Sept 26 0
- Stability: 0.97 → pass security
- Tool “pubmed_fetch_fulltext” rewrote its description, which is the text the model reads security
- Tool “pubmed_fetch_articles” rewrote its description, which is the text the model reads security
- Schema quality: 241 → 274 ▼ functional
- Server version: 2.10.7 → 2.10.8 functional
- Server version: 2.10.6 → 2.10.7 functional
- Server version: 2.10.5 → 2.10.6 functional
- “pubmed_fetch_fulltext” added an optional parameter “maxResponseCharacters” cosmetic
- “pubmed_fetch_articles” added an optional parameter “maxResponseCharacters” cosmetic
- “pubmed_fetch_fulltext” reworded the description of “maxCharacters” cosmetic
- 7 Sept 26 −1
- Stability: pass → 0.93 functional
- 3 Sept 26 0
- Server version: 2.10.4 → 2.10.5 functional
- 29 Aug 26 +1
- Stability: 0.97 → pass security
- 28 Aug 26 −1
- Stability: pass → 0.97 functional
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 20 Sept 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 | 4 Sept 2026 | 3 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | a6985204ed51ae050e7738aa6be668e9 |
| 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 |
Background: What to check on a remote MCP endpoint →
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 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
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 |
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. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
pubmed_convert_ids Pubmed Convert Ids ~210
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.
| 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 — one identifier per element, all of the same type. Each element is checked against `idType` before the request: `doi` starts with "10." and carries a "/" ("10.1093/nar… |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| records | array | – | Conversion results, one per input ID |
| totalConverted | number | – | Number of IDs successfully converted |
| totalSubmitted | number | – | 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.
| 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 |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| 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 | – | 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.
| 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 | – | Sources the query was filtered against (defaults applied) |
| cursorMark | string | – | Cursor used for this response (echoed from the request) |
| error | object | – | Present when the call failed. Absent on success. |
| hits | array | – | 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 | – | Effective query string echoed by Europe PMC |
| searchUrl | string | – | Europe PMC's website search URL for this query |
| totalCount | number | – | Total matching records across all pages |
No examples provided.
pubmed_fetch_articles Pubmed Fetch Articles ~223
Fetch full article metadata by PubMed IDs. Returns detailed article information including abstract, authors, journal, MeSH terms. Set `maxResponseCharacters` to bound the whole response: articles past the ceiling are deferred whole and listed in `deferred.ids` for a follow-up call.
| Name | Type | Req | Description |
|---|---|---|---|
| includeGrants | boolean | – | Include grant information |
| includeMesh | boolean | – | Include MeSH terms |
| maxResponseCharacters | integer | – | Opt-in ceiling for the whole response, in characters. Each article is measured as the JSON record it is returned as — title, abstract, authors, journal, MeSH terms, grants, identifiers, every field i… |
| pmids | array | yes | PubMed IDs to fetch |
| Name | Type | Req | Description |
|---|---|---|---|
| articles | array | – | Parsed articles |
| deferred | object | – | Continuation state for articles the whole-response budget withheld. Present only when `maxResponseCharacters` deferred at least one article. |
| error | object | – | Present when the call failed. Absent on success. |
| notice | string | – | Optional guidance when no articles were returned — points to discovery tools — or when `maxResponseCharacters` deferred articles, naming how to retrieve them. Absent on successful unbudgeted fetches. |
| totalReturned | number | – | Number of articles in this response. Under a `maxResponseCharacters` budget this counts the kept articles only; `deferred.deferredCount` covers the rest. |
| truncated | boolean | – | True when `maxResponseCharacters` withheld at least one resolved article. Absent when the response carries every article that resolved. The continuation state is in `deferred`. |
| unavailablePmids | array | – | PMIDs PubMed returned no record for. That is all this reports: PubMed omits an unknown PMID silently, with no error and no reason, so the absence says nothing about whether the PMID exists. Reported… |
No examples provided.
pubmed_fetch_fulltext Pubmed Fetch Fulltext ~1,559
Fetch full-text articles from PubMed Central with structured sections, tables, 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). Two independent character controls: `maxCharacters` caps body text per article, `maxResponseCharacters` caps the whole response and defers articles past the ceiling whole, listing them in `deferred.ids` for a follow-up call.
| Name | Type | Req | Description |
|---|---|---|---|
| dois | array | – | DOIs to resolve (e.g. ["10.21203/rs.3.rs-9010375/v1"]), one per element. Provide exactly one of `pmcids`, `pmids`, or `dois`. Resolved to a PMCID via the PMC ID Converter and returned as structured J… |
| includeAssets | boolean | – | Include the article's figures and supplementary material — `assets[]`, each with its label, caption, enclosing section and deposit pointer. On by default because it is cheaper than tables: a median a… |
| includeReferences | boolean | – | Include reference list. Applies to `source=pmc` results only. |
| includeTables | boolean | – | Include the article's tables — cells, captions, labels and footnotes. On by default because a dropped table takes its numbers with it. Table-dense articles pay for it: rendered tables typically add 1… |
| maxCharacters | integer | – | Per-article budget for body text, in characters. Counts `source=pmc` section and subsection text — which carries the inline blocks the parser renders in place, such as lists, definition lists, block… |
| 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… |
| maxResponseCharacters | integer | – | Opt-in ceiling for the whole response, in characters — the true response-wide counterpart to the per-article `maxCharacters`. Each article is measured as the JSON record it is returned as, after ever… |
| 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 (e.g. ["Introduction", "Methods", "Results", "Discussion"]). A term matches a section or subsection title at any nesting depth, case-insensitively, as a substring… |
| Name | Type | Req | Description |
|---|---|---|---|
| articles | array | – | Full-text articles |
| deferred | object | – | Continuation state for articles the whole-response budget withheld. Present only when `maxResponseCharacters` deferred at least one article. |
| error | object | – | Present when the call failed. Absent on success. |
| 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 | – | Number of articles in this response. Under a `maxResponseCharacters` budget this counts the kept articles only; `deferred.deferredCount` covers the rest. |
| truncated | boolean | – | True when a character budget shortened at least one returned body, or withheld a whole article. Absent when every resolved article is present with its full post-filter body. The per-article body acco… |
| 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. Distinct from `deferred`: nothing here is retr… |
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.
| 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 | – | Related articles |
| coverageFailures | array | – | Reference-coverage fallbacks that failed instead of answering, so the reference set is unverified rather than confirmed absent. Absent when every provider consulted answered. |
| error | object | – | Present when the call failed. Absent on success. |
| notice | string | – | Guidance when results are empty, a fallback provider answered, offset overshot, a fallback provider could not be reached, or upstream rows were excluded for carrying no PubMed PMID. Absent on a clean… |
| offset | number | – | Result offset used |
| relationship | string | – | Relationship type used |
| source | string | – | Provider that answered this request |
| sourcePmid | string | – | Source PubMed ID |
| totalCount | number | – | Total related articles found before windowing. A Europe PMC or OpenAlex total may shrink to the PubMed-addressable count once a request window covers the whole upstream set, since rows without a PubM… |
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.
| 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 | – | Citations per article |
| error | object | – | Present when the call failed. Absent on success. |
| notice | string | – | Optional guidance when no citations were produced — points to discovery tools. Absent when at least one citation was produced. |
| totalFormatted | number | – | Number of PMIDs successfully formatted |
| totalSubmitted | number | – | Number of PMIDs submitted for citation formatting |
| unavailablePmids | array | – | PMIDs PubMed returned no record for, so nothing could be cited for them. That is all this reports: PubMed omits a PMID it does not recognize silently, with no error and no reason, so the absence says… |
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.
| Name | Type | Req | Description |
|---|---|---|---|
| citations | array | yes | Citations to look up. More fields = better match accuracy. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| results | array | – | Match results, one per input citation |
| totalMatched | number | – | Number of citations with PMID matches |
| totalSubmitted | number | – | Number of citations submitted |
| totalWarnings | number | – | Number of matched citations that carry at least one warning |
No examples provided.
pubmed_lookup_mesh Pubmed Lookup Mesh ~161
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.
| 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. Must carry a term: a blank or whitespace-only value is rejected rather than searched. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| 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 | – | Result offset this page was read from |
| query | string | – | Original search query |
| results | array | – | Matching MeSH records |
| totalCount | number | – | Total MeSH descriptors matching the query upstream, before the maxResults cap |
No examples provided.
pubmed_search_articles Pubmed Search Articles ~422
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.
| 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). Must carry a search term: a value that is blank once markup is stripped is rejected rather than sent to PubMed as an empty term. |
| 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 | – | Normalized filter values that were applied to the PubMed query |
| effectiveQuery | string | – | Sanitized query sent to PubMed after applying all active filters |
| error | object | – | Present when the call failed. Absent on success. |
| 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 | – | Result offset used |
| pmids | array | – | PubMed IDs |
| query | string | – | Original query |
| searchUrl | string | – | PubMed search URL |
| summaries | array | – | Brief summaries (empty array when summaryCount is 0) |
| totalCount | number | – | Total matching articles |
No examples provided.
pubmed_spell_check Pubmed Spell Check ~63
Spell-check a query and get NCBI's suggested correction. Useful for refining search queries.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | PubMed search query to spell-check. Must carry a term: a blank or whitespace-only value is rejected rather than sent to ESpell. |
| Name | Type | Req | Description |
|---|---|---|---|
| corrected | string | – | Corrected query (same as original if no suggestion) |
| error | object | – | Present when the call failed. Absent on success. |
| hasSuggestion | boolean | – | Whether NCBI suggested a correction |
| original | string | – | Original query |
No examples provided.
What is the io.github.cyanheads/pubmed-mcp-server server?
io.github.cyanheads/pubmed-mcp-server is listed in the public MCP registry as io.github.cyanheads/pubmed-mcp-server. Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms. This page covers its hosted endpoint (https://pubmed.caseyjhand.com/mcp).
Is the io.github.cyanheads/pubmed-mcp-server server safe to use?
io.github.cyanheads/pubmed-mcp-server scores 82 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.cyanheads/pubmed-mcp-server server expose?
io.github.cyanheads/pubmed-mcp-server exposes 11 tools: pubmed_search_articles, pubmed_fetch_articles, pubmed_fetch_fulltext, pubmed_format_citations, pubmed_find_related, and 6 more. Their descriptions and schemas cost roughly 3,748 tokens of context every time the server is loaded.
Does the io.github.cyanheads/pubmed-mcp-server server require authentication?
No. We connected to io.github.cyanheads/pubmed-mcp-server without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the io.github.cyanheads/pubmed-mcp-server server still maintained?
io.github.cyanheads/pubmed-mcp-server is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.