arXiv MCP Server

A Model Context Protocol (MCP) server that provides arXiv paper search and retrieval capabilities. This server enables LLMs to search for academic papers on arXiv and get cleaned titles, abstracts, authors, and content without dealing with complex HTML parsing.

Features

• Search papers by query, author, category, and date
• Advanced search with specific field filters
• Get detailed paper metadata (title, abstract, authors, categories)
• Retrieve full paper content through server-backed MCP resource links without embedding large papers in tool results
• Browse recent papers by category
• List all arXiv categories
• Pagination support for search results

Available Tools

search

Search arXiv for papers matching a query.

search_advanced

Advanced search with specific field filters.

get_paper

Get detailed information about a specific arXiv paper.

get_content

Validate an arXiv paper through a streamed Jina Reader request, then return an arxiv:// MCP resource link. Clients read the link through resources/read; the paper text is fetched only then and is never embedded in the tool result. A server-backed custom URI is used because MCP does not require every client to fetch external https:// resource links directly.

get_recent

Get recent papers from a specific arXiv category.

list_categories

List all common arXiv categories with their codes and names.

Installation

Using uv (Recommended)

# Clone the repository
git clone https://github.com/Ray0907/arXiv-mcp.git
cd arXiv-mcp

# Install with uv
uv sync

Using pip

# Clone the repository
git clone https://github.com/Ray0907/arXiv-mcp.git
cd arXiv-mcp

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install
pip install -e .

Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Claude Code

Add to your Claude Code MCP settings:

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

Usage Examples

Search for papers about LLMs

Search for recent papers about "large language models"

Find papers by a specific author

Search for papers by "Yann LeCun" in the machine learning category

Get paper details

Get the details of arXiv paper 2301.00001

Browse recent papers

Show me the 10 most recent papers in cs.AI

Development

Run tests

uv run pytest

Run the server locally

uv run arxiv-mcp

Common arXiv Categories

Use list_categories tool to get the full list.

Changelog

v0.4.0

Breaking Changes:

• Upgraded to MCP Python SDK v2 (mcp>=2.0.0); server now uses MCPServer (formerly FastMCP)
• Structured output: all tools declare an outputSchema and return typed structured content (search/search_advanced return SearchResult, get_paper returns Paper, get_recent returns RecentPapers)
• list_categories structured content is wrapped as {"result": [...]} because the MCP spec requires structuredContent to be a JSON object
• Errors no longer return {"error": "..."} dicts or error strings; all failures (HTTP errors, invalid arXiv ID, missing search fields) now raise and surface as standard MCP tool errors

Improvements:

• New RecentPapers model for get_recent responses

v0.3.0

Breaking Changes:

• Renamed all tools to snake_case: search_advanced, get_paper, get_content, get_recent, list_categories (existing client configurations referencing camelCase names must be updated)

Security:

• Fixed SSRF bypass in get_content: non-arxiv.org URLs containing a valid arXiv ID in the path (e.g. https://evil.com/abs/2301.00001) are now correctly rejected

Improvements:

• All tools are now async def using httpx.AsyncClient
• HTTP errors return {"error": "..."} dicts instead of raising exceptions, so the LLM can read and retry
• All tools annotated with readOnlyHint: true and openWorldHint: true
• SearchResult now includes has_more: bool and next_page: int | null for easier pagination
• list_categories pre-computes the category list at import time instead of on every call

v0.2.0

Breaking Changes:

• Renamed entry point from arxiv-server.py to arxiv-mcp command
• Renamed get tool to getContent for clarity

New Features:

• searchAdvanced - Advanced search with title, abstract, date range filters
• getPaper - Get detailed paper metadata (authors, categories, dates, PDF URL)
• getRecent - Browse recent papers by category
• listCategories - List 33 common arXiv categories
• Pagination support (page, page_size parameters)
• Sort options (relevance, date_desc, date_asc)
• Filter by author and category in basic search

Improvements:

• Migrated to pyproject.toml with uv for dependency management
• Replaced requests with httpx (async-ready)
• Added Pydantic models for type-safe data structures
• Reduced dependencies from 33 to 4 core packages
• Added proper timeout handling (30s)
• Modular project structure (src/arxiv_mcp/)

v0.1.0

• Initial release
• Basic search and get tools

License

MIT License - see LICENSE for details.