Paper Search MCP is a Python tool and Model Context Protocol server for finding, downloading, and extracting text from academic papers across multiple sources. Researchers and AI-driven workflows use it through MCP clients or its command-line interface, with open sources prioritized and optional API keys supported. The catalogue skill provides a way to use the project from a coding-agent workflow.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/openags/paper-search-mcp/claude-codenpx skills add openags/paper-search-mcp --skill claude-codegit clone --depth 1 https://github.com/openags/paper-search-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/openags/paper-search-mcp/claude-code)<a href="https://agentmods.dev/skills/openags/paper-search-mcp/claude-code"><img src="https://agentmods.dev/badge/skills/openags/paper-search-mcp/claude-code.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00062 | $0.00525 |
| Opus 5 | $0.00031 | $0.00262 |
| Sonnet 5 | $0.00012 | $0.00105 |
| Haiku 4.5 | $0.00006 | $0.00052 |
Grade A, and why
paper-search scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
1 near-identical copy found in the catalogue:
- paper-search — 100% identical, 0 lines differ
What it actually says
Paper Search
Search, download, and read academic papers via the paper-search CLI.
CLI Usage
All commands run via:
paper-search <command> [args]
If paper-search is not available, install it with uv tool install paper-search-mcp. Optional API keys can be configured in ~/.config/paper-search-mcp/.env.
Search
paper-search search "<query>" -n <max_per_source> -s <sources> -y <year>
-n: results per source (default: 5)-s: comma-separated sources or "all" (default: all)-y: year filter for Semantic Scholar (e.g. "2020", "2018-2022")
For speed, prefer targeted sources (-s arxiv,semantic,crossref) over "all" unless broad coverage is needed.
Download PDF
paper-search download <source> <paper_id> [-o ./downloads]
Read (extract text)
paper-search read <source> <paper_id> [-o ./downloads]
List sources
paper-search sources
Output
search and download return JSON. read returns plain text. Config warnings go to stderr and can be ignored.
Sources
arxiv, pubmed, biorxiv, medrxiv, google_scholar, iacr, semantic, crossref, openalex, pmc, core, europepmc, dblp, openaire, citeseerx, doaj, base, zenodo, hal, ssrn, unpaywall
Optional (env vars): ieee (IEEE_API_KEY), acm (ACM_API_KEY)
Workflow
- Search with targeted sources to find papers
- Present results as a table: title, authors, year, source, DOI/URL
- If the user wants full text, use
read <source> <paper_id> - If the user wants the PDF, use
download <source> <paper_id>and report the saved path
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 60 lines · 62 tokens per session scan A affddf3a4dc4
paper-search is a skill published in the GitHub repository openags/paper-search-mcp (2,564 stars, last pushed 19d ago), licensed MIT. It adds 62 tokens to every session and 525 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
imaging-data-commons
Query and download public cancer imaging data from NCI Imaging Data Commons. Invoke for any question about IDC collections, cancer imaging datasets, DICOM data access, radiology (CT, MR, PET) or pathology AI training sets, metadata queries, visualization, or license checks — even when the user doesn't explicitly…
lab-hardware-cad
Design custom laboratory hardware as parametric build123d models and export fabrication-ready STEP, STL, and DXF files - microfluidic chips and molds, optomechanical mounts and breadboard adapters, cuvette and microplate holders, tube racks, animal-behavior rigs, and 3D-printed instrument fixtures. Use when a research…
onekgpd
Query the 1000 Genomes Project dataset (3,202 whole-genome-sequenced individuals, GRCh38) at the level of individual participants. Use when a question is about individuals or variants in the 1000 Genomes Project cohort: which individuals carry variants matching specific criteria in a gene or region, which individuals…
pkpd-modeling
Pharmacokinetic and pharmacodynamic modelling and simulation - non-compartmental analysis, compartmental and population PK, PK/PD and exposure-response, TMDD, PBPK orientation, bioequivalence, allometric scaling and first-in-human dose, drug interaction prediction, and Bayesian therapeutic drug monitoring. Use when…
statistical-analysis
Guided statistical analysis for research data - test selection, assumption checking, effect sizes, power analysis, Bayesian alternatives, and APA-formatted reporting. Use whenever a user wants to compare groups, test a hypothesis, analyze experimental or survey data, check statistical assumptions, compute required…
analytical-method-validation
Plan, execute, and document validation, verification, and transfer of analytical procedures under the governing framework - ICH Q2(R2) and Q14, USP / / , ICH M10 bioanalytical, CLSI EP, or ISO/IEC 17025. Use for HPLC, LC-MS/MS, GC, CE, ICP-MS, dissolution, qNMR, qPCR, NIR, and ligand binding or cell-based assays…