{"openapi":"3.0.3","info":{"title":"Gnist Context — arXiv","description":"Search and retrieve academic preprints across physics, math, CS, and more.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/arxiv/`\n- **Toolkit page:** `/toolkits/arxiv`\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/arxiv/search_arxiv_papers":{"post":{"tags":["Science"],"summary":"search_arxiv_papers","description":"Search scientific papers on arXiv by keyword, category, and date range.\n\nArgs:\n    query: Search terms (e.g. \"attention mechanism transformer\", \"CRISPR gene editing\").\n           Searches across title, abstract, and author fields.\n    category: arXiv subject category code (e.g. \"cs.AI\", \"q-fin.TR\"). Optional.\n    date_from: Only return papers submitted from this date onward (YYYY-MM-DD). Optional.\n    date_to: Only return papers submitted up to this date (YYYY-MM-DD). Optional.\n    max_results: Number of results to return (1–25, default 10).\n\nReturns:\n    Dictionary with 'count' and 'papers' list. Each paper has arxiv_id, title,\n    authors, abstract, categories, primary_category, published, updated, pdf_url, doi.","operationId":"arxiv_search_arxiv_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. \"attention mechanism transformer\", \"CRISPR gene editing\"). Searches across title, abstract, and author fields.","type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"arXiv subject category code (e.g. \"cs.AI\", \"q-fin.TR\"). Optional."},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only return papers submitted from this date onward (YYYY-MM-DD). Optional."},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only return papers submitted up to this date (YYYY-MM-DD). Optional."},"max_results":{"default":10,"description":"Number of results to return (1–25, default 10).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/arxiv/get_arxiv_paper":{"post":{"tags":["Science"],"summary":"get_arxiv_paper","description":"Get full details for a specific arXiv paper by ID.\n\nArgs:\n    arxiv_id: arXiv ID (e.g. \"2106.09685\", \"2106.09685v1\", or\n              \"http://arxiv.org/abs/2106.09685\").\n\nReturns:\n    Full paper record: arxiv_id, title, authors, abstract, categories,\n    primary_category, published, updated, pdf_url, doi.","operationId":"arxiv_get_arxiv_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":{"arxiv_id":{"description":"arXiv ID (e.g. \"2106.09685\", \"2106.09685v1\", or \"http://arxiv.org/abs/2106.09685\").","type":"string"}},"required":["arxiv_id"],"type":"object"}}}}}},"/rest/arxiv/get_arxiv_author_papers":{"post":{"tags":["Science"],"summary":"get_arxiv_author_papers","description":"Search papers by a specific arXiv author, sorted by submission date (newest first).\n\nArgs:\n    author_name: Author's name as it appears on arXiv (e.g. \"Yann LeCun\", \"Hinton\").\n                 Partial last names work; full names improve precision.\n    max_results: Number of results to return (1–25, default 10).\n\nReturns:\n    Dictionary with 'count' and 'papers' list.","operationId":"arxiv_get_arxiv_author_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":{"author_name":{"description":"Author's name as it appears on arXiv (e.g. \"Yann LeCun\", \"Hinton\"). Partial last names work; full names improve precision.","type":"string"},"max_results":{"default":10,"description":"Number of results to return (1–25, default 10).","type":"integer"}},"required":["author_name"],"type":"object"}}}}}},"/rest/arxiv/get_arxiv_recent":{"post":{"tags":["Science"],"summary":"get_arxiv_recent","description":"Get the most recently submitted papers in an arXiv subject category.\n\nArgs:\n    category: arXiv category code (e.g. \"cs.LG\", \"q-fin.TR\").\n              Use list_arxiv_categories() to see all supported codes.\n    max_results: Number of results to return (1–25, default 10).\n\nReturns:\n    Dictionary with 'count' and 'papers' list.","operationId":"arxiv_get_arxiv_recent","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":{"category":{"description":"arXiv category code (e.g. \"cs.LG\", \"q-fin.TR\"). Use list_arxiv_categories() to see all supported codes.","type":"string"},"max_results":{"default":10,"description":"Number of results to return (1–25, default 10).","type":"integer"}},"required":["category"],"type":"object"}}}}}},"/rest/arxiv/list_arxiv_categories":{"post":{"tags":["Science"],"summary":"list_arxiv_categories","description":"Return all supported arXiv subject categories with descriptions.\n\nReturns:\n    Dict mapping category code (e.g. \"cs.AI\") to description.\n    Use these codes in search_arxiv_papers(category=...) and get_arxiv_recent(category=...).","operationId":"arxiv_list_arxiv_categories","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/arxiv/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":"arxiv_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."}}}}