Skills and MCP configuration for using arx to inspect, fetch, and search locally cached arXiv papers.
- GitHub stars
- 7
Install
/plugin install arx@arxRun it inside Claude Code after adding the marketplace with /plugin marketplace add eric-tramel/arx.
Contents
Discovered from sourceSkills 3
arx-full-text-search
Use this skill when a user asks to find claims, methods, citations, definitions, equations, related work, or other text inside papers already cached by arx.
Workflow
- Use
lookup_arxiv_papersfirst when the user names a specific paper and you do not know whether it is cached. - Call
full_text_searchwith concise keyword-style queries. It searches cached local material only and never contacts arXiv. - Use
arxiv_idwhen the user wants results from one paper. Omit it when the user wants to search across the local arx index. - Choose the narrowest useful scope:
defaultor omitted searches title, metadata, and body text, excluding bibliography.titlessearches paper titles only.bibliographysearches citation records and.bibor.bblmaterial only.allsearches everything.
- Read the returned snippets, scores, source paths, and line ranges. Use them as grounded evidence and cite the paper ids or file locations in your answer when helpful.
Notes
- Empty results may include a
notethat explains whether the paper is uncached, metadata-only, or missing bibliography/body material. - If the paper is missing source or body text, use
arx-paper-fetchto queue the needed material before retrying. - Prefer a few targeted searches over one broad natural-language question.
arx-paper-fetch
Use this skill when a user wants a paper added to the local arx cache, needs PDF or TeX source material, or needs to know how arx downloading works.
Workflow
- Start with
lookup_arxiv_papersfor the target ids. Confirm which material is already cached and which material is missing. - Call
fetch_arxiv_paperonly for missing material that is actually needed. It queues work througharxdand returns immediately with a job id. - Tell the user that queued work runs in the background. Do not assume the PDF or source is ready until the queue says so.
- Call
get_arxiv_download_queue_statuswith the returnedjob_idto inspect one job, or withinclude_finished: trueto see completed and failed jobs afterarxdexits. - After a completed download, use
lookup_arxiv_papersagain to refresh readiness, then usefull_text_searchwhen the task requires paper text.
Notes
arxdenforces the shared arXiv request delay across CLI and MCP clients.- Finished job records are durable across
arxdrestarts, soinclude_finished: trueis the reliable default for follow-up checks. - Do not queue downloads when metadata is enough for the user's task.
- If a job fails, report the failure reason from the queue status and avoid retry loops unless the user asks.
arx-paper-metadata
Use this skill when a user asks about one or more arXiv papers and you need the paper identity, abstract, metadata, local cache state, or the best next arx action.
Workflow
- Normalize the user-provided arXiv ids before calling tools. Preserve version suffixes only when the user explicitly asks for a specific version.
- Call
lookup_arxiv_papersfirst. It returns metadata, abstract text, local material readiness, cache paths, and per-paper errors. - Treat the lookup result as the source of truth for whether metadata, PDF, source, and index material are already present locally.
- If the user asked for a no-network check, pass
fetch_missing_metadata: false. Otherwise,lookup_arxiv_papersmay fetch missing metadata but never downloads PDFs or source archives. - Use the returned
next_toolor readiness fields to decide whether to search cached text or queue a download.
Notes
- Batch related paper ids in one
lookup_arxiv_paperscall. - Cached metadata should still be used when a network refresh fails.
- Do not call
fetch_arxiv_paperjust to inspect metadata. - Report per-paper lookup errors separately instead of treating a partial batch failure as a total failure.
MCP servers 1
Sponsors
Details
- Marketplace
- eric-tramel/arx
- Source
- plugins/arx
- Author
- Eric Tramel
- Category
- Developer Tools
- License
- MIT
