Tools

Four tools for searching and reading arXiv papers:

| Tool Name | Description | |:----------|:------------| | arxiv_search | Search arXiv papers by query with category and sort filters. | | arxiv_get_metadata | Get full metadata for one or more arXiv papers by ID. | | arxiv_read_paper | Fetch the full text content of an arXiv paper from its HTML rendering. | | arxiv_list_categories | List arXiv category taxonomy, optionally filtered by group. |

arxiv_search

Search for papers using free-text queries with field prefixes and boolean operators.

• Field prefixes: ti: (title), au: (author), abs: (abstract), cat: (category), all: (all fields)
• Boolean operators: AND, OR, ANDNOT
• Optional category filter, sorting (relevance, submitted, updated), and pagination
• Returns up to 50 results per request with full metadata including abstract

arxiv_get_metadata

Fetch full metadata for one or more papers by known arXiv ID.

• Batch fetch up to 10 papers in a single request
• Accepts both versioned (2401.12345v2) and unversioned (2401.12345) IDs
• Legacy ID format supported (hep-th/9901001)
• Reports not-found IDs separately from found papers

arxiv_read_paper

Read the full HTML content of an arXiv paper.

• Tries native arXiv HTML first, falls back to ar5iv for broader coverage
• Strips HTML head/boilerplate before truncation so the character budget targets paper content
• max_characters defaults to 100,000; raw HTML can be 500KB-3MB+ for math-heavy papers
• Returns raw HTML — no parsing or extraction; the LLM interprets content directly

arxiv_list_categories

List arXiv category codes and names for discovery.

• ~155 categories across 8 top-level groups (cs, math, physics, q-bio, q-fin, stat, eess, econ)
• Optional group filter to narrow results
• Static data — always succeeds

Resources

| URI Pattern | Description | |:------------|:------------| | arxiv://paper/{paperId} | Paper metadata by arXiv ID. | | arxiv://categories | Full arXiv category taxonomy. |

Features

Built on @cyanheads/mcp-ts-core:

• Declarative tool definitions — single file per tool, framework handles registration and validation
• Unified error handling across all tools
• Pluggable auth (none, jwt, oauth)
• Structured logging with optional OpenTelemetry tracing
• Runs locally (stdio/HTTP) from the same codebase

arXiv-specific:

• Read-only, no authentication required — arXiv API is free, metadata is CC0
• Rate-limited request queue enforcing arXiv's 3-second crawl delay
• Retry with exponential b

... View full README on GitHub