PubMed MCP Server

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": "[email protected]"
      },
      "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.

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.