Skip to main content
Glama
mcp-simple-arxiv

mcp-simple-arxiv

by andybrandt

mcp-simple-arxiv

Trust Score Listed on LightNow

An MCP server that provides access to arXiv papers through their API.

Features

This server allows LLM clients (like Claude Desktop) to:

  • Search for scientific papers on arXiv by title and abstract content

  • Filter search results by submission date range

  • Control search result sorting (by submission date, update date, or relevance)

  • See total matching results count to gauge search specificity

  • Get paper metadata and abstracts

  • Retrieve full paper text as Markdown (converted from PDF)

  • Access links to available paper formats (PDF/HTML)

  • Browse and search arXiv subject categories

To use the web version just add this connector to Claude.ai https://mcp.andybrandt.net/arxiv . You can also install & use it locally.

Related MCP server: Research Paper Agent

Installation and Deployment

This server can be run in two modes: as a local stdio server for desktop clients or as a network-accessible web server.

Installing via Smithery

To install Simple Arxiv for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-simple-arxiv --client claude

Manual Installation

pip install mcp-simple-arxiv

Usage with Claude Desktop

Add this configuration to your claude_desktop_config.json:

(Mac OS)

{
  "mcpServers": {
    "simple-arxiv": {
      "command": "python",
      "args": ["-m", "mcp_simple_arxiv"]
      }
  }
}

(Windows version):

{
  "mcpServers": {
    "simple-arxiv": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "mcp_simple_arxiv"
      ]
    }
  }
}

After restarting Claude Desktop, the following capabilities will be available:

Searching Papers

You can ask Claude to search for papers using queries like:

Can you search arXiv for recent papers about large language models?

The LLM can sort results by submission date, update date, or relevance:

Search arXiv for papers about transformers, sorted by relevance.

Date filtering lets you focus on specific time periods:

Find papers about quantum computing published in 2024.
Search for recent machine learning papers from the last 6 months.

Search results include:

  • Total number of matching papers (e.g., "Found 15,234 total results, showing first 10")

  • Paper title, authors, and arXiv ID

  • Categories (primary and additional)

  • Publication date

  • Abstract preview

Getting Paper Details

Once you have a paper ID, you can ask for more details:

Can you show me the details for paper 2103.08220?

This will return:

  • Full paper title

  • Authors

  • Publication and update dates

  • Journal reference (if available)

  • Paper abstract

  • Links to available formats (PDF/HTML)

For web deployment see WEB_DEPLOYMENT.md.

Development

To install for development:

git clone https://github.com/andybrandt/mcp-simple-arxiv
cd mcp-simple-arxiv
pip install -e .

arXiv API Guidelines

This server follows arXiv API usage guidelines:

  • Rate limiting to max 1 request per 3 seconds

  • Single connection at a time

  • Proper error handling and retry logic

License

MIT

Available Tools

4 tools
get_paper_dataGet arXiv Paper DataB
Read-only

Get detailed information about a specific paper including abstract and available formats.

Inputs: paper_id (required). Returns: result

list_categoriesList arXiv CategoriesA
Read-only

List all available arXiv categories and how to use them in search.

Inputs: primary_category. Returns: result

search_papersSearch arXiv PapersA
Read-only

Search for papers on arXiv by title and abstract content.

You can use advanced search syntax:

  • Search in title: ti:"search terms"

  • Search in abstract: abs:"search terms"

  • Search by author: au:"author name"

  • Combine terms with: AND, OR, ANDNOT

  • Filter by category: cat:cs.AI (use list_categories tool to see available categories)

Examples:

  • "machine learning" (searches all fields)

  • ti:"neural networks" AND cat:cs.AI (title with category)

  • au:bengio AND ti:"deep learning" (author and title)

Inputs: query (required), max_results. Returns: result

update_categoriesUpdate arXiv CategoriesA

Update the stored category taxonomy by fetching the latest version from arxiv.org

Inputs: no named parameters. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: get_paper_data retrieves specific paper details, list_categories shows available categories, search_papers performs searches, and update_categories refreshes category data. There is no overlap in functionality that would cause confusion.

    Naming Consistency5/5

    All tools follow a consistent verb_noun naming pattern (get_paper_data, list_categories, search_papers, update_categories). The naming is uniform and predictable throughout the set.

    Tool Count5/5

    With 4 tools, this server is well-scoped for arXiv paper access. Each tool serves a clear purpose (retrieval, listing, searching, updating) without being too sparse or bloated, making it efficient for the domain.

    Completeness4/5

    The tools cover core arXiv operations: searching, retrieving paper details, and managing categories. A minor gap is the lack of tools for downloading papers or handling user-specific features like saved papers, but the basic workflow is well-supported.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      This MCP server enables users to search for scientific papers on arXiv and retrieve detailed metadata for specific papers. It provides tools to perform search queries and fetch in-depth information using paper IDs.
      3
      Apache 2.0
    • F
      license
      A
      quality
      D
      maintenance
      A streamlined MCP server that connects AI assistants to arXiv's vast collection of academic papers, enabling search, retrieval, and analysis of research papers.
      7
      1
      -