{"openapi":"3.0.3","info":{"title":"Gnist Context — OpenAlex","description":"Open scholarly metadata — works, authors, institutions, and citation networks.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/openalex/`\n- **Toolkit page:** `/toolkits/openalex`\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/openalex/search_papers":{"post":{"tags":["Science"],"summary":"search_papers","description":"Search scholarly papers by keyword across 250M+ works from OpenAlex.\n\nArgs:\n    query: Search terms (e.g. \"transformer attention mechanisms\", \"CRISPR gene editing\").\n    year_from: Filter to papers published from this year onward (e.g. 2020). Optional.\n    year_to: Filter to papers published up to this year (e.g. 2024). Optional.\n    field_of_study: Filter by research field (e.g. \"machine learning\", \"biology\"). Optional.\n    max_results: Number of results to return (1–25, default 10).\n\nReturns:\n    Dictionary with count and papers list (id, doi, title, year, venue, cited_by_count,\n    open_access flag, authors up to 5, top 5 concepts).","operationId":"openalex_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 terms (e.g. \"transformer attention mechanisms\", \"CRISPR gene editing\").","type":"string"},"year_from":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter to papers published from this year onward (e.g. 2020). Optional."},"year_to":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter to papers published up to this year (e.g. 2024). Optional."},"field_of_study":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by research field (e.g. \"machine learning\", \"biology\"). Optional."},"max_results":{"default":10,"description":"Number of results to return (1–25, default 10).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/openalex/get_paper":{"post":{"tags":["Science"],"summary":"get_paper","description":"Get full details for a specific paper including abstract and citation count.\n\nArgs:\n    paper_id: OpenAlex ID (e.g. \"W2741809807\"), DOI (e.g. \"10.1038/s41586-021-03819-2\"),\n              or full URL (e.g. \"https://openalex.org/W2741809807\").\n\nReturns:\n    Full paper record: id, doi, title, publication_year, venue, abstract,\n    authors, concepts, cited_by_count, references_count, open_access.","operationId":"openalex_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":"OpenAlex ID (e.g. \"W2741809807\"), DOI (e.g. \"10.1038/s41586-021-03819-2\"), or full URL (e.g. \"https://openalex.org/W2741809807\").","type":"string"}},"required":["paper_id"],"type":"object"}}}}}},"/rest/openalex/get_author_profile":{"post":{"tags":["Science"],"summary":"get_author_profile","description":"Get a researcher's profile — works, citations, h-index, and affiliations.\n\nArgs:\n    author_id: OpenAlex author ID (e.g. \"A5023888391\"), ORCID (e.g. \"0000-0001-6187-6610\"),\n               or full ORCID URL.\n\nReturns:\n    Author profile: id, display_name, orcid, works_count, cited_by_count,\n    h_index, and affiliations (up to 3 recent institutions).","operationId":"openalex_get_author_profile","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":"OpenAlex author ID (e.g. \"A5023888391\"), ORCID (e.g. \"0000-0001-6187-6610\"), or full ORCID URL.","type":"string"}},"required":["author_id"],"type":"object"}}}}}},"/rest/openalex/list_citations":{"post":{"tags":["Science"],"summary":"list_citations","description":"List papers that cite or are referenced by a given paper.\n\nArgs:\n    paper_id: OpenAlex ID, DOI, or full URL of the paper.\n    direction: \"cited_by\" for papers that cite this one (default),\n               or \"references\" for papers this paper cites.\n    max_results: Number of results to return (1–25, default 20).\n\nReturns:\n    Dictionary with count and papers list (id, doi, title, year, cited_by_count, authors).","operationId":"openalex_list_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":"OpenAlex ID, DOI, or full URL of the paper.","type":"string"},"direction":{"default":"cited_by","description":"\"cited_by\" for papers that cite this one (default), or \"references\" for papers this paper cites.","type":"string"},"max_results":{"default":20,"description":"Number of results to return (1–25, default 20).","type":"integer"}},"required":["paper_id"],"type":"object"}}}}}},"/rest/openalex/get_trending_papers":{"post":{"tags":["Science"],"summary":"get_trending_papers","description":"Get recently published high-impact papers in a research field.\n\nArgs:\n    field: Research field to search (e.g. \"machine learning\", \"immunology\", \"climate change\").\n    days: Look back this many days for recent papers (default 30).\n    max_results: Number of results to return (1–25, default 10).\n\nReturns:\n    Dictionary with count and recent papers ranked by citation count.","operationId":"openalex_get_trending_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":{"field":{"description":"Research field to search (e.g. \"machine learning\", \"immunology\", \"climate change\").","type":"string"},"days":{"default":30,"description":"Look back this many days for recent papers (default 30).","type":"integer"},"max_results":{"default":10,"description":"Number of results to return (1–25, default 10).","type":"integer"}},"required":["field"],"type":"object"}}}}}},"/rest/openalex/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":"openalex_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."}}}}