Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HTTP_PROXYNoHTTP proxy for institutional networks.
HTTPS_PROXYNoHTTPS proxy for institutional networks.
ZOTERO_LOCALNoSet to 'true' to use local Zotero integration.true
SSL_CERT_FILENoSSL certificate file for institutional networks.
OPENALEX_EMAILYesYour email address for polite API access to OpenAlex (required).
SCIHUB_ENABLEDNoSet to 'true' to enable Sci-Hub integration (disabled by default).false
ZOTERO_API_KEYNoAPI key for web Zotero API (alternative to local).
UNPAYWALL_EMAILYesYour email address for OA resolution via Unpaywall (required).
ZOTERO_LIBRARY_IDNoLibrary ID for web Zotero API (alternative to local).
ZOTERO_LIBRARY_TYPENoLibrary type for Zotero (e.g., 'user').user
PAPER_PILOT_DATA_DIRNoDirectory for storage../data
SEMANTIC_SCHOLAR_API_KEYNoOptional API key for higher rate limits with Semantic Scholar.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
healthcheckA

Return current configuration summary and enabled integrations.

search_literatureC

Search Semantic Scholar, OpenAlex, Europe PMC, arXiv, Crossref, and DOAJ for a topic.

find_similar_papersC

Find similar papers starting from a seed paper title or DOI.

graph_topicB

Search a topic and render an interactive citation/relatedness graph as a self-contained HTML file.

Nodes are papers (size scales with citation count, color by year); edges connect papers that share keywords or a venue, plus similarity links radiating from the top result. Returns the local HTML path. Open it in a browser to explore or screenshot the landscape.

inspect_open_access_pdfC

Download an open-access PDF and return a local preview.

extract_local_pdf_textC

Extract full text from a local PDF, save a text sidecar, and return top matching chunks.

render_pdf_pagesA

Render selected PDF pages to PNG and return them as images the model can see.

The result is [metadata_dict, image, image, ...]: the dict keeps pdf_path and images (local PNG paths) for path-based clients, and the trailing image blocks let a vision-capable model inspect figures, tables, and layout directly. Set include_images=False to return only the paths.

read_pdf_documentA

Return a downloaded PDF's local path so a client can open the file when it needs it.

By default nothing is base64-inlined: the result is [metadata, resource_link] where metadata carries pdf_path / doc_id / page_count / size_bytes. The PDF stays on disk; clients that read local files (e.g. Claude Code) or fetch the paperpilot://pdf/{doc_id} resource use it without payload bloat. Set embed_base64=True to inline the PDF as an application/pdf resource for clients that read PDFs that way (Claude API integrations), bounded by max_mb / max_pages.

get_pdf_page_textA

Return the exact extracted text of specific PDF pages (1-based) as plain JSON.

For fine-grained lookups over the wire (a single reference entry, a table, a footnote) without base64 and without filesystem/shell access. Use deep_read_topic first to get the pdf_path and the page mapping (deep_reads[*].chunk_manifest_path), then fetch the exact pages you need here.

search_libgenC

Search LibGen mirrors for supplemental research material.

inspect_libgen_itemC

Resolve LibGen mirror links, download a PDF when possible, and return a preview.

search_scihubB

Search Sci-Hub for papers by DOI, title, or keyword. Use search_type='doi', 'title', or 'keyword'. Requires SCIHUB_ENABLED=true.

download_scihub_paperA

Download a paper PDF via Sci-Hub using its DOI. Returns local path and text preview. Requires SCIHUB_ENABLED=true.

list_zotero_collectionsC

List Zotero collections visible to the configured web or local Zotero integration.

research_topicC

Run the end-to-end research workflow and optionally sync the result into Zotero. Set include_scihub=True to use Sci-Hub as a fallback for papers without open-access PDFs. Set write_graph=True to also render an interactive citation graph HTML (path returned as graph_path).

deep_read_topicA

Search, download, extract full text, and return evidence chunks plus local PDF paths for direct inspection.

By default the result is just [result_dict]: it carries every downloaded PDF's local path in pdf_paths (and in deep_reads[].pdf_path / downloads[].pdf_path), so a client can open the files when needed without any base64 in the payload. Opt in to inline content when your client benefits: render_top_pages=True appends the top paper's relevant pages as images (vision models); attach_top_pdf=True embeds its PDF as an application/pdf resource (Claude API style). include_scihub=True adds a Sci-Hub fallback; write_graph=True also renders a citation graph (path in graph_path).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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/aytzey/paper-pilot'

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