arXiv MCP Server（cyanheads）

Quick Verdict

The cyanheads arXiv MCP Server is a read-only scholarly retrieval service for MCP clients such as Claude, Cursor, and VS Code. As of July 21, 2026, the verifiable npm release of @cyanheads/arxiv-mcp-server is v1.2.15. The Apache-2.0 project exposes four tools and two resources, runs locally through stdio, and can be self-hosted with Streamable HTTP. It is useful for searching arXiv, fetching metadata by ID, reading available HTML representations, and discovering category codes. It is not a citation manager, a peer-review database, or a universal PDF parser.

The project also advertises a convenience endpoint at https://arxiv.caseyjhand.com/mcp and an optional SQLite plus FTS5 metadata mirror. The endpoint is good for a trial, but the repository does not publish an uptime, capacity, retention, support, or service-level commitment. Production workflows should self-host and monitor the server. The mirror can reduce dependence on the live API for search and metadata; it deliberately does not mirror full text, and it should not be treated as permission to harvest paper content in bulk.

Best For

• Researchers who want precise arXiv search through field prefixes and Boolean syntax inside an MCP conversation.
• Students and R&D teams sending a limited set of paper metadata or HTML content to an assistant for initial summaries and comparisons.
• Technical teams willing to self-host, pin an npm version, record versioned arXiv IDs, and verify sources independently.
• Shared deployments with enough repeated metadata traffic to justify operating a local SQLite mirror.
• It is not ideal for complete citation graphs, publisher versions of record, audit-grade bibliography management, or a hosted service with a contractual SLA.

Key Features

• arxiv_search: supports ti:, au:, abs:, cat:, and all: fields with AND, OR, and ANDNOT. Category filtering, relevance/submission/update sorting, pagination, and up to 50 returned results are documented.
• arxiv_get_metadata: fetches metadata for up to ten modern, versioned, unversioned, or legacy arXiv IDs and reports missing IDs separately.
• arxiv_read_paper: tries native arXiv HTML and then ar5iv. It collapses MathML into LaTeX-like delimiters, but returns raw HTML rather than a normalized scholarly document model.
• arxiv_list_categories: exposes roughly 155 categories across eight top-level groups as static taxonomy data.
• Two resources: arxiv://paper/{paperId} provides paper metadata, while arxiv://categories provides the taxonomy.
• Dual transport and authentication: the same codebase supports stdio and Streamable HTTP. A self-hosted HTTP deployment can configure no authentication, JWT, or OAuth.
• Rate handling: the default request delay is 3,000 milliseconds. Adaptive cooldown uses 5, 10, 20, and 30 seconds, honors Retry-After, and retries transient failures with backoff.
• Optional mirror: OAI-PMH metadata can be harvested into SQLite and FTS5 for local search and metadata lookup. Full-text reads remain online.

Use Cases

For topic research, begin with arxiv_list_categories, narrow the search to tens rather than thousands of candidates, batch-fetch metadata for known IDs, and read only the most relevant papers. For a fixed paper, preserve a versioned arXiv ID so later revisions do not silently change the content being discussed. The mirror is useful for repeated organizational searches, but its multi-hour initial harvest is unnecessary for a one-off personal query.

The official arXiv API manual encourages at least about three seconds between repeated calls. It recommends refining result sets above 1,000 matches, requesting slices no larger than 2,000, and using OAI-PMH for bulk metadata. The server’s default three-second queue is appropriate for interactive calls, but users sharing an outbound IP will still serialize or contend for the same upstream allowance. Do not lower ARXIV_REQUEST_DELAY_MS to bypass upstream policy. Cache duplicate searches, limit concurrency, and back off from 429 or transient errors.

Paper HTML, abstracts, and links are untrusted content. They can include prompt injection, misleading instructions, hostile URLs, or simply incorrect claims that have not been peer reviewed. An MCP client must not expose secrets, read unrelated files, execute code, or expand tool access because text in a paper requests it. This server also does not create a verified bibliography. Before citing, check the version page, DOI, author order, publication date, journal reference, and withdrawal or replacement status.

Pricing

The software is free under Apache-2.0. Version 1.2.15 is published on npm and declares Node.js >=24.0.0 or Bun >=1.3.0. Users can pin bunx @cyanheads/arxiv-mcp-server@1.2.15, use the project’s MCPB and editor installation links, build from source, or run a container. Pinning an exact version is safer than latest when tool schemas are part of a production workflow.

Apache-2.0 applies only to the server code. arXiv metadata is CC0, but paper full text is licensed per article version. A paper may use CC BY, another Creative Commons license, or arXiv’s perpetual non-exclusive distribution license. Free access does not automatically permit redistribution, model training, adaptation, or commercial reuse. Check the license attached to the exact version before reusing full text.

Pros

• A verifiable v1.2.15 npm release gives clear version, runtime, integrity, and Apache-2.0 metadata.
• Four focused tools and two resources have narrower, more auditable responsibilities than a very large server surface.
• stdio and Streamable HTTP enable a path from a personal MCP client to an authenticated self-hosted service.
• A default three-second queue, adaptive cooldown, Retry-After, and retry behavior reflect arXiv’s interactive API guidance.
• The optional SQLite and FTS5 mirror reduces live-API exposure for repeated searches and metadata lookups.
• Native arXiv HTML with an ar5iv fallback is more useful to a language model than returning only a PDF link.
• Static category data remains available even when the upstream search service is temporarily unavailable.

Cons

• The maintainer’s public endpoint has no published SLA, capacity, privacy, retention, or support terms and should not be the sole production dependency.
• Four tools do not include citation graphs, formatted reference export, peer-review verification, cross-database deduplication, or research-quality assessment.
• arxiv_read_paper reads HTML rather than extracting PDFs. PDF-only papers, scans, figures, tables, and difficult equations may not be available reliably.
• The mirror improves only search and metadata. Initial harvesting, storage, refresh, backup, and integrity checks add operational work.
• FTS5 BM25 ranking differs from arXiv’s online relevance ranking, and recent submissions can fall inside a refresh gap.
• Node 24 or Bun 1.3 may be newer than existing enterprise runtimes, requiring client and deployment regression tests.
• Paper content can perform prompt injection; software, metadata, and paper licenses are three separate rights layers.

Alternatives

FAQ

What is the current cyanheads arXiv MCP Server version?

As of July 21, 2026, the verifiable npm release is @cyanheads/arxiv-mcp-server@1.2.15. Pin that exact version in production and review its changelog and tool schemas before upgrading.

Can the public endpoint be used directly in production?

It is better used for evaluation. The repository provides https://arxiv.caseyjhand.com/mcp, but publishes no SLA, capacity, support response, retention, or recovery commitment. Critical workflows should self-host and monitor their own instance.

Can it read every arXiv PDF?

No. arxiv_read_paper reads native arXiv HTML and falls back to ar5iv; it is not a PDF extractor. Papers without usable HTML, scanned pages, complex layouts, and visual evidence require manual review of the original PDF.

How should a deployment respect arXiv rate limits?

Keep the default 3,000-millisecond delay, cache duplicate work, and back off from 429 and temporary failures. Narrow large searches or use OAI-PMH for bulk metadata instead of increasing MCP concurrency.

Does the local mirror include paper full text?

No. It stores OAI-PMH metadata in SQLite with FTS5. arxiv_read_paper still calls online content sources. The mirror improves metadata throughput; it is not a full-text repository.

Does Apache-2.0 make every returned paper free for commercial reuse?

No. Apache-2.0 covers the server code, metadata is CC0, and each paper version has its own license. Check the paper license before redistribution, training, adaptation, or commercial use.

Bottom Line

cyanheads arXiv MCP Server v1.2.15 is a focused arXiv integration with four tools, two resources, dual transport, respectful rate handling, and an optional metadata mirror. It is a good fit for technical users building a controlled discovery and HTML-reading workflow. It does not replace citation management, PDF extraction, or peer review, and its public endpoint has no SLA. Self-host with a pinned version, preserve the three-second request interval, treat papers as untrusted input, and verify both citations and full-text licenses at the authoritative source.