arxiv-mcp-server
An MCP server that allows agents to search arXiv papers using complex queries, fetch structured metadata by ID, list categories, and read full paper text via HTML or PDF fallback. It supports both STDIO and Streamable HTTP transports.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://arxiv.caseyjhand.com/mcpWhat its tools do
4 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search arXiv papers by query with category and sort filters
- Fetch metadata for one or more papers by arXiv ID
- Read full paper text via HTML, ar5iv, or PDF-extracted fallback
- List the arXiv category taxonomy, optionally filtered by group
Source and maintenance
Community listingRegistry 1.8.1
- Maintenance checked
Protocol and capabilities
- Server
- arxiv-mcp-server 1.8.1
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 4 advertised
- Resources
- 2 advertised
- Resource templates
- 2 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
4 advertised
arxiv_search_papers — Arxiv Search Papers
Advertised read-only
Search arXiv papers by query with category and sort filters. Returns paper metadata including title, authors, abstract, categories, and links.
arxiv_search_papers input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"pattern": "^[^\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F]*$",
"maxLength": 1000,
"minLength": 1,
"description": "Search query. Field prefixes: ti: (title), au: (author — search the surname and narrow a common one with a category or topic: au:hinton AND cat:cs.LG; a quoted name such as au:\"geoffrey hinton\" matches when one author's name holds every quoted word, in any order, and an initial does not match a spelled-out first name), abs: (abstract), cat: (category — a leaf code matches exactly, a bare archive code such as cat:astro-ph matches its whole subtree), co: (comment), jr: (journal ref), all: (all fields). Boolean operators, uppercase only: AND, OR, ANDNOT. Space-separated terms are joined with OR, so \"quantum computing\" matches papers with either word; AND requires every term (\"quantum AND computing\"). The operators share one precedence and group to the right (\"a AND b OR c\" reads as \"a AND (b OR c)\"), so use parentheses for any other grouping. Quote a multi-word topic to match it as a phrase, and put alternatives in parentheses before a filter so the filter applies to all of them: '\"graph neural networks\" AND cat:cs.LG', '(ti:transformer OR ti:attention) AND cat:cs.CL'. arXiv ignores common words such as of, the, and, for, in, so leave them out or keep them inside a quoted phrase. Examples: \"au:bengio AND ti:attention\", \"all:transformer AND cat:cs.CL\"."
},
"start": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0,
"description": "Pagination offset (0-10000). Use with max_results to page through results. E.g., start=10 with max_results=10 returns results 11-20. arXiv serves only the first 10000 results of a query, so a page reaching past result 10000 can come back cut short at it and a start of 10000 can be refused. To reach later matches, carve the search into submitted_from/submitted_to windows and page within each."
},
"sort_by": {
"enum": [
"relevance",
"submitted",
"updated"
],
"type": "string",
"default": "relevance",
"description": "Sort criterion. Use \"submitted\" for newest papers, \"relevance\" for best query matches."
},
"category": {
"type": "string",
"description": "Restrict results to an arXiv category. A leaf code (\"cs.CL\", \"math.AG\") matches exactly. A bare archive code (\"astro-ph\", \"cond-mat\", \"cs\", \"math\") matches the whole archive — its subject classes plus the legacy flat papers filed before the archive was subdivided. Note \"physics\" is the general-physics archive (physics.*), not the wider physics group: astro-ph, cond-mat, hep-*, quant-ph and the rest are separate archive codes. Use arxiv_list_categories to discover subject classes."
},
"sort_order": {
"enum": [
"ascending",
"descending"
],
"type": "string",
"default": "descending",
"description": "Sort direction. \"descending\" returns newest/most relevant first."
},
"max_results": {
"type": "integer",
"default": 10,
"maximum": 10000,
"minimum": 1,
"description": "Maximum results to return. Default 10. At most 50 are returned per call: a larger value returns the first 50, and when more matches exist the response says how to reach them — the start of the next page, or date windows once paging cannot reach them all. arXiv serves only the first 10000 results of a query, so a page reaching past result 10000 can come back cut short at it, and the response says so. Each result includes title, authors, abstract, and metadata — keep low to limit response size."
},
"submitted_to": {
"type": "string",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
"description": "Latest submission date to include, inclusive, as a UTC YYYY-MM-DD date. Omit for no upper bound. Both bounds are inclusive, so consecutive windows (\"2024-01-01\"..\"2024-01-15\" then \"2024-01-16\"..\"2024-01-31\") cover the matches with no gap; a paper submitted at exactly the midnight seam between two windows appears in both, so de-duplicate collected results by paper id. That is the way to reach matches past the start ceiling: split the date range, then page within each window."
},
"submitted_from": {
"type": "string",
"pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
"description": "Earliest submission date to include, inclusive, as a UTC YYYY-MM-DD date. Omit for no lower bound."
}
},
"additionalProperties": false
}arxiv_search_papers output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"papers",
"effectiveQuery",
"totalFound",
"pageStart"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The page size applied: max_results, or 50 when max_results asks for more — fewer when the page was cut short at result 10000, the last one arXiv serves."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_category",
"rate_limited",
"invalid_request",
"unsupported_query_syntax",
"invalid_date_range",
"start_beyond_result_limit"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_category`: Provided category code is not part of the arXiv taxonomy. `rate_limited`: arXiv has throttled requests (HTTP 429 or \"Rate exceeded.\" body). `invalid_request`: arXiv rejected the request (HTTP 4xx other than 429), typically malformed query syntax. `unsupported_query_syntax`: The mirror search engine rejected the FTS5 expression the query translated to. Every query the translator accepts is meant to parse, so this marks a translator defect. `invalid_date_range`: submitted_from or submitted_to is not a real UTC calendar date, or the window starts after it ends. `start_beyond_result_limit`: start is 10000 or more on a search arXiv answers, past the first 10000 results it serves for any query. Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Papers returned on this page."
},
"notice": {
"type": "string",
"description": "Recovery guidance when results are empty or paging overshot. Absent on successful pages."
},
"papers": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"authors",
"abstract",
"primary_category",
"categories",
"published",
"updated",
"pdf_url",
"abstract_url"
],
"properties": {
"id": {
"type": "string",
"description": "arXiv paper ID (e.g., \"2401.12345v1\")."
},
"doi": {
"type": "string",
"description": "DOI if available."
},
"title": {
"type": "string",
"description": "Paper title."
},
"authors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Author names."
},
"comment": {
"type": "string",
"description": "Author comment (e.g., page count, conference)."
},
"pdf_url": {
"type": "string",
"description": "Direct PDF download URL."
},
"updated": {
"type": "string",
"description": "Last update instant, ISO 8601 UTC (e.g., \"2018-10-11T00:50:01Z\")."
},
"abstract": {
"type": "string",
"description": "Full abstract text."
},
"published": {
"type": "string",
"description": "Original submission instant, ISO 8601 UTC (e.g., \"2018-10-11T00:50:01Z\")."
},
"categories": {
"type": "array",
"items": {
"type": "string"
},
"description": "All arXiv categories assigned to this paper."
},
"journal_ref": {
"type": "string",
"description": "Journal reference if published."
},
"abstract_url": {
"type": "string",
"description": "arXiv abstract page URL."
},
"primary_category": {
"type": "string",
"description": "Primary arXiv category (e.g., \"cs.CL\")."
}
},
"description": "arXiv paper metadata — identifier, title, authors, abstract, categories, and links.",
"additionalProperties": false
},
"description": "Matching papers with full metadata."
},
"pageStart": {
"type": "number",
"description": "Pagination offset of this result page."
},
"truncated": {
"type": "boolean",
"description": "True when more matching papers exist beyond this page (totalFound > start + shown)."
},
"totalFound": {
"type": "number",
"description": "Total matching papers before pagination. Exact, except for a search the local mirror answers with no free-text term that spans several category codes (a whole archive such as cat:cs, or two categories) or filters by submitted date alone: the mirror stops counting such a search at 50,000, and a total of 50,000 there carries totalFoundIsLowerBound and means 50,000 or more."
},
"effectiveQuery": {
"type": "string",
"description": "The query as actually searched, carrying every filter applied — the category subtree and submitted-date window folded into arXiv syntax alongside the supplied terms. Replaying it as `query` with no other filters reproduces this exact result set."
},
"totalFoundIsLowerBound": {
"type": "boolean",
"const": true,
"description": "Present when totalFound is a floor: at least that many papers match. Absent when totalFound is exact."
}
},
"additionalProperties": false
}arxiv_search_papers annotations
{
"readOnlyHint": true
}arxiv_get_metadata — Arxiv Get Metadata
Advertised read-only
Get full metadata for one or more arXiv papers by ID. Use when you have known IDs from citations, prior search results, or memory. Looks up 10 IDs per call; any further IDs come back in remaining_ids for the next call.
arxiv_get_metadata input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"paper_ids"
],
"properties": {
"paper_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "arXiv paper IDs, up to 100. The first 10 distinct well-formed IDs are looked up; the rest come back in remaining_ids to pass to the next call. An ID repeated in any accepted spelling is looked up once, while different versions of one paper stay separate lookups. Accepted forms: \"2401.12345\", \"2401.12345v2\" (a pinned version), or a pre-2007 ID like \"hep-th/9901001\" (archive spelled as arXiv issued it), each optionally prefixed \"arXiv:\", or an arxiv.org abs, pdf, or html URL, with or without https:// or a ?query or #fragment. An ID in any other form is reported in not_found with reason invalid_id and is not looked up."
}
},
"additionalProperties": false
}arxiv_get_metadata output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"papers",
"totalSucceeded"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_id",
"no_match",
"version_unavailable",
"version_not_served",
"rate_limited",
"invalid_request"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_id`: None of the requested IDs is an arXiv identifier in an accepted form. `no_match`: None of the requested IDs returned data from arXiv. `version_unavailable`: Every requested ID pinned a version the local mirror does not hold, and live arXiv fallback is disabled. `version_not_served`: Every requested ID pinned a superseded version of a pre-2007 paper that arXiv's API answers HTTP 500 for. The version exists, but its metadata cannot be returned. `rate_limited`: arXiv has throttled requests (HTTP 429 or \"Rate exceeded.\" body). `invalid_request`: arXiv rejected the request (HTTP 4xx other than 429). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"papers": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"authors",
"abstract",
"primary_category",
"categories",
"published",
"updated",
"pdf_url",
"abstract_url"
],
"properties": {
"id": {
"type": "string",
"description": "arXiv paper ID (e.g., \"2401.12345v1\")."
},
"doi": {
"type": "string",
"description": "DOI if available."
},
"title": {
"type": "string",
"description": "Paper title."
},
"authors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Author names."
},
"comment": {
"type": "string",
"description": "Author comment (e.g., page count, conference)."
},
"pdf_url": {
"type": "string",
"description": "Direct PDF download URL."
},
"updated": {
"type": "string",
"description": "Last update instant, ISO 8601 UTC (e.g., \"2018-10-11T00:50:01Z\")."
},
"abstract": {
"type": "string",
"description": "Full abstract text."
},
"published": {
"type": "string",
"description": "Original submission instant, ISO 8601 UTC (e.g., \"2018-10-11T00:50:01Z\")."
},
"categories": {
"type": "array",
"items": {
"type": "string"
},
"description": "All arXiv categories assigned to this paper."
},
"journal_ref": {
"type": "string",
"description": "Journal reference if published."
},
"abstract_url": {
"type": "string",
"description": "arXiv abstract page URL."
},
"primary_category": {
"type": "string",
"description": "Primary arXiv category (e.g., \"cs.CL\")."
}
},
"description": "arXiv paper metadata — identifier, title, authors, abstract, categories, and links.",
"additionalProperties": false
},
"description": "Papers found, in request order, one per distinct ID. Fewer than requested when an ID repeats an earlier one, is malformed, absent from arXiv, a version arXiv will not serve, one whose live lookup failed behind the local mirror, or past the first 10 distinct well-formed IDs."
},
"not_found": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"reason"
],
"properties": {
"id": {
"type": "string",
"description": "Requested ID that returned no data — in canonical form when it was looked up, as sent when it is not an arXiv ID."
},
"detail": {
"type": "string",
"description": "Additional human-readable context, when available"
},
"reason": {
"enum": [
"not_in_arxiv",
"version_not_in_mirror",
"version_not_served",
"live_lookup_failed",
"invalid_id"
],
"type": "string",
"description": "Why the paper ID could not be returned."
}
},
"description": "A requested ID that could not be returned, with the reason it was missed.",
"additionalProperties": false
},
"description": "Per-input explanations for inputs that could not be returned. Absent when nothing failed."
},
"remaining_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Distinct well-formed IDs past the first 10, in canonical form and request order, that this call did not look up. Pass them as paper_ids in the next call. Absent when every well-formed ID was looked up."
},
"totalSucceeded": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of successful items in 'papers'"
}
},
"additionalProperties": false
}arxiv_get_metadata annotations
{
"readOnlyHint": true
}arxiv_read_paper — Arxiv Read Paper
Advertised read-only
Fetch the full text of an arXiv paper. Tries arxiv.org/html first, falls back to ar5iv.labs.arxiv.org, and falls back again to text extracted from the PDF when neither has an HTML render — check the source field to know which one answered. Page through long papers with start and max_characters, or pass max_characters null to get the entire body in one call. To read one section, take the outline from the first page (start 0) and pass an entry's start.
arxiv_read_paper input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"paper_id"
],
"properties": {
"start": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Character offset into the cleaned body to begin reading from. Defaults to 0. Use with max_characters to page through long papers — e.g., start=100000 with max_characters=100000 returns chars 100,000–199,999 — or pass an outline entry's start to read from that heading. The total length is reported as body_characters in the response."
},
"paper_id": {
"type": "string",
"minLength": 1,
"description": "arXiv paper ID: \"2401.12345\", \"2401.12345v2\" (a pinned version), or a pre-2007 ID like \"hep-th/9901001\" (archive spelled as arXiv issued it), optionally prefixed \"arXiv:\", or an arxiv.org abs, pdf, or html URL, with or without https:// or a ?query or #fragment."
},
"max_characters": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "null"
}
],
"default": 100000,
"description": "Maximum characters of paper body to return, counted after boilerplate stripping. Defaults to 100,000; pass null to return the entire body in one call. Whole-paper reads can exceed a client tool-result size cap — math-heavy bodies run 300KB-1MB+ — so prefer the default plus start-based paging unless the full text is needed. When truncated, a notice and the total character count are included."
}
},
"additionalProperties": false
}arxiv_read_paper output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"paper_id",
"title",
"content",
"source",
"truncated",
"start",
"total_characters",
"body_characters",
"pdf_url",
"abstract_url"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"invalid_id",
"no_match",
"content_unavailable",
"pdf_extraction_failed",
"version_unavailable",
"version_not_served",
"rate_limited",
"invalid_request"
],
"description": "Machine-readable failure mode. Declared by this tool: `invalid_id`: paper_id is not an arXiv identifier in an accepted form. `no_match`: arXiv has no paper with this ID, or no such version when the ID pins one. `content_unavailable`: Paper exists but neither arxiv.org/html nor ar5iv has an HTML rendering and arXiv served no PDF either. `pdf_extraction_failed`: Paper has no HTML rendering and its PDF yields no text: the PDF carries no text layer (an image-only or scanned submission), or the PDF parser cannot read the file (damaged, truncated, or not a PDF). `version_unavailable`: A version-pinned paper_id was requested, arXiv is unreachable, and the local mirror holds only a different version — per-version reads require the live API. `version_not_served`: paper_id pins a superseded version of a pre-2007 paper that arXiv's API answers HTTP 500 for. The version exists, but its metadata cannot be returned. `rate_limited`: arXiv has throttled requests (HTTP 429 or \"Rate exceeded.\" body). `invalid_request`: arXiv rejected the metadata lookup (HTTP 4xx other than 429). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"start": {
"type": "number",
"description": "Character offset of the first character in content within the cleaned body."
},
"title": {
"type": "string",
"description": "Paper title (from metadata, not parsed from HTML)."
},
"source": {
"enum": [
"arxiv_html",
"ar5iv",
"pdf_text"
],
"type": "string",
"description": "Which upstream artifact the body was read from. arxiv_html and ar5iv are HTML renders; pdf_text is text extracted from the PDF, where prose is reliable but math, tables, and heading structure are flattened. ar5iv keeps one render per paper, so an ar5iv body can be another revision than paper_id (see revision_unconfirmed)."
},
"content": {
"type": "string",
"description": "Paper body for the requested slice — the article as cleaned HTML, with relative image, object, and link URLs made absolute (in-page #fragment links stay as written), when source is arxiv_html or ar5iv; plain text when source is pdf_text. Empty when start is past body_characters."
},
"outline": {
"type": "array",
"items": {
"type": "object",
"required": [
"level",
"title",
"start"
],
"properties": {
"level": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Heading depth from its tag number minus one: h2 = 1, h3 = 2, and so on to h6 = 5."
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Offset of the heading in the cleaned body. Pass as start to read from it."
},
"title": {
"type": "string",
"description": "Heading text with markup removed, e.g. \"3.1 Encoder and Decoder Stacks\"; cut at 120 characters."
}
},
"description": "A part, chapter, section, subsection, subsubsection, paragraph, appendix, or bibliography heading.",
"additionalProperties": false
},
"description": "Section headings of the whole cleaned body in document order, each with the start that reads from it. Returned only when start is 0. Empty for pdf_text, whose text carries no reliable headings. At most 200 entries — see outline_omitted_levels and outline_continues_at."
},
"pdf_url": {
"type": "string",
"description": "Direct PDF download URL."
},
"paper_id": {
"type": "string",
"description": "arXiv paper ID."
},
"truncated": {
"type": "boolean",
"description": "True when more body content exists past this slice (start + content.length < body_characters)."
},
"abstract_url": {
"type": "string",
"description": "arXiv abstract page URL for attribution."
},
"body_characters": {
"type": "number",
"description": "Character count of the full cleaned body. Use with start and max_characters to page. Typically 2-8× smaller than total_characters for HTML papers, most for math-heavy ones."
},
"total_characters": {
"type": "number",
"description": "Character count of the body before cleaning — the article HTML, without the site header and footer, for arxiv_html and ar5iv; equal to body_characters for pdf_text, which needs no cleaning."
},
"outline_continues_at": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Present when the shallowest heading level alone has more than 200 headings, so outline stops at its first 200: the start of the first heading left out. Pass it as start to read on from there."
},
"revision_unconfirmed": {
"type": "boolean",
"const": true,
"description": "Present, true, when source is ar5iv: ar5iv keeps one render per paper whatever version is asked for, so the body may be another revision than paper_id, while pdf_url is exactly the paper_id revision. Absent for every other source, and for an unversioned read where the arXiv API reported v1 as the only version of the paper."
},
"outline_omitted_levels": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Heading levels left out of outline because the paper has more than 200 headings, deepest first. Present only when levels were left out."
}
},
"additionalProperties": false
}arxiv_read_paper annotations
{
"readOnlyHint": true
}arxiv_list_categories — Arxiv List Categories
Advertised read-only
List arXiv category codes and names. Useful for discovering valid category filters for arxiv_search_papers. Lists subject classes only; arxiv_search_papers also accepts a bare archive code (the part before the dot, e.g. "astro-ph" or "cs") to search a whole archive at once.
arxiv_list_categories input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"group": {
"enum": [
"cs",
"econ",
"eess",
"math",
"physics",
"q-bio",
"q-fin",
"stat"
],
"type": "string",
"description": "Filter by top-level group (e.g., \"cs\", \"math\", \"physics\"). Returns all categories if omitted."
}
},
"additionalProperties": false
}arxiv_list_categories output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"categories",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"notice": {
"type": "string",
"description": "Guidance when the group filter returns no categories."
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"group"
],
"properties": {
"code": {
"type": "string",
"description": "Category code (e.g., \"cs.AI\")."
},
"name": {
"type": "string",
"description": "Full name (e.g., \"Artificial Intelligence\")."
},
"group": {
"type": "string",
"description": "Top-level group (e.g., \"cs\")."
}
},
"description": "arXiv category — subject code, full name, and top-level group.",
"additionalProperties": false
},
"description": "arXiv categories matching the filter."
},
"totalCount": {
"type": "number",
"description": "Total number of categories returned."
}
},
"additionalProperties": false
}arxiv_list_categories annotations
{
"readOnlyHint": true
}Prompts
0 advertised
Resources
2 advertised
arXiv Categories — arXiv Categories
Full arXiv category taxonomy. Returns JSON `{ categories: [...] }` — one flat array of every category, each carrying its code, name, and group.
arXiv Categories URI
arxiv://categoriesarxiv-guide
Resolve citations to arXiv IDs, find an author's papers, follow a paper's versions, and read long papers section by section with the arxiv_* tools. Use when a task needs arXiv preprints found by citation (author-year, CoRR abs/ refs, arXiv DOIs), author, category, or date, or needs a paper's full text.
arxiv-guide URI
skill://arxiv-guide/SKILL.mdarXiv Paper Metadata — arXiv Paper Metadata
Paper metadata by arXiv ID. Returns PaperMetadata as JSON.
arXiv Paper Metadata URI template
arxiv://paper/{paperId}io.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 620 ms
- 95th percentile latency
- 620 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 620 ms · metadata changed · 4 tool(s), 2 resource(s), 2 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http arxiv-mcp-server-caseyjhand https://arxiv.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add arxiv-mcp-server-caseyjhand --url https://arxiv.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"arxiv-mcp-server-caseyjhand": {
"url": "https://arxiv.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"arxiv-mcp-server-caseyjhand": {
"type": "streamableHttp",
"url": "https://arxiv.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"arxiv-mcp-server-caseyjhand": {
"type": "http",
"url": "https://arxiv.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http arxiv-mcp-server-caseyjhand https://arxiv.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
https://arxiv.caseyjhand.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"arxiv-mcp-server-caseyjhand": {
"serverUrl": "https://arxiv.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like arxiv-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.