{"openapi":"3.0.3","info":{"title":"Gnist Context — Semantic Scholar","description":"Search 200M+ academic papers, explore citation graphs, find author profiles, and get AI-powered paper recommendations across all scientific disciplines.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/semantic-scholar/`\n- **Toolkit page:** `/toolkits/semantic-scholar`\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/semantic-scholar/search_papers":{"post":{"tags":["Science"],"summary":"search_papers","description":"Search 200M+ academic papers in Semantic Scholar.\n\nFind papers across all scientific disciplines. Returns titles, authors,\ncitation counts, venues, and links to open-access PDFs when available.\nUse paper IDs from results with get_paper, get_citations, get_references,\nand recommend_papers.\n\nArgs:\n    query: Search keywords or phrase.\n    limit: Number of results (1-100, default 10).\n    offset: Pagination offset for paging through results.\n    year: Year or year range filter.\n    fields_of_study: Filter by academic field(s).\n\nReturns:\n    Papers with paperId, title, year, venue, authors, citationCount, doi.","operationId":"semantic_scholar_search_papers","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 for academic papers (e.g. \"transformer attention mechanism\", \"CRISPR gene editing\", \"climate change mitigation\").","type":"string"},"limit":{"default":10,"description":"Number of results to return (1-100, default 10).","type":"integer"},"offset":{"default":0,"description":"Pagination offset for additional results (default 0).","type":"integer"},"year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Year filter — single year (\"2023\"), range (\"2020-2023\"), or open range (\"2020-\")."},"fields_of_study":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Filter by academic field (e.g. [\"Computer Science\"], [\"Medicine\", \"Biology\"])."}},"required":["query"],"type":"object"}}}}}},"/rest/semantic-scholar/get_paper":{"post":{"tags":["Science"],"summary":"get_paper","description":"Get detailed information about a specific academic paper.\n\nRetrieve full paper details including abstract, citation/reference counts,\nauthors, fields of study, and AI-generated TLDR summary. Accepts multiple\nID formats: Semantic Scholar paper ID, DOI, ArXiv ID, PMID, or CorpusId.\n\nArgs:\n    paper_id: Paper identifier in any supported format.\n\nReturns:\n    Full paper details with abstract, authors, citations, TLDR, and links.","operationId":"semantic_scholar_get_paper","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":{"paper_id":{"description":"Paper identifier — S2 ID (40-char hex), DOI (e.g. \"10.1038/s41586-021-03819-2\"), ArXiv ID (e.g. \"2301.12345\"), or prefixed ID (e.g. \"PMID:12345\", \"CorpusId:12345\").","type":"string"}},"required":["paper_id"],"type":"object"}}}}}},"/rest/semantic-scholar/get_citations":{"post":{"tags":["Science"],"summary":"get_citations","description":"Get papers that cite a given paper.\n\nExplore a paper's citation graph by finding all papers that reference it.\nUseful for tracking research impact, finding follow-up work, and\ndiscovering how a paper has influenced subsequent research.\n\nArgs:\n    paper_id: Paper identifier in any supported format.\n    limit: Number of citing papers to return (1-100, default 20).\n    offset: Pagination offset.\n\nReturns:\n    List of citing papers with title, year, venue, authors, citationCount.","operationId":"semantic_scholar_get_citations","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":{"paper_id":{"description":"Paper identifier (S2 ID, DOI, ArXiv ID, or prefixed ID).","type":"string"},"limit":{"default":20,"description":"Number of citing papers to return (1-100, default 20).","type":"integer"},"offset":{"default":0,"description":"Pagination offset (default 0).","type":"integer"}},"required":["paper_id"],"type":"object"}}}}}},"/rest/semantic-scholar/get_references":{"post":{"tags":["Science"],"summary":"get_references","description":"Get papers referenced by a given paper.\n\nExplore a paper's bibliography — the works it cites. Useful for\nunderstanding a paper's foundations, finding seminal works in a field,\nand building reading lists from authoritative sources.\n\nArgs:\n    paper_id: Paper identifier in any supported format.\n    limit: Number of referenced papers to return (1-100, default 20).\n    offset: Pagination offset.\n\nReturns:\n    List of referenced papers with title, year, venue, authors, citationCount.","operationId":"semantic_scholar_get_references","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":{"paper_id":{"description":"Paper identifier (S2 ID, DOI, ArXiv ID, or prefixed ID).","type":"string"},"limit":{"default":20,"description":"Number of referenced papers to return (1-100, default 20).","type":"integer"},"offset":{"default":0,"description":"Pagination offset (default 0).","type":"integer"}},"required":["paper_id"],"type":"object"}}}}}},"/rest/semantic-scholar/search_authors":{"post":{"tags":["Science"],"summary":"search_authors","description":"Search for academic authors by name.\n\nFind researchers by name and see their publication counts, citation counts,\nh-index, and institutional affiliations. Use authorId from results with\nget_author for detailed profiles.\n\nArgs:\n    query: Author name to search for.\n    limit: Number of results (1-100, default 10).\n\nReturns:\n    Authors with authorId, name, paperCount, citationCount, hIndex, affiliations.","operationId":"semantic_scholar_search_authors","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":"Author name to search for (e.g. \"Yann LeCun\", \"Geoffrey Hinton\").","type":"string"},"limit":{"default":10,"description":"Number of results to return (1-100, default 10).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/semantic-scholar/get_author":{"post":{"tags":["Science"],"summary":"get_author","description":"Get an author's profile by Semantic Scholar author ID.\n\nRetrieve detailed author information including paper count, citation count,\nh-index, and affiliations.\n\nArgs:\n    author_id: Numeric S2 author ID from search_authors results.\n\nReturns:\n    Author profile with name, paperCount, citationCount, hIndex, affiliations.","operationId":"semantic_scholar_get_author","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":{"author_id":{"description":"Semantic Scholar author ID (numeric, e.g. \"1688882\").","type":"string"}},"required":["author_id"],"type":"object"}}}}}},"/rest/semantic-scholar/recommend_papers":{"post":{"tags":["Science"],"summary":"recommend_papers","description":"Get paper recommendations based on a seed paper.\n\nUses Semantic Scholar's recommendation engine to find related papers\nyou might want to read next. Useful for literature review, discovering\nadjacent research, and expanding knowledge in a topic area.\n\nArgs:\n    paper_id: Paper to get recommendations for.\n    limit: Number of recommendations (1-100, default 10).\n\nReturns:\n    Recommended papers similar to the seed paper.","operationId":"semantic_scholar_recommend_papers","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":{"paper_id":{"description":"Paper identifier (S2 ID, DOI, ArXiv ID, or prefixed ID) to get recommendations for.","type":"string"},"limit":{"default":10,"description":"Number of recommendations (1-100, default 10).","type":"integer"}},"required":["paper_id"],"type":"object"}}}}}},"/rest/semantic-scholar/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":"semantic_scholar_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."}}}}