Pubmed Search Articles
pubmed_search_articlesRead-only
Search PubMed using full query syntax with filters for date range, author, journal, MeSH terms, language, species, and free full text. Returns PMIDs with optional summaries, supporting pagination.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | PubMed search query (supports full NCBI syntax) | |
| maxResults | No | Maximum results to return | |
| offset | No | Result offset for pagination (0-based) | |
| sort | No | Sort order: relevance (default), pub_date (newest first), author, or journal | relevance |
| dateRange | No | 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. | |
| publicationTypes | No | Filter by publication type (e.g. "Review", "Clinical Trial", "Meta-Analysis"). Multiple values are OR'd — any match qualifies. | |
| author | No | Filter by author name (e.g. "Smith J") | |
| journal | No | Filter by journal name | |
| meshTerms | No | Filter by MeSH terms. Multiple terms are AND'd — all must match. | |
| language | No | Filter by language (e.g. "english") | |
| hasAbstract | No | Only include articles with abstracts | |
| freeFullText | No | Only include free full text articles | |
| species | No | Filter by species | |
| summaryCount | No | Fetch brief summaries for top N results (0 = PMIDs only) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Original query | |
| offset | Yes | Result offset used | |
| pmids | Yes | PubMed IDs | |
| summaries | Yes | Brief summaries (empty array when summaryCount is 0) | |
| searchUrl | Yes | PubMed search URL | |
| effectiveQuery | Yes | Sanitized query sent to PubMed after applying all active filters | |
| totalFound | Yes | Total matching articles | |
| appliedFilters | Yes | Normalized filter values that were applied to the PubMed query | |
| notice | No | Optional guidance when results are empty or paging overshot — e.g. how to broaden filters or reset offset. Absent on successful result pages. |