arxiv_get_metadata
Get full metadata for one or more arXiv papers by ID. Use when you have known IDs from citations, prior search results, or memory.
LABSCO SUMMARY
It tells you which render answered, which decides how much of the paper you can trust.
arxiv_read_paper falls through native HTML, then ar5iv, then the PDF, and the source field says which one you got. That matters: PDF-extracted bodies read fine as prose but flatten math, tables and heading structure, so an agent summarising equations out of one is on thin ice.
What it is
A read-only arXiv client. It searches using arXiv's own field prefixes and boolean operators, batches metadata for known IDs, and fetches paper bodies — trying arXiv's native HTML render first, then ar5iv, then text extracted from the PDF.
What you get
- arxiv_search with ti:, au:, abs:, cat: and all: prefixes and AND/OR/ANDNOT, a leaf-category or whole-archive filter, sorting and pagination — and it echoes the query back as actually searched
- submitted_from and submitted_to bound the submission date, which is how to reach results past the 10,000 pagination ceiling
- arxiv_get_metadata fetches up to 10 papers at once, versioned or unversioned, legacy ID formats included, and reports not-found IDs separately
- arxiv_read_paper returns the body with a source field naming which render answered; max_characters defaults to 100,000 and start pages through longer papers
- arxiv_list_categories lists the category taxonomy so a filter can be built from real codes
- Two resources: arxiv://paper/{paperId} and arxiv://categories
Requirements
No account and no key — the arXiv API is free and the metadata is CC0. A public instance runs at https://arxiv.caseyjhand.com/mcp over Streamable HTTP, or install @cyanheads/arxiv-mcp-server and run it yourself over stdio or HTTP; the registry entry launches it under bun. ARXIV_REQUEST_DELAY_MS defaults to 3000 to honour arXiv's crawl delay, ARXIV_API_TIMEOUT_MS to 15000 and ARXIV_CONTENT_TIMEOUT_MS to 30000. Self-hosted HTTP binds 127.0.0.1 on port 3010 at /mcp, with MCP_AUTH_MODE none by default.
Setup effort
One command — npx -y @cyanheads/arxiv-mcp-server
USE CASES
01
Finding recent work in one corner of a field
Search with a category filter built from real codes, sorted by submission date.
02
Resolving IDs pulled from a bibliography
Batch up to ten at once and get the ones that do not exist reported separately.
03
Reading the paper, not just the abstract
Fetch the body a character window at a time, and check which render it came from.
04
Sweeping a whole date range
Walk consecutive submission windows so the result set is not cut off by pagination.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
arxiv_list_categories
List arXiv category codes and names. Useful for discovering valid category filters for arxiv_search. Lists subject classes only; arxiv_search 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_read_paper
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.
arxiv_search
Search arXiv papers by query with category and sort filters. Returns paper metadata including title, authors, abstract, categories, and links.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. Every tool only reads and none needs authentication; arxiv://paper/{paperId} and arxiv://categories are resources, not tools.
Requires
- npx on PATH
- Bun v1.3.0 or higher (bunx) for the Claude Desktop block
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y @cyanheads/arxiv-mcp-serverHosted endpoint
ENDPOINT URL
https://arxiv.caseyjhand.com/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"arxiv-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": [
"@cyanheads/arxiv-mcp-server@latest"
]
}
}
}Cursor
CURSOR · URL
https://cursor.com/en/install-mcp?name=arxiv-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvYXJ4aXYtbWNwLXNlcnZlciJdfQ==VS Code
VS CODE · URL
https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22arxiv-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads/arxiv-mcp-server%22%5D%7DAny MCP client — remote
ANY MCP CLIENT — REMOTE · JSON
{
"mcpServers": {
"arxiv-mcp-server": {
"type": "streamable-http",
"url": "https://arxiv.caseyjhand.com/mcp"
}
}
}Clients spell the "type" value differently: Claude Code and VS Code use "http", Cline uses "streamableHttp", and Roo Code uses "streamable-http". Claude Desktop does not accept a URL entry in its config file; remote servers go under Settings → Connectors.
