pubmed_search_articles

Search PubMed for biomedical articles using keywords, filters, and customizable parameters like date range, publication types, and sorting. Retrieve article IDs, counts, and optional 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, and E-utility URLs.

Input Schema

Name	Required	Description	Default
`dateRange`	No	Defines an optional date range for the search.
`fetchBriefSummaries`	No	Number of top PMIDs for which to fetch brief summaries using ESummary. Set to 0 to disable. Max 50. Default 0.
`filterByPublicationTypes`	No	An array of publication types to filter by (e.g., ["Review", "Clinical Trial"]).
`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'.	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.",
      "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. Set to 0 to disable. Max 50. Default 0.",
      "maximum": 50,
      "minimum": 0,
      "type": "integer"
    },
    "filterByPublicationTypes": {
      "description": "An array of publication types to filter by (e.g., [\"Review\", \"Clinical Trial\"]).",
      "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'.",
      "enum": [
        "relevance",
        "pub_date",
        "author",
        "journal_name"
      ],
      "type": "string"
    }
  },
  "required": [
    "queryTerm"
  ],
  "type": "object"
}

PubMed MCP Server