# andybrandt/mcp-simple-arxiv [Health: Active]

**Category:** 🔬 Research  
**Repository:** https://github.com/andybrandt/mcp-simple-arxiv  
**GitHub Stars:** 202  
**Views:** 8  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/andybrandt-mcp-simple-arxiv

## Description
MCP for LLM to search and read papers from arXiv

## Tools
Capabilities this server exposes over MCP:

- **search_papers** — Search for papers on arXiv.

IMPORTANT - DEFAULT BEHAVIOR WARNING:
ArXiv treats space-separated words as OR by default, returning papers matching
ANY word. This often returns thousands of irrelevant results. Use field
prefixes (especially ti:) for precise searches.

SEARCH STRATEGY (in order of precision):
1. Start with ti: (title) searches - fastest and most relevant results
2. Add cat: (category) to filter by field - use list_categories tool first!
3. Use au: (author) when you know specific researchers
4. Combine multiple terms with AND for best results
5. Avoid plain keyword searches without field prefixes

QUERY OPERATORS:
- ti:"text"   - Search in title only (RECOMMENDED FOR PRECISION)
- abs:"text"  - Search in abstract
- au:"name"   - Search by author
- cat:CODE    - Filter by category (e.g., cat:cs.AI, cat:quant-ph)
- Combine with: AND, OR, ANDNOT

EXAMPLES (from most to least precise):
- ti:"neural networks" AND cat:cs.AI     - Title phrase + category (BEST)
- ti:"deep learning" AND au:bengio       - Title + author
- cat:cs.AI AND ti:transformer           - Category + title keyword
- ti:"machine learning"                  - Title phrase only
- "machine learning"                     - All fields (broad, use sparingly)

TROUBLESHOOTING - Too many irrelevant results?
1. Use ti:"exact phrase" instead of bare keywords
2. Add cat:CATEGORY to filter by field (run list_categories first)
3. Use AND to combine multiple specific terms
4. Avoid generic terms without ti: or cat: prefixes

DATE FILTERING:
Filter papers by submission date using date_from and/or date_to parameters.
- Papers from 2024: date_from="2024-01-01", date_to="2024-12-31"
- Recent papers (2025 onwards): date_from="2025-01-01"
- Historical papers (before 2020): date_to="2019-12-31"

Args:
    query: Search query string (use field prefixes for precision).
    max_results: Maximum results to return (1-100, default 10).
    sort_by: Sort field - "submitted_date", "updated_date", or "relevance".
    sort_order: Sort direction - "descending" or "ascending".
    date_from: Filter papers submitted on or after this date (YYYY-MM-DD format).
    date_to: Filter papers submitted on or before this date (YYYY-MM-DD format).
        
- **get_paper_data** — Get detailed information about a specific paper including abstract and available formats.
- **get_full_paper_text** — Get the full paper text as Markdown

Downloads and converts the paper PDF to Markdown format using Docling.
This operation takes 30-90 seconds depending on paper length.

Important considerations:
- Papers can be very large (even 10k-50k+ tokens) and may overwhelm your context window
- Complex equations and figures will most likely not convert correctly to Markdown
- Use get_paper_data first to review abstract before fetching full text
- **list_categories** — List all available arXiv categories for use with cat: filter in search_papers.

CALL THIS FIRST before using cat: in search queries to find valid category codes.

Common categories:
- cs.AI (Artificial Intelligence)
- cs.LG (Machine Learning)
- cs.CL (Computation and Language / NLP)
- stat.ML (Statistics - Machine Learning)
- quant-ph (Quantum Physics)
- q-bio.NC (Quantitative Biology - Neurons and Cognition)

Args:
    primary_category: Optional filter to show only subcategories of a specific
        primary category (e.g., "cs", "physics", "q-bio").
- **update_categories** — Update the stored category taxonomy by fetching the latest version from arxiv.org

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-simple-arxiv": {
    "command": "uvx",
    "args": ["mcp-simple-arxiv"]
  }
}
```

## Documentation

## What the andybrandt/mcp-simple-arxiv MCP server does

The andybrandt/mcp-simple-arxiv MCP server gives an MCP-compatible client access to arXiv papers through the arXiv API. It is intended for literature search, paper lookup, and retrieval of research content. A client can search by title and abstract text, narrow results by submission date, and choose sorting by submission date, update date, or relevance.

Search responses include the total number of matching records, which helps an agent judge whether a query is too broad or too narrow. Individual results can include the title, authors, arXiv identifier, primary and additional categories, publication date, and an abstract preview. After identifying a paper, the client can request its metadata and abstract, links to available PDF or HTML formats, and full paper text rendered as Markdown from the PDF.

## How it works

The server sends requests to arXiv's API and presents the returned research data through MCP. Search can be refined with a date interval, and the response exposes the total match count alongside the displayed results. The server also supports browsing and searching arXiv subject categories, which can help agents construct more targeted research queries.

Paper details are retrieved using an arXiv paper identifier, such as the identifier shown in a search result. Full-text retrieval involves converting the paper's PDF content to Markdown.

## Setup and configuration

The andybrandt/mcp-simple-arxiv MCP server can be installed from PyPI with `pip install mcp-simple-arxiv`. For a local Claude Desktop setup, configure a server entry that runs `python -m mcp_simple_arxiv`, then restart Claude Desktop. The documented Windows configuration uses the same module invocation with an explicit Python executable path.

A hosted connector is also listed at `https://mcp.andybrandt.net/arxiv` for use with Claude.ai.

## Tools and capabilities

Supported operations described in the project material include:

- Search papers using title and abstract content.
- Restrict searches to a submission date range.
- Sort matches by relevance, submission date, or update date.
- Report the total number of matching papers.
- Return paper metadata, abstracts, identifiers, authors, dates, and categories.
- Retrieve PDF or HTML links and Markdown-converted paper text.
- Browse and search arXiv subject categories.

## Limitations and notes

The server follows arXiv API usage guidance. It limits requests to a maximum of one every three seconds and allows only one connection at a time. These limits may affect workflows that issue many searches or retrieve several papers in quick succession.

The material documents Claude Desktop and Claude.ai usage, but does not provide a complete compatibility list for other MCP clients. It also does not specify configurable environment variables or authentication settings. The project is released under the MIT license.

_Full upstream README: https://allmcps.com/mcp/andybrandt-mcp-simple-arxiv/readme_