Skip to main content
Glama
Himasnhu-AT

arxiv-mcp

by Himasnhu-AT
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ARXIV_MCP_HOMENoCache root directory.~/.arxiv-mcp
ARXIV_MCP_MAX_PAPERSNoMax cached papers before LRU eviction.200
ARXIV_MCP_META_TTL_SNoTTL (s) for 'latest' (unversioned) metadata.86400
ARXIV_MCP_MAX_DISK_MBNoMax cache disk (MB) before LRU eviction.2048

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_papersA

Search arXiv and return compact paper metadata.

Provide a raw query (arXiv field syntax, e.g. au:hinton AND cat:cs.LG) and/or the structured shortcuts category (cat:), author (au:), title (ti:), abstract (abs:) which are AND-combined. Or pass id_list to fetch specific papers by id.

sort_by is one of relevance, lastUpdatedDate, submittedDate; sort_order is ascending or descending. max_results is capped at 2000 per call — page with start for more (up to 30000 total).

If session_id is given, returned papers are pinned to that session's cache so they won't be evicted while the session is open.

get_paperA

Fetch full metadata for one paper by arXiv id.

Accepts any id form: 2401.12345, arXiv:2401.12345v2, an arxiv.org/abs/... URL, hep-th/9901001, or a 10.48550/arXiv... DOI. Served from cache when possible. Returns normalized metadata plus derived pdf / abs / html / source URLs.

read_paperA

Read a paper's full text, paginated so large papers don't overflow context.

Extraction prefers arXiv HTML/LaTeX source and falls back to PDF; the result is cached permanently per exact version. page is 1-based; page_size is characters per page. The response reports total_pages and has_more so you can request the next page. To read a specific version, include it in the id (2401.12345v1); a bare id resolves to the latest.

download_paperA

Download a paper's raw pdf or source (LaTeX tarball) into the cache.

Returns the local path. Use read_paper if you want extracted text rather than the raw file.

start_sessionA

Open a caching session. Papers fetched with this session_id are pinned (never evicted) until :func:end_session, so repeated work over intervals never refetches the same paper.

end_sessionA

Close a session, unpinning its papers so they become eligible for eviction.

session_statusB

Report the papers pinned to a session.

cache_statsA

Report cache usage: paper count, disk usage, limits, sessions.

list_cachedA

List cached papers (most-recently-accessed first) with size and pin state.

clear_cacheA

Evict cached papers. By default leaves papers pinned to open sessions; set drop_pinned to remove everything.

list_categoriesA

List arXiv subject categories for building cat: filters.

Pass a group prefix (e.g. cs, math, astro-ph) to narrow, or a full category id (cs.AI) to get its description.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored across 11 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: categories, search, metadata fetch, full-text read, raw download, and session/cache management. There is no overlap or ambiguity between tool boundaries.

Naming Consistency5/5

All tool names use snake_case and follow a consistent verb_noun pattern (list_categories, search_papers, get_paper, read_paper, download_paper, start_session, end_session, clear_cache), with the only slight deviations being session_status and cache_stats, which are still intuitive and consistent with the overall scheme.

Tool Count5/5

Eleven tools is well-scoped for an arXiv server, covering search, retrieval, reading, downloading, and cache/session management. Each tool serves a clear need without unnecessary bloat or thinness.

Completeness5/5

The tool surface comprehensively covers the arXiv domain: category discovery, search, fetching metadata, reading full text, downloading raw files, and managing caching sessions. There are no obvious gaps for typical arXiv usage.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources