arxiv-research

arXiv research

You have an arxiv MCP server for interacting with arXiv. Use its tools instead of web-scraping arxiv.org. The server handles rate-limiting, caching, and text extraction for you — your job is to query well and read economically.

Core workflow

1. Open a session for any multi-step task: start_session(session_id="<task-slug>"). Pass that same session_id to every subsequent call. This pins fetched papers so nothing refetches across your calls, and protects them from cache eviction mid-task. Call end_session when done.
2. Search with search_papers to discover candidates.
3. Read with read_paper (paginated) when you need a paper's contents.
4. Download with download_paper only if the user wants the raw file.

search_papers — construct good queries

Prefer the structured shortcuts (they're AND-combined and escaped for you):

• category="cs.LG" → cat:cs.LG (use list_categories to find valid codes)
• author="Yann LeCun" → quoted author match
• title="attention is all you need" → title phrase
• abstract="retrieval augmented" → abstract phrase

For anything more complex, pass a raw query in arXiv field syntax:

• Fields: ti: au: abs: cat: co: jr: all:
• Booleans: AND OR ANDNOT (it is ANDNOT, never NOT)
• Phrase: ti:"quantum criticality"
• Example: query='au:hinton AND cat:cs.LG ANDNOT ti:"reinforcement learning"'

Sorting & paging:

• sort_by: relevance (default), submittedDate (newest research), lastUpdatedDate. sort_order: descending/ascending.
• "Latest N papers on X" → sort_by="submittedDate", sort_order="descending".
• max_results ≤ 2000 per call; page deeper with start (total window 30000).
• Read total_results to decide whether to page further.

Keep max_results small (10–25) unless the user asked for a broad sweep — it's faster and kinder to arXiv.

get_paper — one id, full metadata

get_paper(paper_id="2401.12345"). Accepts any id form: bare, arXiv: prefix, arxiv.org/abs/... URL, old-style hep-th/9901001, or a 10.48550/arXiv... DOI. Served from cache when possible.