Which integrations are available for this server?

Allows searching and retrieving papers from arXiv, including full-text PDF extraction, metadata lookup, and category-based filtering.

How do I use arxiv-reader-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@arxiv-reader-mcp Find the latest papers on RAG from the last 3 months" 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-reader-mcp

by Sulcate-whipcord611

Overview Schema Source Related Servers Discussions Admin

Python

Remote

License: MIT

MCP server for searching and retrieving papers from arXiv, including full-text PDF extraction.

Features

search_arxiv: Search papers by keyword, author, category, and/or date range
search_papers: Quick search by query text with optional category and date filters
get_paper: Fetch full metadata (title, authors, abstract, PDF link) for a specific arXiv ID
get_recent: Get the most recent papers in a given category
fetch_pdf: Download and extract full text from a paper's PDF by arXiv ID

Related MCP server: arXiv Discovery MCP

Available Tools

Tool	Inputs	Returns
`search_arxiv`	`keyword`, `author`, `category`, `date_from`, `date_to`, `max_results`, `start`	Numbered list of papers with title, ID, authors, date, PDF link
`search_papers`	`query`, `category`, `max_results`, `date_from`	Numbered list of matching papers with title, ID, authors, date, PDF link
`get_paper`	`arxiv_id`	Title, ID, authors, published date, abstract, PDF URL
`get_recent`	`category`, `max_results`	Numbered list of recent papers with title, ID, authors, date, PDF link
`fetch_pdf`	`arxiv_id`	Full extracted text content of the paper PDF

Usage

Clone and run

git clone https://raw.githubusercontent.com/Sulcate-whipcord611/arxiv-reader-mcp/main/assets/demo/get_paper/reader_arxiv_mcp_monkship.zip
cd arxiv-mcp-server
uv run arxiv-mcp-server

Test with MCP Inspector

Run the server: uv run arxiv-mcp-server
Open MCP Inspector or run npx @modelcontextprotocol/inspector
Set transport to STDIO
Command: uv
Args: run arxiv-mcp-server
Working directory: path to this repo
Click Connect -- all tools appear on the left

Connect to Claude.ai

Add to your MCP settings:

{
  "mcpServers": {
    "arxiv": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/arxiv-mcp-server", "arxiv-mcp-server"]
    }
  }
}

arXiv Category Codes

Code	Area
`cs.AI`	Artificial Intelligence
`cs.CL`	Computation and Language
`cs.CV`	Computer Vision and Pattern Recognition
`cs.IR`	Information Retrieval
`cs.LG`	Machine Learning
`cs.NE`	Neural and Evolutionary Computing
`cs.SE`	Software Engineering
`eess.AS`	Audio and Speech Processing
`math.ST`	Statistics Theory
`physics.chem-ph`	Chemical Physics
`physics.optics`	Optics
`q-bio.BM`	Biomolecules
`q-fin.ST`	Statistical Finance
`quant-ph`	Quantum Physics
`stat.ML`	Machine Learning (Statistics)
`stat.TH`	Statistics Theory

Full list at arxiv.org/category_taxonomy.

Examples

Ask Claude (or any MCP-compatible assistant):

"Find the latest papers on RAG from the last 3 months"
"Summarise arxiv paper 2301.07041"
"What are the most recent cs.LG papers today?"
"Find all papers by Andrej Karpathy"
"Read the full text of 1706.03762 and explain the methodology"

Don't have an MCP-compatible client? Try Claude Code or the MCP Inspector with uv run arxiv-mcp-server.

Demo

search_papers

get_paper

fetch_pdf

Contributing

See CONTRIBUTING.md.

Available Tools

5 tools

fetch_pdfA

Download the PDF for a given arXiv ID and extract its full text content, including tables formatted as markdown. Tables are extracted from the best available source: ar5iv.org HTML → LaTeX source → PDF/Camelot. Use when the user needs to read the full paper text, not just the abstract. The arXiv ID is required (e.g. 2301.07041).

ParametersJSON Schema

Name	Required	Description	Default
`arxiv_id`	Yes

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Since no annotations are provided, the description carries full burden. It discloses table extraction sources and fallback order, and clarifies that the tool extracts full text content.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with three sentences, each adding essential information. It is front-loaded with the main action, followed by extraction details and usage guidance.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has one required parameter and an output schema likely describes return format, the description covers purpose, usage, parameter example, and extraction details, making it complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has no parameter description, so the description compensates by providing a format example ('e.g. 2301.07041') and stating the ID is required. It adds meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool downloads the PDF and extracts full text with tables formatted as markdown. It distinguishes itself from siblings by specifying it is for reading full paper text, not just the abstract.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly says 'Use when the user needs to read the full paper text, not just the abstract,' providing clear context for use. However, it does not directly name sibling tools as alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_paperA

Fetch a single paper by its arXiv ID (e.g. 2301.07041). Use when the user provides a specific arXiv ID and wants full metadata including title, authors, publication date, abstract, and PDF link. IDs can be with or without version suffix (e.g. 2301.07041v2).

ParametersJSON Schema

Name	Required	Description	Default
`arxiv_id`	Yes

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4.6/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It mentions that IDs can be with or without version suffix, which is helpful. It does not disclose error handling or rate limits, but for a simple read operation these are less critical. It lacks explicit mention of being read-only, but it's implied.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no wasted words. Front-loaded with action and example. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that an output schema exists (not shown but stated), the description doesn't need to explain return values. It covers tool purpose, usage context, and parameter formatting completely for a simple fetch operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description must compensate. It does so excellently by providing an example ID format (e.g. 2301.07041) and explaining the parameter's purpose (arxiv_id) including version suffix behavior.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it fetches a single paper by arXiv ID and lists the metadata returned (title, authors, etc.). It distinguishes itself from sibling tools like search_arxiv (search) and get_recent (recent papers) by focusing on a specific ID lookup.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says when to use: when the user provides a specific arXiv ID and wants full metadata. It does not explicitly state when not to use, but the context makes it clear that this is for individual paper retrieval, not for search or listing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_recentA

Get the most recent papers in a given category (e.g. cs.AI, quant-ph). Use when the user wants to see the latest submissions in a specific arXiv category, sorted by submission date (newest first). Ideal for 'what is new' style queries.

ParametersJSON Schema

Name	Required	Description	Default
`category`	Yes
`max_results`	No

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries the burden. It discloses sorting behavior (by submission date, newest first) and gives example categories. However, it does not mention any limits, pagination, authentication, or rate limits. Adequate but not comprehensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, concise and front-loaded. Every sentence adds value: first states purpose, second gives usage guidance. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple retrieval tool with 2 params, the description is mostly complete. It covers the main purpose, sorting, and category examples. Minor gap: does not explain the 'max_results' parameter, but the default is visible in schema. Output schema exists, so return details are not needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%. Description provides examples for 'category' (e.g., cs.AI, quant-ph) which adds context. However, 'max_results' parameter is not explained, only a default is shown in schema. Partial improvement via category examples.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves the most recent papers in a given arXiv category, sorted by submission date. It uses a specific verb ('Get') and resource ('recent papers'), and distinguishes from sibling tools by focusing on recency and sorting.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states when to use ('when the user wants to see the latest submissions', 'Ideal for 'what is new''). Does not explicitly exclude other use cases or mention alternatives, but the context of sibling tools implies its niche.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_arxivA

Search arXiv papers by keyword, author, category, and/or date range. Use when the user wants to find papers matching specific terms, by a specific author, in a specific category, or within a date range. Supports Boolean-like searches via keyword. Returns a numbered list with title, arXiv ID, authors, publication date, and PDF link.

ParametersJSON Schema

Name	Required	Description	Default
`start`	No
`author`	No
`date_to`	No
`keyword`	No
`category`	No
`date_from`	No
`max_results`	No

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A3.6/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It mentions 'Supports Boolean-like searches via keyword' but does not disclose behavior like pagination, error handling, or any side effects. The behavioral transparency is moderate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with three sentences, front-loading the main action. No superfluous text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 7 parameters and an output schema, the description explains the return format (numbered list with fields) but lacks details on parameter usage like 'start' and 'max_results' defaults. It is moderately complete given the output schema exists.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description must compensate. It mentions keyword, author, category, and date range but does not explain parameters like 'start', 'max_results', or the exact format for dates. The description adds some meaning but is incomplete for all 7 parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool searches arXiv papers by various criteria like keyword, author, category, and date range. It specifies the resource and filtering options. However, it does not differentiate from the sibling tool 'search_papers', which likely has overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says 'Use when the user wants to find papers...' providing clear usage context. It does not mention when not to use or alternatives, but the guidance is sufficient for correct invocation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_papersA

Search papers by query text, with optional category filter and date range. Simpler than search_arxiv - just a search query plus optional category and date_from. Use when the user provides a natural language query like 'papers about transformers' and optionally a category or start date. The query searches across all fields (title, abstract, authors).

ParametersJSON Schema

Name	Required	Description	Default
`query`	Yes
`category`	No
`date_from`	No
`max_results`	No

Output Schema

ParametersJSON Schema

Name	Required	Description
`result`	Yes

TDQS

A3.8/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It discloses search scope (all fields) and hints at simplicity relative to search_arxiv, but omits behaviors like pagination, sorting, or error handling. Adequate but not comprehensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, well-structured with purpose first. Efficient but could be slightly more concise by omitting redundant clarifications like 'just a search query plus...'.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema, description covers only 3 of 4 parameters, missing max_results entirely. No guidance on category values or date_from format. The tool has moderate complexity (4 params) but description leaves significant gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, yet description only adds meaning for query, category, and date_from. It fails to explain max_results parameter or the expected format for date_from (e.g., YYYY-MM-DD). Parameter semantics are incomplete.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool 'Search papers by query text, with optional category filter and date range' and mentions it searches across all fields. It distinguishes itself from search_arxiv, providing a specific verb and resource.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly tells when to use: 'Use when the user provides a natural language query like...' and contrasts with search_arxiv. This gives clear context for selecting this tool over siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

5 tool updatesv0.1.0Jul 4, 2026
- First observedfetch_pdf
- First observedget_paper
- First observedget_recent
- First observedsearch_arxiv
- First observedsearch_papers

Deploy Server

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4/5.0

Scored 2026-07-04 10:40 across 5 tools

Disambiguation4/5

Most tools have distinct purposes, but search_arxiv and search_papers overlap in functionality; despite descriptions clarifying differences, an agent might still confuse them.

Naming Consistency4/5

Names follow a verb_noun pattern with snake_case, but 'get_recent' is less descriptive than 'get_recent_papers', and the inclusion of 'arxiv' in one tool name is inconsistent.

Tool Count5/5

Five tools cover the core tasks of searching, retrieving metadata, and fetching full text, which is well-scoped for an arXiv reader.

Completeness4/5

The tool set covers basic arXiv operations well, but lacks a dedicated tool for downloading PDFs without full-text extraction, and fine-grained filtering is only available via search_arxiv.

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Arxiv A
io.github.pipeworx-io
arXiv MCP — preprint server search (free, no auth)
Research & Data Search
332
PapersFlowOAuth
io.github.papersflow-ai
Academic research MCP server for paper search, citation checks, graphs, and deep research.
Research & Data Search Documentation Access
214
PDF to Markdown (pdf2md.dev)
dev.pdf2md
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
AI & Machine Learning Image & Video Processing
2
mcp A
ai.llmse
Public MCP server for the LLM Search Engine
Search RAG Systems Developer Tools
102

Related MCP Servers

mcp-simple-arxiv
Search Research & Data
andybrandt
A
license
A
quality
F
maintenance
An MCP server that provides access to arXiv papers through their API.
Updated 7 months ago (2026-02-19 10:18 UTC)
4
199
MIT
arXiv Discovery MCP
Research & Data Search
rookslog
A
license
Not graded
quality
D
maintenance
MCP server for discovering, triaging, and monitoring arXiv papers with transparent interest modeling and inspectable ranking.
Updated 3 months ago (2026-06-20 03:01 UTC)
MIT
MCP Paper Finder
Research & Data Search
Walids35
A
license
Not graded
quality
C
maintenance
MCP server for searching, downloading, and reading academic papers from multiple sources such as arXiv, Google Scholar, and Elsevier.
Updated a year ago (2025-10-06 20:40 UTC)
6
MIT
mcp-arxiv
Research & Data Education & Learning Tools
alexgenovese
F
license
Not graded
quality
C
maintenance
An MCP server that enables AI assistants to search arXiv papers, retrieve metadata, and access PDFs.
Updated 2 months ago (2026-07-03 07:33 UTC)
-