ArXiv Sync MCP Server
Allows searching arXiv papers with filters for date ranges and categories, downloading and converting papers to markdown, listing downloaded papers, and analyzing papers using research prompts.
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 Sync MCP Server search for machine learning papers from last month"
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 Sync MCP Server
๐ Enable AI assistants to search and access arXiv papers through a simple MCP interface.
๐ About This Fork
This is a fork of the original arxiv-mcp-server by Joseph Blazick.
Why This Fork?
This fork simplifies the architecture and fixes issues found in the original:
Feature | Original | This Fork |
Download method | Async background conversion | Synchronous download & conversion |
API calls | Multiple (download โ poll status โ read) | Single call returns content |
Status tracking | Required | Not needed |
PDF cleanup | Manual | Automatic after conversion |
Date filtering | Buggy | Fixed |
Complexity | Higher | Simpler |
Key improvements:
The
get_paper_contenttool now downloads, converts PDF to markdown, and returns the content in a single callDate filtering in
search_papersnow works correctly:Uses direct HTTP requests to arXiv API to bypass encoding issues with the Python arxiv library
Properly formats date ranges in arXiv's
submittedDate:[YYYYMMDD0000+TO+YYYYMMDD2359]formatCorrectly combines date filters with category and query filters using AND operators
The ArXiv Sync 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 programmatically.
Related MCP server: ArXiv MCP Server
โจ 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
๐ Quick Start
This fork is distributed via GitHub and is not published to PyPI.
Installing Manually
Install using uv:
uv tool install git+https://github.com/marfago/arxiv-sync-mcp-server.gitFor development:
# Clone and set up development environment
git clone https://github.com/marfago/arxiv-sync-mcp-server.git
cd arxiv-sync-mcp-server
# Create and activate virtual environment
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install with test dependencies
uv pip install -e ".[test]"๐ MCP Integration
Add this configuration to your MCP client config file:
{
"mcpServers": {
"arxiv-sync-mcp-server": {
"command": "uv",
"args": [
"tool",
"run",
"--from",
"git+https://github.com/marfago/arxiv-sync-mcp-server.git",
"arxiv-sync-mcp-server",
"--storage-path", "/path/to/paper/storage"
]
}
}
}For Development:
{
"mcpServers": {
"arxiv-sync-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/cloned/arxiv-sync-mcp-server",
"run",
"arxiv-sync-mcp-server",
"--storage-path", "/path/to/paper/storage"
]
}
}
}๐ก Available Tools
The server provides three simple 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. Get Paper Content
Get the full content of a paper, downloading and converting it if necessary:
result = await call_tool("get_paper_content", {
"paper_id": "2401.12345"
})3. List Papers
View all downloaded papers:
result = await call_tool("list_papers", {})๐ 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 (get_paper_content, search_papers, list_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-sync-mcp-server/papers |
๐งช Testing
Run the test suite:
python -m pytest๐ License
Released under the Apache 2.0 License. See the LICENSE file for details.
Fork of arxiv-mcp-server by Joseph Blazick
Originally made with โค๏ธ
Available Tools
3 toolsget_paper_contentA
Get the full content of a paper, downloading and converting it if necessary
Inputs: paper_id (required).
list_papersA
List all existing papers available as resources
Inputs: no named parameters.
search_papersA
Search for papers on arXiv with advanced filtering and query optimization.
QUERY CONSTRUCTION GUIDELINES:
Use QUOTED PHRASES for exact matches: "multi-agent systems", "neural networks", "machine learning"
Combine related concepts with OR: "AI agents" OR "software agents" OR "intelligent agents"
Use field-specific searches for precision:
ti:"exact title phrase" - search in titles only
au:"author name" - search by author
abs:"keyword" - search in abstracts only
Use ANDNOT to exclude unwanted results: "machine learning" ANDNOT "survey"
For best results, use 2-4 core concepts rather than long keyword lists
ADVANCED SEARCH PATTERNS:
Field + phrase: ti:"transformer architecture" for papers with exact title phrase
Multiple fields: au:"Smith" AND ti:"quantum" for author Smith's quantum papers
Exclusions: "deep learning" ANDNOT ("survey" OR "review") to exclude survey papers
Broad + narrow: "artificial intelligence" AND (robotics OR "computer vision")
CATEGORY FILTERING (highly recommended for relevance):
cs.AI: Artificial Intelligence
cs.MA: Multi-Agent Systems
cs.LG: Machine Learning
cs.CL: Computation and Language (NLP)
cs.CV: Computer Vision
cs.RO: Robotics
cs.HC: Human-Computer Interaction
cs.CR: Cryptography and Security
cs.DB: Databases
EXAMPLES OF EFFECTIVE QUERIES:
ti:"reinforcement learning" with categories: ["cs.LG", "cs.AI"] - for RL papers by title
au:"Hinton" AND "deep learning" with categories: ["cs.LG"] - for Hinton's deep learning work
"multi-agent" ANDNOT "survey" with categories: ["cs.MA"] - exclude survey papers
abs:"transformer" AND ti:"attention" with categories: ["cs.CL"] - attention papers with transformer abstracts
DATE FILTERING: Use YYYY-MM-DD format for historical research:
date_to: "2015-12-31" - for foundational/classic work (pre-2016)
date_from: "2020-01-01" - for recent developments (post-2020)
Both together for specific time periods
RESULT QUALITY: Results sorted by RELEVANCE (most relevant papers first), not just newest papers. This ensures you get the most pertinent results regardless of publication date.
TIPS FOR FOUNDATIONAL RESEARCH:
Use date_to: "2010-12-31" to find classic papers on BDI, SOAR, ACT-R
Combine with field searches: ti:"BDI" AND abs:"belief desire intention"
Try author searches: au:"Rao" AND "BDI" for Anand Rao's foundational BDI work
Inputs: query (required), max_results, date_from, date_to, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 3 tools
Each tool has a distinct purpose: listing, searching, and getting full content. There is no overlap or ambiguity between them.
All tool names follow a consistent 'verb_noun' pattern in snake_case, making the set predictable and easy to understand.
With 3 tools, the server is well-scoped for its purpose of syncing and retrieving arXiv papers. Each tool is necessary and sufficient.
The set covers listing, searching, and fetching content. Missing tools for updating or deleting are minor gaps given the sync context, but the core functionality is complete.
Related MCP Connectors
arXiv and OpenAlex/Crossref paper search (an open Google Scholar alternative) as agent tools.
Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.
Search arXiv, fetch paper metadata, and read full-text content.
Research paper search with real citations and reference formatting for AI assistants
Related MCP Servers
- AlicenseBqualityCmaintenanceProvides paper search, PDF link retrieval, and content parsing for arXiv research papers, enabling seamless access to scientific literature through the Model Context Protocol.438 npm24MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to search and access arXiv papers through a Model Context Protocol interface, allowing for paper search, download, listing, and reading functionality.42Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, retrieve, analyze, and export academic papers from arXiv.org using the Model Context Protocol.19MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and retrieving arXiv papers via the Model Context Protocol, providing tools for querying, structured search, and literature review prompts.MIT