Provides tools for searching and retrieving scientific papers from arXiv by keyword, author, category, or arXiv ID, returning metadata such as title, abstract, authors, dates, DOI, journal reference, and PDF links via the official arXiv API.
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 Research MCP Search arXiv for recent papers on 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.
A read-only, deployable MCP server for scientific literature research.
ChatGPT
↓ Streamable HTTP
arXiv Research MCP
↓ official Atom API
arXiv scientific papersThe server retrieves and normalizes metadata. ChatGPT remains responsible for explaining physics, comparing papers, and working through equations.
Tool | Use |
| General keyword or advanced arXiv search with paging and sorting |
| Complete metadata for one modern or legacy arXiv ID |
| Papers by a named author |
| Category search with optional keywords |
| Newest submissions in a category |
Every tool is marked read-only and returns typed structured data containing the arXiv ID, normalized title and abstract, authors, categories, dates, DOI, journal reference, abstract URL, and PDF URL when available.
Related MCP server: arXiv MCP Server
Requires Python 3.11 or newer.
py -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
Copy-Item .env.example .envEdit ARXIV_USER_AGENT in .env and replace the example contact with your
email or project URL. arXiv does not require an API key.
Run locally over stdio:
arxiv-mcpRun the remote-compatible transport locally:
arxiv-mcp --transport streamable-http --host 127.0.0.1 --port 8000The endpoints are:
http://127.0.0.1:8000/mcp
http://127.0.0.1:8000/healthFor a manual tool test, start the HTTP server, run the official MCP Inspector,
and connect it to http://127.0.0.1:8000/mcp:
npx @modelcontextprotocol/inspector@latestpytest
ruff check .Tests use mocked HTTP responses and do not consume the arXiv API. GitHub Actions runs the same checks on every push and pull request.
Fixed allowlisted upstream: https://export.arxiv.org/api/query
Three-second global request spacing by default
Bounded retries for timeouts, network failures, HTTP 429, and temporary 5xx responses
Strict result, offset, category, sort, and arXiv-ID validation
Safe XML parsing with external entities disabled
No shell execution, arbitrary URL fetching, secrets, write operations, or user-data storage
Stateless Streamable HTTP deployment
The repository includes a non-root Dockerfile and render.yaml Blueprint.
Push this repository to GitHub.
Sign in to Render and select New → Blueprint.
Connect the GitHub repository and apply render.yaml.
In the Render service environment, change ARXIV_USER_AGENT to include your
real contact email or repository URL.
Wait for /health to pass, then copy the service URL.
The final MCP URL is:
https://<your-render-service>.onrender.com/mcpThe Blueprint uses Render's free instance so deployment does not silently create
a billing commitment. Render documents that free services sleep after 15 minutes
of inactivity and can take about a minute to restart. That cold start can exceed
an MCP client's timeout; upgrade the service to starter or another paid instance
before relying on it as an always-available production connector. See the
Render free-tier limitations and
Blueprint reference.
These steps follow the current official OpenAI documentation:
Deploy the server and confirm the public HTTPS /mcp URL works in MCP Inspector.
In ChatGPT, open Settings → Security and login and enable Developer mode.
Open ChatGPT Plugins and select the plus button.
Enter:
Name: arXiv Research
Description: Read-only search and metadata retrieval from the official arXiv API.
Connection: public MCP endpoint
Server URL: https://<your-render-service>.onrender.com/mcp
Authentication: none
Create the connection and confirm that exactly five tools are discovered.
Start a new chat and add arXiv Research from the tools menu.
OpenAI currently requires a public HTTPS endpoint (or its Secure MCP Tunnel) and
Streamable HTTP, typically at /mcp. Developer-mode availability depends on the
account and workspace policy. OpenAI's current page does not promise it for every
named ChatGPT plan, so the presence of the Developer mode toggle on your account is
the authoritative check. If a Plus account does not show it, the server remains
usable through MCP Inspector, another MCP client, or the OpenAI API Playground.
See OpenAI's current connection guide
and MCP server guide.
Search arXiv for recent quantum gravity papers.
Find papers about the Bondi-Sachs formalism.
Search hep-th for path integral approaches to gravity.
Find papers by Roger Penrose related to general relativity.
Get the metadata and PDF link for arXiv:2401.12345.
.
├── src/arxiv_mcp/
│ ├── arxiv_client.py
│ ├── config.py
│ ├── models.py
│ └── server.py
├── tests/
├── .github/workflows/ci.yml
├── .env.example
├── Dockerfile
├── render.yaml
├── pyproject.toml
└── README.mdMIT licensed.
Retrieve complete metadata for one known arXiv ID, including abstract, DOI, journal reference, categories, and PDF link.
Inputs: arxiv_id (required). Returns: Normalized metadata for one arXiv paper.
Return the most recently submitted papers in one arXiv category. Use for current literature scans and research updates.
Inputs: category (required), max_results. Returns: A page of arXiv search results.
Search the official arXiv index by keywords or advanced arXiv query syntax. Use this for general paper discovery and pagination.
Inputs: query (required), start, sort_by, sort_order, +1 more. Returns: A page of arXiv search results.
Find arXiv papers written by a named author. Use this when the author is the main search constraint.
Inputs: author_name (required), max_results. Returns: A page of arXiv search results.
Search within one arXiv subject category, optionally narrowed by keywords. Use for fields such as gr-qc, hep-th, quant-ph, math-ph, or astro-ph.CO.
Inputs: category (required), keywords, max_results. Returns: A page of arXiv search results.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool has a clearly distinct purpose: general search, specific paper retrieval, author search, category search, and recent papers. No two tools overlap in function; the specialized search tools are properly scoped with explicit use cases, and get_recent_arxiv_papers is differentiated from search_arxiv_by_category by focusing on recency rather than keyword filtering.
All tool names follow a consistent verb_noun pattern, with 'search_' for discovery operations and 'get_' for retrieval. The pattern is uniform despite minor semantic differences (e.g., 'search_arxiv' vs 'search_arxiv_by_author' vs 'get_recent_arxiv_papers'), and the naming makes the action and target obvious.
Five tools is an ideal scope for an arXiv research client. Each tool provides a distinct capability that covers the primary use cases of paper discovery and metadata retrieval without unnecessary bloat. The count feels intentional and well-balanced for the server's stated purpose.
The tool surface covers the core arXiv workflows: general search, targeted searches by author and category, retrieval by ID, and recent-paper scans. The only minor gaps are non-essential features like citation lookup or category listing, but these are not critical for the server's purpose and can be worked around with existing tools (e.g., using search_arxiv for category keywords).
Find research papers and arXiv preprints, and get an abstract and free full text from a DOI or id.
Search arXiv, fetch paper metadata, and read full-text content.
Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.
Pay-per-call x402 arXiv paper search, metadata, abstracts, and category listings.