hf-papers-mcp
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., "@hf-papers-mcp what are the top papers on speculative decoding?"
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.
An MCP server that lets your assistant read Hugging Face Papers — search them, pull the daily curated list, fetch metadata, and generate citations.
Ask "what shipped on (your interest) this week?" and get real papers with upvote counts and abstracts, instead of whatever was in the model's training data.

(Recorded with vhs via vhs demo.tape — the
session runs bin/demo.js, a real MCP client against the live API.)
Install
Point your MCP client (Claude Desktop, Claude Code, or any MCP host) at it:
{
"mcpServers": {
"hf-papers": {
"command": "npx",
"args": ["-y", "hf-papers-mcp"]
}
}
}Or from source: git clone https://github.com/QEbellavita/hf-papers-mcp and point
command: node, args: [/absolute/path/to/hf-papers-mcp/server.js] at the checkout.
Pure Node (>= 18), one dependency (@modelcontextprotocol/sdk), no Python. No API key
needed — everything is a public read. If HF_TOKEN is set (or you're logged in via
hf auth login), it's sent along, which helps with rate limits.
Related MCP server: HuggingFace Daily Papers MCP Server
Tools
Tool | What it does |
| Search papers by keyword |
| The daily curated list, optionally for a past date |
| Full metadata for an arXiv ID — title, authors, abstract, URLs |
| BibTeX, APA or MLA |
| Whether a paper is indexed on HF |
| Trigger indexing of an arXiv paper on HF |
Example
> what were the top papers on Hugging Face yesterday?
[1] Domino: Decoupling Causal Modeling from Autoregressive Drafting
in Speculative Decoding
arXiv: 2605.29707 | Upvotes: 152Bulk digests
Pull a date range in one go:
node bin/daily.js 2026-07-01 2026-07-14Writes JSON keyed by date to /tmp/, and records the window in
.hf_papers_last_run.json so a bare node bin/daily.js picks up where the last run
finished.
Tests
npm test # hermetic — no network
HF_PAPERS_E2E=1 npm test # adds live API testsThe default suite is offline and covers tool definitions plus a real MCP handshake over stdio. The live tests hit the Hugging Face API and assert that responses come back as parsed JSON — a regression guard, because diagnostics written to stdout used to corrupt the JSON stream and silently degrade structured responses into raw strings.
Notes
Every call is a direct HTTPS request to the public Hugging Face / arXiv APIs — no
daemon, no cached state, nothing persisted beyond the optional bin/daily.js run
marker. Diagnostics go to stderr, since stdout is the MCP transport and anything else
written there breaks the protocol.
Earlier versions shelled out to a Python sidecar (scripts/paper_manager.py via uv);
v1.1.0 ported the six exposed operations to native Node, so cold-start latency dropped
from ~12s to nothing and the uv/Python requirement is gone.
Citing
If this server is useful in your research workflow, cite it via the repo's CITATION.cff (GitHub's "Cite this repository" button), or the Zenodo DOI, 10.5281/zenodo.21484748 — a concept DOI that always resolves to the latest archived version.
Licence
MIT — see LICENSE.
Available Tools
6 toolshf_papers_checkC
Check if a paper is indexed on Hugging Face and get its metadata.
Inputs: arxiv_id (required).
hf_papers_citationA
Generate a citation for a paper. Returns raw text in BibTeX, APA, or MLA format as { result: "..." }.
Inputs: arxiv_id (required), format.
hf_papers_dailyA
Fetch daily curated papers from Hugging Face. Check what is trending in AI research.
Inputs: date, limit.
hf_papers_indexB
Trigger indexing of a paper on Hugging Face from arXiv.
Inputs: arxiv_id (required).
hf_papers_infoA
Get full metadata for a paper from Hugging Face — title, authors, abstract, URLs.
Inputs: arxiv_id (required).
hf_papers_searchA
Search Hugging Face papers by keyword. Use to find research relevant to current engine work.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Tools are mostly distinct: daily, search, citation, and index each target different actions. However, hf_papers_info and hf_papers_check both return metadata, which could cause an agent to select the wrong one.
All tools share the consistent hf_papers_ prefix, but the suffixes mix parts of speech (daily is an adjective, info and citation are nouns, while search, check, and index are verbs). The naming is readable and predictable, but not perfectly uniform verb_noun.
With 6 tools covering discovery, search, metadata, citation, verification, and indexing, the count is well-scoped for a Hugging Face papers server. No redundant or missing tools at this granularity.
The tool surface covers the key research workflow: discovering papers (daily), searching (search), retrieving details (info), citing (citation), checking availability (check), and adding new papers (index). No obvious dead ends or missing core operations.
Maintenance
Related MCP Connectors
Paper search (free), literature review packs, hallucinated-citation checks, arXiv digests, citations
Research paper search with real citations and reference formatting for AI assistants
Search 340M+ academic papers — citation graphs, semantic similarity, and AI literature reviews.
arXiv and OpenAlex/Crossref paper search (an open Google Scholar alternative) as agent tools.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables searching, fetching, and analyzing scientific papers from ArXiv, ACL Anthology, Semantic Scholar, and Hugging Face datasets, with optional LLM-powered document QA and research proposal workflows.578 PyPI94Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables fetching HuggingFace daily papers for today, yesterday, or a specific date, providing paper details including title, authors, abstract, tags, votes, and links.20 PyPIMIT
- FlicenseNot gradedqualityAmaintenanceEnables LLMs to search for academic papers, retrieve paper metadata and abstracts, and access full-text content when available from Semantic Scholar and Crossref.-
- FlicenseNot gradedqualityAmaintenanceEnables LLMs to search academic papers across multiple sources and retrieve paper metadata, abstracts, and full-text content when available from Semantic Scholar and Crossref.-