Skip to main content
Glama
arxiv-mcp

arxiv-mcp

by evangit2

arxiv-mcp

MCP server for fast arXiv search + full-text extraction. No API keys.

Backend is the public export.arxiv.org API plus the ar5iv HTML rendering — stdlib networking only (urllib), so the server stays lean.

Tools

Tool

What it does

search_papers(query, max_results, sort_by, sort_order, search_field)

Keyword / title / author / category / ID search

get_paper(arxiv_id)

Full metadata + abstract for one ID

extract_paper(arxiv_id, max_chars)

Abstract + readable body text via ar5iv HTML (falls back to abstract)

corpus_lookup(paper_id)

Metadata row from the secemp9/arxiv-complete HF snapshot via the free datasets-server API (no 16 TB download)

Related MCP server: arXiv MCP Server

Quick start

pip install arxiv-mcp
arxiv-mcp   # stdio MCP server

From source:

pip install -e .
python -m arxiv_mcp.server

Client config

Claude Desktop / Hermes (~/.hermes/config.yaml style):

{
  "mcpServers": {
    "arxiv": {
      "command": "arxiv-mcp",
      "args": []
    }
  }
}
mcp_servers:
  arxiv:
    command: "arxiv-mcp"

From source without install:

mcp_servers:
  arxiv:
    command: "python"
    args: ["-m", "arxiv_mcp.server"]

Examples

  • search_papers("quantum error correction", max_results=5, sort_by="submittedDate")

  • search_papers("cs.AI", search_field="category", max_results=5)

  • get_paper("1706.03762") (Attention Is All You Need)

  • extract_paper("1706.03762")

Notes

  • No keys, no auth. Please respect arXiv's politeness limit (~1 req / 3s); the server throttles itself.

  • Full text comes from ar5iv when a rendering exists; very new papers may return abstract-only.

  • This project is not affiliated with arXiv or Hugging Face. The 16 TB secemp9/arxiv-complete HF snapshot is a separate bulk corpus — this server targets quick live lookup instead of bulk download.

License

MIT

Available Tools

4 tools
corpus_lookupCorpus LookupA

Look up one paper in the secemp9/arxiv-complete HF snapshot. No key needed.

Uses the free Hugging Face datasets-server filter API (metadata config only) — no 16 TB download. Returns the corpus metadata row for the paper (title, abstract, licence, categories, version dates) plus pointers to where its files live in the snapshot.

Inputs: paper_id (required). Returns: object

extract_paperExtract PaperA

Extract readable full text of a paper. No API key needed.

Returns the abstract (from the API) plus body text scraped from the ar5iv HTML rendering, truncated to max_chars. Falls back to the abstract alone when no HTML rendering exists yet.

Inputs: arxiv_id (required), max_chars. Returns: object

get_paperGet PaperA

Get full metadata + abstract for one arXiv ID (e.g. "1706.03762"). No API key needed.

Inputs: arxiv_id (required). Returns: object

search_papersSearch PapersB

Search arXiv papers. No API key needed.

Inputs: query (required), sort_by, sort_order, max_results, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation4/5

    search_papers, get_paper, and extract_paper have clear action boundaries. corpus_lookup overlaps with get_paper because both return metadata/abstract for a single paper, though the snapshot-specific purpose and description help distinguish them.

    Naming Consistency4/5

    All names use snake_case and are readable. Three tools follow a verb_noun pattern, but corpus_lookup uses a noun-first form, which is a minor deviation.

    Tool Count5/5

    Four tools are well-scoped for an arXiv retrieval server: search, metadata lookup, full-text extraction, and snapshot corpus lookup. Each has a distinct role without feeling thin or excessive.

    Completeness4/5

    The core workflow of searching, retrieving metadata, and extracting full text is covered. Minor gaps remain, such as no tool to download PDF/source files or list categories, though corpus_lookup provides file pointers.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides search functionality for arXiv.org papers through the official arXiv API, allowing users to search papers by keywords, filter by subject categories and date ranges, and receive comprehensive metadata including PDF links.
      32 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language search and analysis of arXiv academic papers with AI-powered relevance ranking, full-text extraction, and support for multiple integrations like Claude and LangChain.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables arXiv paper search, PDF download, text extraction, and context chunking for LLM pipelines, along with advanced features like citation graphs and reproducibility scoring.
      2
      MIT