ArXiv MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ArXiv MCP Server search for recent papers about large language models"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ArXiv MCP Server
๐ Enable AI assistants to search and access arXiv papers through a simple MCP interface.
The ArXiv MCP Server provides a bridge between AI assistants and arXiv's research repository through the Model Context Protocol (MCP). It allows AI models to search for papers and access their content in a programmatic way.
๐ค Contribute โข ๐ Report Bug
โจ Core Features
๐ Paper Search: Query arXiv papers with filters for date ranges and categories
๐ Paper Access: Download and read paper content
๐ Paper Listing: View all downloaded papers
๐๏ธ Local Storage: Papers are saved locally for faster access
๐ Prompts: A Set of Research Prompts
Related MCP server: ArXiv Paper MCP
๐ Quick Start
Installing via Smithery
To install ArXiv Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install arxiv-mcp-server --client claudeInstalling Manually
Install using uv:
uv tool install arxiv-mcp-serverFor development:
# Clone and set up development environment
git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install with test dependencies
uv pip install -e ".[test]"๐ MCP Integration
Add this configuration to your MCP client config file:
{
"mcpServers": {
"arxiv-mcp-server": {
"command": "uv",
"args": [
"tool",
"run",
"arxiv-mcp-server",
"--storage-path", "/path/to/paper/storage"
]
}
}
}For Development:
{
"mcpServers": {
"arxiv-mcp-server": {
"command": "uv",
"args": [
"--directory",
"path/to/cloned/arxiv-mcp-server",
"run",
"arxiv-mcp-server",
"--storage-path", "/path/to/paper/storage"
]
}
}
}๐ก Available Tools
The server provides four main tools:
1. Paper Search
Search for papers with optional filters:
result = await call_tool("search_papers", {
"query": "transformer architecture",
"max_results": 10,
"date_from": "2023-01-01",
"categories": ["cs.AI", "cs.LG"]
})2. Paper Download
Download a paper by its arXiv ID:
result = await call_tool("download_paper", {
"paper_id": "2401.12345"
})3. List Papers
View all downloaded papers:
result = await call_tool("list_papers", {})4. Read Paper
Access the content of a downloaded paper:
result = await call_tool("read_paper", {
"paper_id": "2401.12345"
})๐ Research Prompts
The server offers specialized prompts to help analyze academic papers:
Paper Analysis Prompt
A comprehensive workflow for analyzing academic papers that only requires a paper ID:
result = await call_prompt("deep-paper-analysis", {
"paper_id": "2401.12345"
})This prompt includes:
Detailed instructions for using available tools (list_papers, download_paper, read_paper, search_papers)
A systematic workflow for paper analysis
Comprehensive analysis structure covering:
Executive summary
Research context
Methodology analysis
Results evaluation
Practical and theoretical implications
Future research directions
Broader impacts
โ๏ธ Configuration
Configure through environment variables:
Variable | Purpose | Default |
| Paper storage location | ~/.arxiv-mcp-server/papers |
๐งช Testing
Run the test suite:
python -m pytest๐ License
Released under the MIT License. See the LICENSE file for details.
Made with โค๏ธ by the Pearl Labs Team
Available Tools
4 toolsdownload_paperC
Download a paper and create a resource for it
Inputs: paper_id (required), check_status.
list_papersA
List all existing papers available as resources
Inputs: no named parameters.
read_paperC
Read the full content of a stored paper in markdown format
Inputs: paper_id (required).
search_papersC
Search for papers on arXiv with advanced filtering
Inputs: query (required), max_results, date_from, date_to, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 4 tools
Each tool has a distinct and clear purpose: download_paper fetches new papers, list_papers shows existing resources, read_paper accesses stored content, and search_papers finds papers on arXiv. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern with snake_case (e.g., download_paper, list_papers, read_paper, search_papers). This uniformity enhances readability and predictability across the tool set.
With 4 tools, the count is appropriate for a focused arXiv server, covering core operations like search, download, list, and read. It's slightly lean but reasonable; adding tools for metadata management or updates could improve coverage without being excessive.
The tool set covers essential arXiv workflows: searching, downloading, listing, and reading papers. Minor gaps exist, such as lacking tools for updating or deleting stored papers, but agents can still perform key tasks effectively within the domain.
Related MCP Connectors
arXiv and OpenAlex/Crossref paper search (an open Google Scholar alternative) as agent tools.
Search arXiv, fetch paper metadata, and read full-text content.
Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.
Research paper search with real citations and reference formatting for AI assistants
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to search and access arXiv research papers through a simple Message Control Protocol interface, allowing for paper search, download, listing, and reading capabilities.47Apache 2.0
- AlicenseBqualityCmaintenanceProvides paper search, PDF link retrieval, and content parsing for arXiv research papers, enabling seamless access to scientific literature through the Model Context Protocol.441 npm24MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, retrieve, analyze, and export academic papers from arXiv.org using the Model Context Protocol.19MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to search, download, and access arXiv papers with local storage and date filtering via the Model Context Protocol.31Apache 2.0