Skip to main content
Glama
gjjisadog

scipdf-mcp

by gjjisadog

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SCIPDF_DEBUGNoSet to '1' to enable debug logging.
SCIPDF_MIRRORSNoComma-separated list of HTML mirrors (overrides built-in list).
SCIPDF_PDF_HOSTSNoComma-separated list of direct PDF hosts.sci.bban.top/pdf/
SCIPDF_PREFER_OANoSet to 'true' to prefer Open Access over Sci-Hub.false
SCIPDF_ALLOW_SCIHUBNoSet to 'false' to disable Sci-Hub downloads.true
SCIPDF_DOWNLOAD_DIRNoDirectory to save downloaded papers.~/Documents/Papers
SCIPDF_HEALTH_TTL_MSNoMirror health cache TTL in milliseconds (default 15 minutes).900000
SCIPDF_FILENAME_STYLENoFile naming style: 'doi' or 'author_year_title'.doi
SCIPDF_UNPAYWALL_EMAILNoOptional email for Unpaywall API (required only if using OA).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
download_paperC

Download an academic paper PDF by DOI, title, URL, or citation. Default: Sci-Hub/pdfHosts. Optional Unpaywall OA only if SCIPDF_UNPAYWALL_EMAIL is set AND SCIPDF_PREFER_OA=true. Returns path, source (scihub|unpaywall|cache), citations. Use force=true to re-download.

download_papersA

Batch-download papers. Accepts list of DOIs/titles/URLs, or a single bib/ris/pasted bibliography blob. Dedupes DOIs, writes scipdf-manifest.json, returns indexed results.

resolve_doiA

Resolve title/URL/citation to DOI via Crossref + OpenAlex. Returns candidates when ambiguous (code AMBIGUOUS_DOI).

parse_referencesA

Extract DOIs/queries from BibTeX, RIS, or pasted reference list text.

list_mirrorsA

List configured Sci-Hub mirrors, PDF hosts, Unpaywall status, and settings (hot-reloads config).

lookup_unpaywallA

Query Unpaywall for Open Access status and PDF URL (does not download). Requires SCIPDF_UNPAYWALL_EMAIL.

check_mirrorsA

Probe Sci-Hub mirrors for availability (uses health cache; force_refresh ignores cache). Only configured public mirrors (or allowlisted public https hosts) are probed — private/localhost URLs are rejected.

list_papersC

List PDF files already in the download directory (most recent first).

open_paperA

Open a local PDF path with the system default viewer (macOS open / Windows start / xdg-open).

format_citationA

Format APA / GB/T 7714 / BibTeX from DOI (fetches Crossref metadata).

reload_configA

Hot-reload scipdf config from environment variables and config.json without restarting the process.

Prompts

Interactive templates invoked by user choice

NameDescription
download_papers_batch

Resources

Contextual data attached and managed by the client

NameDescription
papers-listRecently downloaded PDFs in the configured download directory

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gjjisadog/scipdf-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server