- Home
- MCP servers
- PubMed
PubMed
- typescript
2
GitHub Stars
typescript
Language
5 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"augmented-nature-pubmed-mcp-server": {
"command": "node",
"args": [
"path/to/pubmed-server/build/index.js"
],
"env": {
"NCBI_EMAIL": "YOUR_EMAIL@example.com",
"NCBI_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}You get a PubMed MCP Server that exposes PubMed and PubMed Central APIs through a suite of MCP tools. It lets you search, retrieve, and analyze biomedical literature directly from your MCP-enabled environment, with real-time access to 36+ million citations and structured metadata across articles, abstracts,MeSH terms, and full text when available.
How to use
You interact with the PubMed MCP Server through your MCP client by selecting the tools you need, such as searching articles, retrieving abstracts, or batch lookups. Start by configuring a local MCP server instance as shown in the installation steps, then issue requests for search, retrieval, or citation data. The server handles rate limiting automatically and returns structured data that includes metadata, abstracts, MeSH terms, DOIs, and full-text availability when PMC provides it.
How to install
Prerequisites you need to prepare before running the server:
-
Node.js 16 or newer is required.
-
Optional: An NCBI API key improves rate limits. You can obtain one from your NCBI account settings.
Install the MCP server locally (basic configuration)
{
"mcpServers": {
"pubmed-server": {
"command": "node",
"args": ["path/to/pubmed-server/build/index.js"],
"autoApprove": [
"search_articles",
"get_article_details",
"get_abstract",
"validate_pmid"
]
}
}
}
Install the MCP server with an API key for higher rate limits
{
"mcpServers": {
"pubmed-server": {
"command": "node",
"args": ["path/to/pubmed-server/build/index.js"],
"env": {
"NCBI_API_KEY": "your_api_key_here",
"NCBI_EMAIL": "your_email@example.com"
},
"autoApprove": [
"search_articles",
"get_article_details",
"get_abstract",
"validate_pmid",
"search_by_author",
"search_by_journal"
]
}
}
}
Additional setup notes
These configurations are designed to work with standard MCP tooling. If you need to run the server locally, ensure your environment has network access to PubMed and PubMed Central endpoints, and that your Node.js installation is available in your shell path.
Configuration and usage tips
-
The server automatically throttles requests to comply with NCBI usage policies. Without an API key you are limited to a lower request rate; with a key you gain higher throughput.
-
You can perform a range of searches including keyword, author, journal, MeSH terms, and advanced boolean queries. Look for results with associated metadata such as PMIDs, DOIs, and PMC IDs when full text is available.
Troubleshooting
Common issues include invalid PMIDs, rate limit warnings, or missing full text. Verify PMIDs are numeric strings, ensure your API key (if used) is valid, and consider batch lookups for efficiency.
Tools and capabilities
The PubMed MCP Server exposes a comprehensive set of tools for literature discovery, retrieval, and analysis. See below for the primary tool categories and purposes.
Available tools
search_articles
Search PubMed by keywords, authors, journals, dates, or MeSH terms with pagination.
advanced_search
Execute complex queries with field-specific searches and boolean operators (AND/OR).
search_by_author
Find articles by specific author(s) with optional affiliation filtering.
search_by_journal
Search within specific journals with date range filtering.
search_by_mesh_terms
Search using MeSH terms with the option to filter by major topics.
get_trending_articles
Retrieve recently published articles in a chosen field within a configurable time window.
get_article_details
Fetch comprehensive metadata and abstract for a specific PMID.
get_abstract
Retrieve article abstract by PMID with basic metadata.
get_full_text
Retrieve full text from PMC when available.
batch_article_lookup
Efficiently retrieve multiple articles in a single request (up to 200 PMIDs).
get_cited_by
Find articles that cite a specific PMID.
get_references
Obtain the reference list for an article.
get_similar_articles
Find related articles based on content similarity.
export_citation
Export citations in formats such as APA, MLA, Chicago, BibTeX, and RIS.
validate_pmid
Validate PubMed ID format and verify article existence.
convert_identifiers
Convert between PMID, DOI, and PMC IDs.