Skip to directory

arXiv MCP

blazickjp (community-maintained; not operated by arXiv)

stdio by default; optional Streamable HTTP19 documented tools0

About arXiv MCP

A community-maintained local MCP server for literature research that searches arXiv, retrieves paper metadata and text, manages local paper storage and topic alerts, and can optionally build a semantic index.

What you can use it for

  • Search scholarly literature
  • Read and annotate downloaded papers
  • Inspect original LaTeX by section
  • Export citation metadata
  • Track research topics and alerts
Connection and setup
Hosting
Local stdio process; optional local Streamable HTTP mode
Transport
stdio by default; optional Streamable HTTP
Endpoint
Local process; no hosted endpoint documented
Authentication
No credential is required for default arXiv workflows. An optional free Semantic Scholar API key can reduce citation_graph rate limiting; obtain it at https://www.semanticscholar.org/product/api#api-key.

Requirements

  • uv/uvx, which provides the documented command-based Python package launch.
  • Local paper storage defaults to ~/.arxiv-mcp-server/papers.
  • Optional [pdf] extra for paper PDF conversion and [pro] extra for local semantic search; semantic search applies only to downloaded papers.

Setup steps

  1. Install Astral uv from https://docs.astral.sh/uv/ if uvx is unavailable.
  2. Configure the MCP client for stdio with command uvx and args [arxiv-mcp-server]. The official README also documents the Codex command: codex mcp add arxiv -- uvx arxiv-mcp-server.
  3. The supported Python distribution is PyPI package arxiv-mcp-server (documented release 0.8.2); do not use npm/npx because the README warns an unrelated npm package has the same name.
  4. Optionally add --from, arxiv-mcp-server[pdf], arxiv-mcp-server for PDF conversion; use the documented [pro] package extra to add semantic-search dependencies.
  5. Reconnect the client and inspect tools/list. For a harmless check, use search_papers or list_papers; avoid changing topic watches during a connectivity-only check.
Tools 19

The maintained README states that release 0.8.2 exposes 19 tools; this is a versioned documented inventory, not an observed connection or tools/list response.

  • search_papers

    Search arXiv by query, category, date, and sort order.

    01
  • get_abstract

    Retrieve metadata and abstract by arXiv ID.

    02
  • download_paper

    Download and convert a paper to local Markdown.

    03
  • list_papers

    List papers stored locally.

    04
  • read_paper

    Read bounded text from a locally stored paper.

    05
  • get_paper_outline

    Return a paginated Markdown heading outline.

    06
  • read_paper_section

    Read one bounded Markdown section.

    07
  • search_paper_text

    Search passages in a downloaded paper.

    08
  • get_paper_latex

    Retrieve bounded author-submitted LaTeX.

    09
  • list_paper_latex_sections

    List a paginated LaTeX section outline.

    10
  • get_paper_latex_section

    Read a selected LaTeX section.

    11
  • citation_graph

    Fetch references and citing papers using Semantic Scholar.

    12
  • export_citations

    Export BibTeX from arXiv metadata.

    13
  • watch_topic

    Create or update a local topic watch.

    14
  • list_watches

    List saved research topic watches.

    15
  • check_alerts

    Check saved watches for new papers.

    16
  • unwatch_topic

    Delete a local topic watch.

    17
  • semantic_search

    Search locally downloaded papers by semantic similarity (optional pro extra).

    18
  • reindex

    Rebuild the local semantic index (optional pro extra).

    19
Limitations and notes
  • This MCP server is maintained by the repository owner and is not operated by arXiv.
  • Search, downloads, and citation traversal depend on external arXiv/Semantic Scholar services and their rate limits.
  • semantic_search and reindex require the optional [pro] extra; semantic search only covers downloaded papers.
  • Paper text and LaTeX are untrusted external content that may contain prompt-injection instructions.
  • Optional HTTP mode binds to localhost by default and needs separate authentication/network controls before proxying remotely.
  • No MCP initialize, tools/list, or representative tool call was performed for this catalog entry.
Original sources
  • maintainer documentation

    Current README lists 19 tools; semantic_search and reindex require the pro extra and operate on locally downloaded papers.

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.