Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
AnModel Context Protocol (MCP) server for the Unpaywall API. Search article titles, fetch DOI metadata, retrieve best open‑access links, and extract text from OA PDFs—ready for Claude Desktop and any MCP‑compatible client. Ideal for LLM research assistants, literature review, and academic workflows.
An MCP (Model Context Protocol) server exposing Unpaywall tools so AI clients can:
Add this to your MCP client config (Claude Desktop example):
{
"mcpServers": {
"unpaywall": {
"command": "npx",
"args": ["-y", "unpaywall-mcp"],
"env": { "UNPAYWALL_EMAIL": "[email protected]" }
}
}
}
Then try the tools: unpaywall_search_titles, unpaywall_get_fulltext_links, unpaywall_fetch_pdf_text.
You don't need to clone this repo or run npm install — npx handles fetching and caching on first call.
npx)End users should use the npx config above. Contributors building from source:
npm install
npm run build
[email protected] npm start # stdio transport, as required by MCP clients
Hot-run (no build step):
[email protected] npm run dev
doi (string, required): e.g. 10.1038/nphys1170email (string, optional): overrides UNPAYWALL_EMAIL if providedquery (string, required): title queryis_oa (boolean, optional): if true, only OA results; if false, only closed; omit for allpage (integer >= 1, optional): page numberemail (string, optional): overrides UNPAYWALL_EMAILresults[].response is a DOI-style record (doi, title, is_oa, oa_status, best_oa_location, oa_locations), with score and snippet per result. _source: "openalex" marks the upstream./works endpoint because Unpaywall's own /v2/search has been returning HTTP 500 since its May 2025 rewrite. Unpaywall now runs as a subroutine of OpenAlex, so this is the canonical modern equivalent.doi (string, required)email (string, optional): overrides UNPAYWALL_EMAILbest_pdf_url, best_open_url, best_oa_location, oa_locations, and select metadatapdf_urlpdf_url (string, optional): direct PDF URL (takes precedence)doi (string, optional): used to resolve best OA PDF if pdf_url not providedemail (string, optional): required if using doi and no UNPAYWALL_EMAIL env vartruncate_chars (integer >= 1000, optional): max characters of extracted text to return (default 20000)text (possibly truncated), length_chars, truncated, pdf_url, and PDF metadataWhen using this server from an MCP-enabled LLM client, ask the model to:
unpaywall_search_titles with a concise title phrase; select a result; then call unpaywall_get_fulltext_links or unpaywall_fetch_pdf_text on the chosen DOI.is_oa: true in searches when you only want open-access.truncate_chars in unpaywall_fetch_pdf_text (default 20000) and summarize long texts before proceeding.best_open_url and extract content from the landing page (outside this server).Good user instructions to the LLM:
Depending on your MCP client, the structure differs; the core payloads are:
// Search titles
{
"name": "unpaywall_search_titles",
"arguments": {
"query": "graph neural networks survey",
"is_oa": true,
"page": 1
}
}
// Get best OA links for a DOI
{
"name": "unpaywall_get_fulltext_links",
"arguments": {
"doi": "10.48550/arXiv.1812.08434"
}
}
// Fetch and extract PDF text (by DOI)
{
"name": "unpaywall_fetch_pdf_text",
"arguments": {
"doi": "10.48550/arXiv.1812.08434",
"truncate_chars": 20000
}
}
Recommended (no-build) config for Claude Desktop using npm/npx:
{
"mcpServers": {
"unpaywall": {
"command": "npx",
"args": ["-y", "unpaywall-mcp"],
"env": {
"UNPAYWALL_EMAIL": "[email protected]"
}
}
}
}
Alternative (local repo) config using the compiled dist:
{
"mcpServers": {
"unpaywall": {
"command": "node",
"args": ["/absolute/path/to/dist/index.js"],
"env": {
"UNPAYWALL_EMAIL": "[email protected]"
}
}
}
}
After adding, ask your client to list tools and try:
unpaywall_search_titles with a queryunpaywall_get_fulltext_links with a doiunpaywall_fetch_pdf_text with a doi (or pdf_url)@modelcontextprotocol/sdk.UNPAYWALL_EMAIL or pass email per call so Unpaywall can contact you about usage.# 1) Build the project (also runs automatically on publish)
npm run build
# 2) Bump version (choose patch/minor/major)
npm version patch
# 3) Publish (ensure you are logged in: npm login)
npm publish --access public
# 4) Tag a release on GitHub (optional, recommended)
Users can then configure their MCP client with npx -y unpaywall-mcp as shown above. No clone or build required.
AnModel Context Protocol (MCP) server for the Unpaywall API. Search article titles, fetch DOI metadata, retrieve best open‑access links, and extract text from OA PDFs—ready for Claude Desktop and any
Visão geral
AnModel Context Protocol (MCP) server for the Unpaywall API. Search article titles, fetch DOI metadata, retrieve best open‑access links, and extract text from OA PDFs—ready for Claude Desktop and any MCP‑compatible client. Ideal for LLM research assistants, literature review, and academic workflows.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Unpaywall roda localmente via stdio.
Última verificação: 2026-11-05. AnModel Context Protocol (MCP) server for the Unpaywall API. Search article titles, fetch DOI metadata, retrieve best open‑access links, and extract text from OA PDFs—ready for Claude Desktop and any MCP‑compatible client. Ideal for LLM research assistants, literature review, and academic workflows.