Find research papers
search_papersSearch Blossom's papers (peer-reviewed studies, meta-analyses, reviews). For a known DOI, pass the standalone DOI or doi.org URL in query for exact lookup; a miss stays empty and all other filters still apply. searchMatch shows lexical matching fields, not verified relevance: when titleOrSummaryMatch is false, the match is in supporting context and may be incidental or about another jurisdiction. Read that context, distinguish direct evidence from background comparisons, and do not treat acronym matches as proof of a named programme. Use linkedTrialRegistrationNumbers with exact ClinicalTrials.gov IDs to follow curated relatedTrials links from trials to papers. Registry-ID lookup reserves at least one bounded result slot per requested ID, returns matchedTrialRegistrationNumbers on each paper, and prioritizes papers structurally labelled primary (verified labels first), so an ID absent from matchedTrialRegistrationNumbers across the returned results has complete no-link coverage when no other paper filters were passed. paperRole is authoritative only when paperRoleVerified is true; otherwise report the label as unverified. Use accessTypes with canonical values 'open' or 'paywall' for access-status questions. Use orderBy:'relevantInfluential' only after the user confirms a subject axis for influential-literature discovery: it restricts results to the primary title-or-summary subject cohort, then ranks that cohort by citation count. Never use it to imply that a paper is verified as related to an unresolved citation. Set retrievalMode:'hybrid' only for natural-language discovery questions, lexical for names and exact identifiers. Hybrid candidates carry retrievalMatch ranks, which are not verified relevance or an exhaustive count. When retrievalMatch is absent, these are lexical-only results, including when hybrid is disabled or unavailable; do not describe them as found by meaning. Use to LIST papers matching filters. For 'how many?' questions use count_papers instead.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_papers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| dateTo | No | ||
| topics | No | Topic slugs (e.g. "depressive-disorders", "ocd"). Common abbreviations like "PTSD", "TRD", "OCD" and short names like "depression", "anxiety" are auto-mapped to canonical slugs. | |
| orderBy | No | Sort order. "relevance" = best text match (default), "date" = newest first; use date for "latest"/"recent"/"new" questions. "citations" = most-cited first. "relevantInfluential" = citation-ranked papers that first qualify by the primary title-or-summary subject pattern; use only after the user confirms a subject axis for influential-literature discovery. | relevance |
| dateFrom | No | ||
| compounds | No | Compound slugs (e.g. "psilocybin", "mdma"). Street names ("shrooms", "ecstasy") and brand/program names ("COMP360", "MM-120") are auto-mapped. | |
| accessTypes | No | Canonical paper access status. Use ["open"] for open-access papers or ["paywall"] for paywalled / subscription-only papers. | |
| authorSlugs | No | ||
| journalSlug | No | ||
| studyDesign | No | "meta" = meta-analyses/reviews; "individual" = primary studies | |
| retrievalMode | No | Use hybrid only for natural-language discovery questions; lexical for names, identifiers, exact titles and counts. Hybrid is bounded candidate retrieval, not proof of relevance or exhaustive coverage. | |
| linkedTrialSlugs | No | Slugs of trials this paper is linked to (relatedTrials[]). Use to find papers from a specific trial. | |
| outcomeMeasureSlugs | No | Slugs of clinical / mental-health rating scales used as outcome measures (e.g. "beck-depression-inventory", "madrs", "y-bocs"). Common abbreviations like "BDI", "MADRS", "PHQ-9", "GAD-7", "Y-BOCS", "PCL-5", "MEQ-30" are auto-mapped. | |
| linkedTrialRegistrationNumbers | No | Exact ClinicalTrials.gov IDs of trials linked through curated relatedTrials references (for example NCT03537014). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |