{"openapi":"3.0.3","info":{"title":"Gnist Context — PubMed","description":"Biomedical literature search — PubMed abstracts, citations, and MeSH term lookup. For clinical trials use the clinicaltrials server.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/pubmed/`\n- **Toolkit page:** `/toolkits/pubmed`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/pubmed/search_pubmed":{"post":{"tags":["Science"],"summary":"search_pubmed","description":"Search PubMed for biomedical literature.\n\nSearches 35M+ abstracts across all biomedical and life science fields.\nReturns title, authors, journal, publication date, and DOI.\n\nArgs:\n    query: Search query. Supports PubMed syntax (e.g., \"diabetes[MeSH] AND insulin\",\n           \"COVID-19 vaccine efficacy\"). Plain keywords also work.\n    max_results: Number of results to return (1–100, default 10).\n    date_from: Filter by publication date start (YYYY/MM/DD or YYYY).\n    date_to: Filter by publication date end (YYYY/MM/DD or YYYY).\n\nReturns:\n    List of articles with pmid, title, authors, journal, pub_date, and doi.\n    Note: Abstracts are not included in search results — use get_article for full text.","operationId":"pubmed_search_pubmed","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search query. Supports PubMed syntax (e.g., \"diabetes[MeSH] AND insulin\", \"COVID-19 vaccine efficacy\"). Plain keywords also work.","type":"string"},"max_results":{"default":10,"description":"Number of results to return (1–100, default 10).","type":"integer"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by publication date start (YYYY/MM/DD or YYYY)."},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by publication date end (YYYY/MM/DD or YYYY)."}},"required":["query"],"type":"object"}}}}}},"/rest/pubmed/get_article":{"post":{"tags":["Science"],"summary":"get_article","description":"Fetch full metadata and abstract for a PubMed article.\n\nArgs:\n    pmid: PubMed ID (e.g., \"33972843\"). Found in search_pubmed results.\n\nReturns:\n    Full article record including title, authors, abstract, journal, pub_date, and doi.","operationId":"pubmed_get_article","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"pmid":{"description":"PubMed ID (e.g., \"33972843\"). Found in search_pubmed results.","type":"string"}},"required":["pmid"],"type":"object"}}}}}},"/rest/pubmed/mesh_lookup":{"post":{"tags":["Science"],"summary":"mesh_lookup","description":"Look up a MeSH (Medical Subject Headings) term.\n\nMeSH is the NLM's controlled vocabulary for indexing biomedical literature.\nUse this to find canonical term names, definitions, and related terms.\n\nArgs:\n    term: The medical term to look up (e.g., \"Diabetes Mellitus\", \"Hypertension\").\n\nReturns:\n    MeSH entry with canonical name, scope note (definition), tree numbers,\n    and synonyms. Returns empty result if term not found.","operationId":"pubmed_mesh_lookup","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"term":{"description":"The medical term to look up (e.g., \"Diabetes Mellitus\", \"Hypertension\").","type":"string"}},"required":["term"],"type":"object"}}}}}},"/rest/pubmed/search_trials":{"post":{"tags":["Science"],"summary":"search_trials","description":"Search ClinicalTrials.gov for clinical trials by condition.\n\nReturns trial summaries including NCT ID, title, status, phase, conditions,\ninterventions, and sponsor.\n\nArgs:\n    condition: Medical condition to search for.\n    status: Trial status filter.\n    phase: Trial phase filter.\n    country: Country filter.\n    max_results: Number of results (1–50, default 10).\n\nReturns:\n    List of trial summaries.","operationId":"pubmed_search_trials","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"condition":{"description":"Medical condition to search for (e.g., \"COVID-19\", \"Type 2 Diabetes\").","type":"string"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Trial status filter (e.g., RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING)."},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Trial phase filter (e.g., PHASE1, PHASE2, PHASE3, PHASE4)."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country filter (e.g., United States, Norway)."},"max_results":{"default":10,"description":"Number of results to return (1–50, default 10).","type":"integer"}},"required":["condition"],"type":"object"}}}}}},"/rest/pubmed/get_trial":{"post":{"tags":["Science"],"summary":"get_trial","description":"Fetch detailed information about a specific clinical trial.\n\nArgs:\n    nct_id: ClinicalTrials.gov NCT ID.\n\nReturns:\n    Full trial record including eligibility criteria and locations.","operationId":"pubmed_get_trial","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"nct_id":{"description":"ClinicalTrials.gov NCT ID (e.g., \"NCT04470427\").","type":"string"}},"required":["nct_id"],"type":"object"}}}}}},"/rest/pubmed/report_feedback":{"post":{"tags":["Science"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"pubmed_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Science","description":"Data sources: Science"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}