Search arXiv for papers on a topic and download any result as a PDF. Talks to the public arXiv API; no account or API key needed.
The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.
search
Search arXiv for papers matching a query and return title, authors, id, PDF link and summary for each match.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
query |
string | required | |
max_results |
int |
optional, default 10
|
| Name | Type | Notes |
|---|---|---|
papers |
json | |
count |
int |
download
Download one paper's PDF into a folder, given its arXiv id or an arxiv.org URL (abs or pdf link).
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
id_or_url |
string | required | |
out_dir |
path | required | |
filename |
string |
optional, default ""
|
| Name | Type | Notes |
|---|---|---|
file |
path | |
skipped |
bool | |
bytes |
int |
python app.py --action search --params '{"query": "<query>"}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("arxiv-fetcher", "search", {"query": "<query>"}){
"id": "n0",
"app": "arxiv-fetcher",
"action": "search",
"params": {
"query": "<query>"
},
"inputs": {}
}python app.py --action download --params '{"id_or_url": "<id_or_url>", "out_dir": "D:/path/to/out_dir"}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("arxiv-fetcher", "download", {"id_or_url": "<id_or_url>", "out_dir": "D:/path/to/out_dir"}){
"id": "n0",
"app": "arxiv-fetcher",
"action": "download",
"params": {
"id_or_url": "<id_or_url>",
"out_dir": "D:/path/to/out_dir"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.