Provides search functionality for arXiv.org papers using the official arXiv API, allowing filtering by terms, subject categories, date ranges, and returning comprehensive paper metadata including PDF links.
Returns DOI information for papers when available in the search results, linking to the official publication.
The server is available as a package on PyPI, with badges showing version and Python support information.
Uses Shields.io for displaying status badges in the README.
arXiv Search MCP Server
An MCP (Model Context Protocol) server that provides search functionality for arXiv.org papers using the official arXiv API.
Features
- Search by terms: Search papers by keywords in titles, abstracts, and content
- Subject filtering: Filter results by arXiv subject categories (physics, cs, math, etc.)
- Date range filtering: Filter papers by submission date range
- Configurable results: Control the number of results returned (max 2000)
- PDF URLs included: Direct links to paper PDFs for easy access
- Comprehensive metadata: Author names, abstracts, categories, publication dates, and more
Installation
From PyPI (Recommended)
From Source
- Clone the repository:
- Install the package:
Usage
Running the Server
As a CLI command (after pip install)
As a Python module
From source
Available Tools
1. search_arxiv_papers
Search for papers on arXiv with various filtering options.
Parameters:
terms
(required): Search terms to look for in paper titles, abstracts, and contentsubject
(optional): Subject category to filter by (see available categories below)start_date
(optional): Start date for filtering papers in YYYY-MM-DD formatend_date
(optional): End date for filtering papers in YYYY-MM-DD formatmax_results
(optional): Maximum number of results to return (default: 10, max: 2000)
Example:
2. get_subject_categories
Get a list of available subject categories for filtering.
Returns: Dictionary of category codes and their descriptions.
Available Subject Categories
physics
- Physics (general)astro-ph
- Astrophysicscond-mat
- Condensed Matter Physicsgr-qc
- General Relativity and Quantum Cosmologyhep-ex
- High Energy Physics - Experimenthep-lat
- High Energy Physics - Latticehep-ph
- High Energy Physics - Phenomenologyhep-th
- High Energy Physics - Theorymath-ph
- Mathematical Physicsnlin
- Nonlinear Sciencesnucl-ex
- Nuclear Experimentnucl-th
- Nuclear Theoryquant-ph
- Quantum Physicsmath
- Mathematicscs
- Computer Scienceecon
- Economicseess
- Electrical Engineering and Systems Sciencestat
- Statisticsq-bio
- Quantitative Biologyq-fin
- Quantitative Finance
Response Format
Search results include the following information for each paper:
API Limits
- Maximum 2000 results per request (arXiv API limitation)
- Rate limiting: Please be respectful with API calls (arXiv recommends 3-second delays between requests for bulk operations)
- Results are returned by relevance by default
Error Handling
The server handles various error conditions:
- Invalid search parameters
- Network connectivity issues
- arXiv API errors
- Malformed responses
Errors are returned in a structured format with descriptive messages.
Dependencies
fastmcp
- MCP server frameworkrequests
- HTTP client for arXiv API callsfeedparser
- Atom/RSS feed parsingurllib3
- URL handling utilities
License
This project follows the arXiv API Terms of Use. Please respect arXiv's resources and use the API responsibly.
This server cannot be installed
Provides search functionality for arXiv.org papers through the official arXiv API, allowing users to search papers by keywords, filter by subject categories and date ranges, and receive comprehensive metadata including PDF links.
Related MCP Servers
- AsecurityAlicenseAqualityEnables users to search for academic articles on platforms like arXiv using specific keywords, with plans to integrate more scholarly databases in the future.Last updated -2118PythonMIT License
- AsecurityAlicenseAqualityEnables real-time search and retrieval of academic paper information from multiple sources, providing access to paper metadata, abstracts, and full-text content when available, with structured data responses for integration with AI models that support tool/function calling.Last updated -311PythonAGPL 3.0
- AsecurityAlicenseAqualityEnables 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.Last updated -41PythonApache 2.0
- -securityAlicense-qualityEnables AI assistants to search, download, and read arXiv research papers through a Message Control Protocol interface, with support for paper filtering and local storage.Last updated -Apache 2.0