paper-download-mcp
Enables downloading scholarly papers via Elsevier's Article Retrieval API, including probing availability, fetching PDFs to a temporary staging area, and verifying the resulting artifacts.
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., "@paper-download-mcp probe DOI 10.3390/su15108123 with hint mdpi"
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.
paper-download-mcp
General-purpose paper downloader MCP: probes providers by DOI/UT identifier, downloads to a short-lived staging area, verifies the PDF, and cleans up. It does not connect to PostgreSQL, does not accept project/output_dir/year/publisher/filename, and does not manage final storage—those are the responsibility of the calling project (e.g., the HC integration side).
Architecture (converged 2026-07-22)
MCP (通用获取器) 调用项目集成侧
health 任务规划与项目筛选
list_providers 最终存储与资产登记
probe(identifier, hint?) 批量编排与限速
fetch(identifier, hint?) → artifact 下载审计
verify_artifact(id) 项目级状态管理
discard_artifact(id)Related MCP server: acatome-quest-mcp
Tools (6)
Tool | Description |
| Version/staging directory/provider availability (does not echo keys) |
| Lists providers and their status |
| Probes whether a provider can fetch a given identifier |
| Downloads to staging, returns artifact_id (does not accept project/output_dir, etc.) |
| Verifies the staged PDF (existence/page count/hash/size) |
| Cleans up the staged artifact |
fetch returns: artifact_id / temp_path / source / byte count / SHA-256 / page count / status / failure classification.
Providers
Provider | Status | Description |
| ✅ | For testing, synthesizes PDFs, no network |
| ✅ controlled enablement | Article Retrieval API; requires authorization, campus IP, and a 0600 key file |
| ✅ | cloakbrowser extracts the PDF link and captures the browser download |
| ✅ | cloakbrowser obtains cookies, requests downloads; limited subscription scope |
| ✅ | Redirected article URL goes from |
| ✅ | DOI journal prefix maps to the PLOS PDF address |
| ✅ | Article page and DOI suffix construct the PDF address |
| ✅ | Springer-like page structure and cookie download |
The Elsevier key only enters through the mode 0600 file pointed to by PAPER_DOWNLOAD_ELSEVIER_API_KEY_FILE, never into tool arguments, logs, or messages.
These providers' page rules come from practical records in existing English-literature paper download work; specific limitations and evidence are in docs/provider-acceptance.md. "Implemented" in code does not mean every paper is downloadable in the current network environment; subscriptions, page changes, rate limiting, and article takedowns still cause explainable failures.
This project does not integrate scansci-pdf. It is an independent third-party MCP and is not part of this project's provider chain.
Installation and Running
cd paper-download-mcp
python -m pip install -e ".[dev,browser]"
# 测试(无网络无 DB 无 secret)
python -m pytest tests -v
# 启动 MCP (stdio)
paper-download-mcp # 或 python -m paper_download_mcpBrowser providers require cloakbrowser; Elsevier's page-count verification requires the system to provide pdfinfo (usually from poppler-utils).
Calling Project Integration Side
The project side is responsible for candidate SQL, canonical storage policy, orchestration loop, asset table, and download audit. This MCP only delivers staged artifacts and their verification metadata.
Available Tools
6 toolspaper_download_discard_artifactC
Remove a staged artifact from the staging area.
Inputs: artifact_id (required). Returns: result
paper_download_fetchA
Fetch a paper into the staging area; return artifact metadata.
Does NOT accept project, output_dir, year, publisher, or final filename. The caller moves the verified artifact to final storage.
Args: identifier: DOI or UT. provider_hint: Preferred provider name (hard constraint if given).
Inputs: identifier (required), provider_hint. Returns: result
paper_download_healthA
Report version, staging dir, provider availability.
Never prints API keys or credentials.
Inputs: no named parameters. Returns: result
paper_download_list_providersA
List available download providers and their status.
Inputs: no named parameters. Returns: result
paper_download_probeB
Probe whether a provider can likely fetch the given identifier.
Args: identifier: DOI (e.g. 10.1016/j.x) or UT. provider_hint: If given, only this provider is considered.
Inputs: identifier (required), provider_hint. Returns: result
paper_download_verify_artifactA
Verify a staged artifact: existence, PDF validity, page count, hash.
Inputs: artifact_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clear, distinct role in the fetch→verify→discard workflow, plus provider/system introspection. Fetch and probe are differentiated by actual download vs. likelihood check, and health versus list_providers is similarly distinct.
All tools share the paper_download_ prefix and use snake_case, but most follow a verb_noun pattern while paper_download_health uses a noun. The overall convention is still predictable and readable.
With six tools covering fetch, discard, probe, health, provider listing, and verification, the count is well-scoped for a focused paper-download staging service. Each tool earns its place and there is no bloat.
The core lifecycle of fetching, verifying, discarding, and probing is covered, and provider/health introspection is present. A minor gap is the lack of a tool to list currently staged artifacts, though the workflow is still usable without it.
Maintenance
Related MCP Connectors
Unofficial Archive MCP — wraps the Internet Archive APIs (free, no auth)
Citations, abstracts, PDFs, as one MCP tool through Apify
Unofficial Crossref MCP — wraps the Crossref REST API (academic papers, free, no auth)
Search and retrieve bioRxiv and medRxiv preprints — by DOI, date interval, or keyword — via MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for downloading academic papers from multiple sources using intelligent routing and year-aware priority selection. It enables users to retrieve metadata and download single or batch PDFs by DOI or URL.321 PyPI3MIT
- AlicenseAqualityDmaintenanceAn MCP server that resolves paper requests (DOI, arXiv, etc.), checks a local store, fetches open-access PDFs, and returns request IDs. It integrates with acatome-extract for ingestion and provides tools for submission, status, update, and file upload.443 PyPIGPL 3.0
- AlicenseAqualityCmaintenanceMCP server for downloading academic papers from DOI or title, resolving references, and generating citations. Supports batch downloads, multiple mirrors, and optional Unpaywall integration.112MIT
- AlicenseNot gradedqualityDmaintenanceA provider-neutral Web Search MCP server and CLI that combines live search, scholarly discovery, verified PDF downloads, URL normalization, multi-provider ranking, secure page fetching, caching, and citation-ready research evidence.MIT