arXiv

You can use the arXiv MCP Server to search, browse, and retrieve arXiv papers through a lightweight MCP client. It exposes practical tools to query by terms, author, category, and date, fetch detailed metadata, and obtain full paper content via a local or remote server setup. This guide shows you how to install, run, configure, and use the server end-to-end.

How to use

You will interact with the arXiv MCP Server through an MCP client. Start the server locally or connect to a remote MCP endpoint, then use the provided tools to search for papers, get paper details, fetch full content, and browse recent papers by category. You can refine searches by query, author, category, and date, and you can request detailed metadata including titles, abstracts, authors, and categories.

Practical tasks you can perform include searching for papers about a topic, filtering by category, retrieving metadata for a specific arXiv ID, and obtaining the full text content via the integrated reader. You can also list categories and browse recent submissions in a chosen category.

How to install

Prerequisites you need before installation are Python and a local Node-compatible runtime for running MCP tooling (uv). You should also have Git available to clone the project repository.

Step 1: Clone the repository and navigate into the project directory.

Step 2: Install dependencies using the recommended tooling.

Step 3: Start the MCP server using the runtime command shown in the configuration examples.

Concrete steps and commands you will execute are shown in the configuration blocks below. Follow them exactly to ensure the server runs as intended.

Configuration

Configure the MCP client to connect to your arXiv MCP server by adding the following entry to your client’s MCP settings. The examples assume you run the MCP locally from a directory path you control.

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

Claude Desktop configuration

To run the MCP server from Claude Desktop, include the MCP entry in your Claude configuration file.

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

Claude Code configuration

You can also add the MCP server entry to Claude Code settings in the same way as for Claude Desktop.

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

Usage examples

Search for papers about LLMs: request recent papers or use specific filters to narrow results.

Find papers by a specific author: restrict results to a given author and category.

Get paper details: retrieve the metadata for a particular arXiv ID.

Browse recent papers: list the latest papers in a chosen category.

Development

Run tests to verify functionality.

Run the server locally to validate end-to-end behavior.

Common arXiv Categories

This server supports a set of common arXiv categories such as Artificial Intelligence, Computation and Language, Computer Vision, Machine Learning, and more. Use the listCategories tool to view the full catalog.

Available tools

search

Query arXiv papers by keywords, category, author, and optional sorting and pagination to retrieve matching results.

searchAdvanced

Perform advanced queries with specific fields such as title, abstract, author, date range, and category to refine results.

getPaper

Fetch detailed metadata for a specific arXiv paper using its ID or URL, including title, authors, categories, and abstract.

getContent

Retrieve the full text content of a paper via Jina Reader using the paper's ID or URL.

getRecent

Get a list of recent papers in a given arXiv category, with optional count limiting.

listCategories

List all common arXiv categories with their codes and names.