{"openapi":"3.0.3","info":{"title":"Gnist Context — Academic Research","description":"Unified academic paper search across Crossref, OpenAlex, PubMed, and Semantic Scholar — deduplicated by DOI with merged metadata.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/academic-research/`\n- **Toolkit page:** `/toolkits/academic-research`\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/academic-research/search_papers":{"post":{"tags":["Science"],"summary":"search_papers","description":"Search for academic papers across Crossref, OpenAlex, PubMed, and Semantic Scholar.\n\nResults are deduplicated by DOI and enriched with metadata from all sources\nthat found a match. Sorted by citation count (most cited first).\n\nExamples:\n    search_papers(query=\"transformer attention mechanism\")\n    search_papers(query=\"CRISPR gene editing\", year_from=2020, max_results=20)\n    search_papers(query=\"climate change economic impact\", year_from=2018, year_to=2024)","operationId":"academic_research_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 — keywords, title, topic, or author name.","type":"string"},"max_results":{"default":10,"description":"Maximum number of results.","type":"integer"},"year_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Earliest publication year."},"year_to":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Latest publication year."}},"required":["query"],"type":"object"}}}}}},"/rest/academic-research/get_paper":{"post":{"tags":["Science"],"summary":"get_paper","description":"Resolve a DOI across all four academic sources and return merged metadata.\n\nQueries Crossref, OpenAlex, PubMed, and Semantic Scholar in parallel,\nthen merges the results into a single enriched paper object with the\nbest available data from each source.\n\nExamples:\n    get_paper(doi=\"10.1038/nature12373\")\n    get_paper(doi=\"10.1126/science.aax2342\")","operationId":"academic_research_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":{"doi":{"description":"Digital Object Identifier (e.g. '10.1038/nature12373').","type":"string"}},"required":["doi"],"type":"object"}}}}}},"/rest/academic-research/list_academic_sources":{"post":{"tags":["Science"],"summary":"list_academic_sources","description":"List all registered academic data sources and their status.\n\nShows which sources are available and whether they are currently enabled.\n\nExamples:\n    list_academic_sources()","operationId":"academic_research_list_academic_sources","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":[]}]}},"/rest/academic-research/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":"academic_research_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."}}}}