Hosted MCP server · #107 most used on Smithery
arxiv-mcp-server
cyanheads/arxiv-mcp-server
Search arXiv, fetch paper metadata, and read full-text content.
- Uses
- 5.2k
- Tools
- 4
- Runs
- Hosted
- Listed
- 7mo ago
Get started
Add it to your agent
npx -y @smithery/cli@latest install cyanheads/arxiv-mcp-server --client claudeSwap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.
claude mcp add --transport http arxiv https://server.smithery.ai/cyanheads/arxiv-mcp-server/mcpA hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.
[mcp_servers.arxiv]
url = "https://server.smithery.ai/cyanheads/arxiv-mcp-server/mcp"Add to ~/.codex/config.toml.
{
"mcpServers": {
"arxiv": {
"url": "https://server.smithery.ai/cyanheads/arxiv-mcp-server/mcp"
}
}
}Add to ~/.cursor/mcp.json.
{
"servers": {
"arxiv": {
"type": "http",
"url": "https://server.smithery.ai/cyanheads/arxiv-mcp-server/mcp"
}
}
}Add to .vscode/mcp.json.
gemini mcp add --transport http arxiv https://server.smithery.ai/cyanheads/arxiv-mcp-server/mcpSaved to .gemini/settings.json.
What it can do
4 tools
arxiv_search6 paramsSearch arXiv papers by query with category and sort filters. Returns paper metadata including title, authors, abstract, categories, and l…
Search arXiv papers by query with category and sort filters. Returns paper metadata including title, authors, abstract, categories, and links.
| Parameter | Type | Description |
|---|---|---|
query | string | Search query. Field prefixes: ti: (title), au: (author — token-based; quote multi-token names like au:"hinton g" or pair with a topical clause to disambiguate common surnames), abs: (abstract), cat: ( |
start | integer | Pagination offset (0-10000). Use with max_results to page through results. E.g., start=10 with max_results=10 returns results 11-20. |
sort_by | string | Sort criterion. Use "submitted" for newest papers, "relevance" for best query matches. |
category | string | Filter results to a specific arXiv category (e.g., "cs.CL", "math.AG"). Use arxiv_list_categories to discover valid codes. |
sort_order | string | Sort direction. "descending" returns newest/most relevant first. |
max_results | integer | Maximum results to return (1-50). Default 10. Each result includes title, authors, abstract, and metadata — keep low to limit response size. |
arxiv_get_metadata1 paramGet full metadata for one or more arXiv papers by ID. Use when you have known IDs from citations, prior search results, or memory.
| Parameter | Type | Description |
|---|---|---|
paper_ids | arXiv paper ID or array of up to 10 IDs. Format: "2401.12345" or "2401.12345v2" (with version). Also accepts legacy IDs like "hep-th/9901001". |
arxiv_read_paper3 paramsFetch the full text of an arXiv paper as HTML. Tries arxiv.org/html first; falls back to ar5iv.labs.arxiv.org when the native render is u…
Fetch the full text of an arXiv paper as HTML. Tries arxiv.org/html first; falls back to ar5iv.labs.arxiv.org when the native render is unavailable. PDF-only papers (no HTML render on either source) return an html_unavailable error with the pdf_url for direct download. Page through long papers with the start and max_characters parameters.
| Parameter | Type | Description |
|---|---|---|
start | integer | 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–1 |
paper_id | string | arXiv paper ID (e.g., "2401.12345" or "2401.12345v2"). |
max_characters | integer | Maximum characters of paper body content to return. Defaults to 100,000. HTML head/boilerplate is stripped before counting. When truncated, a notice and total character count are included. |
arxiv_list_categories1 paramList arXiv category codes and names. Useful for discovering valid category filters for arxiv_search.
| Parameter | Type | Description |
|---|---|---|
group | string | Filter by top-level group (e.g., "cs", "math", "physics"). Returns all categories if omitted. |
Readable data
Resources
arXiv CategoriesFull arXiv category taxonomy. Returns grouped category list as JSON.