Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.cyanheads/arxiv-mcp-server

REMOTE · ARXIV.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3

Search arXiv, fetch paper metadata, and read full-text content.

+5 this week 71 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security66
  • The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
  • Authorisation not fully verified: no authorisation is required to call this server, and 4 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
  • HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
  • The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
  • DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
Schema Quality & AI Usability76
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 1219 tokens (~243/item across 5 items; 4 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · arxiv.caseyjhand.com

# add to Claude Code
claude mcp add --transport http cyanheads-arxiv-mcp-server https://arxiv.caseyjhand.com/mcp
# ~/.codex/config.toml
[mcp_servers.cyanheads-arxiv-mcp-server]
url = "https://arxiv.caseyjhand.com/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-arxiv-mcp-server": {
      "type": "remote",
      "url": "https://arxiv.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add cyanheads-arxiv-mcp-server --url https://arxiv.caseyjhand.com/mcp --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  cyanheads-arxiv-mcp-server:
    url: "https://arxiv.caseyjhand.com/mcp"
// mcp.json
{
  "mcpServers": {
    "cyanheads-arxiv-mcp-server": {
      "type": "http",
      "url": "https://arxiv.caseyjhand.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

  • 1 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

  • 31 Jul 26 +1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 29 Jul 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

  • 28 Jul 26 +1
    • Server version: 1.4.0 → 1.5.0 functional
  • 27 Jul 26 −1
    • Schema quality: 165 → 243 functional
    • Stability: unverified → 0.03 functional
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Jul 26 67

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://arxiv.caseyjhand.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=caseyjhand.com CN=WE1,O=Google Trust Services,C=US 7 Jul 2026 5 Oct 2026 ECDSA 256 ECDSA-SHA256 5aad900eb2055a0b0ea55912ec19680c
SANs: caseyjhand.com, *.caseyjhand.com
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b
DNSSEC secure

Validation of arxiv.caseyjhand.com. Secure

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
caseyjhand.com. present 2371 13 Verified
arxiv.caseyjhand.com. Verified address RRset verified with the apex keys
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200
Header Value
strict-transport-security max-age=63072000; includeSubDomains; preload
x-content-type-options nosniff
Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://arxiv.caseyjhand.com/mcp Verified 200
http (plaintext) http://arxiv.caseyjhand.com/mcp HTTPS enforced 301 https://arxiv.caseyjhand.com/mcp
MCP tools — 4 exposed · ~1,085 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
arxiv_get_metadata ~95

Get full metadata for one or more arXiv papers by ID. Use when you have known IDs from citations, prior search results, or memory.

NameTypeReqDescription
paper_idsyesarXiv 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".
NameTypeReqDescription
not_foundarrayPer-input explanations for inputs that could not be returned. Absent when nothing failed.
papersarrayyesPapers found. May be fewer than requested if some IDs are invalid.
totalSucceededintegeryesNumber of successful items in 'papers'

No examples provided.

arxiv_list_categories ~100

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.

NameTypeReqDescription
groupstringFilter by top-level group (e.g., "cs", "math", "physics"). Returns all categories if omitted.
NameTypeReqDescription
categoriesarrayyesarXiv categories matching the filter.
noticestringGuidance when the group filter returns no categories.
totalCountnumberyesTotal number of categories returned.

No examples provided.

arxiv_read_paper ~289

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.

NameTypeReqDescription
max_charactersMaximum 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-resul…
paper_idstringyesarXiv paper ID (e.g., "2401.12345" or "2401.12345v2").
startintegerCharacter 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–…
NameTypeReqDescription
abstract_urlstringyesarXiv abstract page URL for attribution.
body_charactersnumberyesCharacter count of the full cleaned body. Use with start and max_characters to page. Typically 3-4× smaller than total_characters for math-heavy HTML papers.
contentstringyesPaper body for the requested slice — cleaned HTML when source is arxiv_html or ar5iv, plain text when source is pdf_text. Empty when start is past body_characters.
paper_idstringyesarXiv paper ID.
pdf_urlstringyesDirect PDF download URL.
sourcestringyesWhich 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 fla…
startnumberyesCharacter offset of the first character in content within the cleaned body.
titlestringyesPaper title (from metadata, not parsed from HTML).
total_charactersnumberyesCharacter count of the body before cleaning — the unprocessed HTML body for arxiv_html and ar5iv, and equal to body_characters for pdf_text, which needs no cleaning.
truncatedbooleanyesTrue when more body content exists past this slice (start + content.length < body_characters).

No examples provided.

arxiv_search ~601

Search arXiv papers by query with category and sort filters. Returns paper metadata including title, authors, abstract, categories, and links.

NameTypeReqDescription
categorystringRestrict 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 plu…
max_resultsintegerMaximum results to return (1-50). Default 10. Each result includes title, authors, abstract, and metadata — keep low to limit response size.
querystringyesSearch 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:…
sort_bystringSort criterion. Use "submitted" for newest papers, "relevance" for best query matches.
sort_orderstringSort direction. "descending" returns newest/most relevant first.
startintegerPagination offset (0-10000). Use with max_results to page through results. E.g., start=10 with max_results=10 returns results 11-20. Matches beyond offset 10000 + max_results are unreachable by pagin…
submitted_fromstringEarliest submission date to include, inclusive, as a UTC YYYY-MM-DD date. Omit for no lower bound.
submitted_tostringLatest 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…
NameTypeReqDescription
capnumberThe max_results limit applied to this page.
effectiveQuerystringyesThe 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 o…
noticestringRecovery guidance when results are empty or paging overshot. Absent on successful pages.
pageStartnumberyesPagination offset of this result page.
papersarrayyesMatching papers with full metadata.
shownnumberPapers returned on this page.
totalFoundnumberyesTotal matching papers reported by arXiv (before pagination).
truncatedbooleanTrue when more matching papers exist beyond this page (totalFound > start + shown).

No examples provided.