search_pubmed_articles

Search PubMed for biomedical articles using specific keywords and optional filters like date range, publication types, and sorting. Retrieve PMIDs and brief summaries in JSON format.

Instructions

Searches PubMed for articles using a query term and optional filters (max results, sort, date range, publication types). Uses NCBI ESearch to find PMIDs and ESummary (optional) for brief summaries. Returns a JSON object with search parameters, ESearch term, result counts, PMIDs, optional summaries (PMID, title, authors, source, dates), and E-utility URLs.

Input Schema

Name	Required	Description	Default
`dateRange`	No	Defines an optional date range for the search, including min/max dates and the type of date field to use.
`fetchBriefSummaries`	No	Number of top PMIDs for which to fetch brief summaries using ESummary v2.0. Set to 0 to disable. Maximum is 50 for this tool. Default is 0.
`filterByPublicationTypes`	No	An array of publication types to filter by (e.g., ["Review", "Clinical Trial"]). The server maps these to the appropriate Entrez query syntax (e.g., "Review"[Publication Type]).
`maxResults`	No	Maximum number of articles to retrieve. Corresponds to ESearch's 'retmax' parameter. Default is 20, max is 1000.
`queryTerm`	Yes	The primary keyword or phrase to search for in PubMed. Must be at least 3 characters long.
`sortBy`	No	Sorting criteria for results. Options: 'relevance' (default), 'pub_date', 'author', 'journal_name'. Note: Other sorting (e.g., last_author, title) may require client-side implementation or be future server enhancements.	relevance

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "dateRange": {
      "additionalProperties": false,
      "description": "Defines an optional date range for the search, including min/max dates and the type of date field to use.",
      "properties": {
        "dateType": {
          "default": "pdat",
          "description": "The type of date to filter by: 'pdat' (Publication Date), 'mdat' (Modification Date), 'edat' (Entrez Date). Default is 'pdat'.",
          "enum": [
            "pdat",
            "mdat",
            "edat"
          ],
          "type": "string"
        },
        "maxDate": {
          "description": "The end date for the search range (YYYY, YYYY/MM, or YYYY/MM/DD).",
          "pattern": "^\\d{4}(\\/\\d{2}(\\/\\d{2})?)?$",
          "type": "string"
        },
        "minDate": {
          "description": "The start date for the search range (YYYY, YYYY/MM, or YYYY/MM/DD).",
          "pattern": "^\\d{4}(\\/\\d{2}(\\/\\d{2})?)?$",
          "type": "string"
        }
      },
      "type": "object"
    },
    "fetchBriefSummaries": {
      "default": 0,
      "description": "Number of top PMIDs for which to fetch brief summaries using ESummary v2.0. Set to 0 to disable. Maximum is 50 for this tool. Default is 0.",
      "maximum": 50,
      "minimum": 0,
      "type": "integer"
    },
    "filterByPublicationTypes": {
      "description": "An array of publication types to filter by (e.g., [\"Review\", \"Clinical Trial\"]). The server maps these to the appropriate Entrez query syntax (e.g., \"Review\"[Publication Type]).",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "maxResults": {
      "default": 20,
      "description": "Maximum number of articles to retrieve. Corresponds to ESearch's 'retmax' parameter. Default is 20, max is 1000.",
      "exclusiveMinimum": 0,
      "maximum": 1000,
      "type": "integer"
    },
    "queryTerm": {
      "description": "The primary keyword or phrase to search for in PubMed. Must be at least 3 characters long.",
      "minLength": 3,
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "description": "Sorting criteria for results. Options: 'relevance' (default), 'pub_date', 'author', 'journal_name'. Note: Other sorting (e.g., last_author, title) may require client-side implementation or be future server enhancements.",
      "enum": [
        "relevance",
        "pub_date",
        "author",
        "journal_name"
      ],
      "type": "string"
    }
  },
  "required": [
    "queryTerm"
  ],
  "type": "object"
}

PubMed MCP Server