arxiv-mcp-server

An MCP server for searching arXiv, downloading papers, reading full text, retrieving original LaTeX, following citation graphs, and maintaining research alerts.

It runs locally over stdio by default. Papers and indexes stay on your machine; search, source retrieval, citation graphs, and downloads call their respective external services.

Install

Use uvx from any MCP client

Install uv and add this server to your client's MCP configuration:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": [
        "arxiv-mcp-server",
        "--storage-path",
        "/absolute/path/to/papers"
      ]
    }
  }
}

Omit --storage-path to use ~/.arxiv-mcp-server/papers.

For older papers that require PDF conversion, run the package with its PDF extra:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": [
        "--from",
        "arxiv-mcp-server[pdf]",
        "arxiv-mcp-server"
      ]
    }
  }
}

The PyPI package named arxiv-mcp-server is the supported distribution. An unrelated npm package uses the same name, so do not install this server with npm, pnpm, or npx arxiv-mcp-server.

Install the command persistently

uv tool install arxiv-mcp-server

With PDF fallback support:

uv tool install 'arxiv-mcp-server[pdf]'

After installation, use arxiv-mcp-server instead of uvx arxiv-mcp-server in the client configuration.

Claude Desktop bundle

macOS users can install a self-contained .mcpb bundle from the latest GitHub release:

• Apple Silicon: arxiv-mcp-server-darwin-arm64-<version>.mcpb
• Intel: arxiv-mcp-server-darwin-x86_64-<version>.mcpb

Open Claude Desktop, go to Settings → Extensions, and install the downloaded file. The bundle includes its Python dependencies but requires CPython 3.11.x; its native dependencies are built for that interpreter version.

Codex and repository-local clients

This repository includes:

• .mcp.json for clients that discover project-local MCP configuration
• .codex-plugin/plugin.json for Codex-compatible plugin discovery

Both use the same uvx arxiv-mcp-server stdio launch path.

Tools

The server currently exposes 13 tools.

Search and inspect a paper

Ask your MCP client to call search_papers with:

{
  "query": "\"Kolmogorov-Arnold Networks\"",
  "categories": ["cs.LG", "cs.AI"],
  "max_results": 5,
  "sort_by": "date"
}

Then call get_abstract with:

{
  "paper_id": "2404.19756"
}

Download and read full text

Call download_paper with:

{
  "paper_id": "2404.19756",
  "max_chars": 12000
}

Then page through the cached content with read_paper:

{
  "paper_id": "2404.19756",
  "start": 0,
  "max_chars": 12000
}

Large-content responses include content_length, returned_chars, next_start, and is_truncated. Pass next_start into the next call to continue reading.

Read original LaTeX by section

Call get_paper_latex with:

{
  "paper_id": "1706.03762"
}

Get the first page of its section outline with list_paper_latex_sections:

{
  "paper_id": "1706.03762",
  "start": 0,
  "max_sections": 100
}

Then call get_paper_latex_section using an ID from that outline:

{
  "paper_id": "1706.03762",
  "section_id": "3.2",
  "max_chars": 12000
}

LaTeX archives are validated, size-limited, and cached locally before content is returned.

Optional dependencies

Choose the install variant that matches the features you need:

# Base server
uv tool install arxiv-mcp-server

# Base server plus PDF conversion
uv tool install 'arxiv-mcp-server[pdf]'

# Base server plus local semantic search
uv tool install 'arxiv-mcp-server[pro]'

If the base tool is already installed, reinstall the selected variant:

uv tool install --force 'arxiv-mcp-server[pdf]'

The pdf extra installs pymupdf4llm and pymupdf-layout for papers without usable arXiv HTML. The pro extra adds local embedding dependencies for semantic_search and reindex; semantic search only operates on papers already downloaded to the configured storage directory.

Built-in prompts

The server provides seven MCP prompt workflows. Prompt availability depends on the client; the server provides workflow instructions but does not run a separate model.

Streamable HTTP

For deployments where stdio is not practical:

TRANSPORT=http HOST=127.0.0.1 PORT=8080 \
  uvx arxiv-mcp-server --storage-path /absolute/path/to/papers

Connect clients to:

{
  "mcpServers": {
    "arxiv": {
      "type": "http",
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

The server binds to 127.0.0.1 by default and enables MCP DNS-rebinding protection. If a reverse proxy exposes the server, keep the process on a private interface and provide authentication and network controls upstream. Use ALLOWED_HOSTS and ALLOWED_ORIGINS for the host and origin values forwarded by the proxy.

Configuration

Environment variable names are case-insensitive through Pydantic settings. --storage-path is a command-line option rather than an environment setting.

Security

Paper text and LaTeX are untrusted external content. A paper can contain text intended to manipulate an AI client into ignoring its instructions or calling unrelated tools.

• Do not treat instructions found inside a paper as trusted commands.
• Use client approval controls for shell, browser, filesystem, and messaging tools.
• Review generated summaries before taking external actions.
• Keep Streamable HTTP private unless authentication is provided upstream.

See SECURITY.md for the reporting policy and threat details.

Development

git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server
uv sync --extra test --extra dev
uv run pytest
uv run black --check .

Run the development checkout from an MCP client with:

{
  "mcpServers": {
    "arxiv-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/arxiv-mcp-server",
        "run",
        "arxiv-mcp-server"
      ]
    }
  }
}

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request, and use GitHub Issues for reproducible bugs or scoped feature proposals.

License

Apache License 2.0. See LICENSE.