About mcp-scholaris
mcp-scholaris is an MCP server for searching academic papers and retrieving available open-access full text. It serves researchers and readers with coverage across arXiv, Semantic Scholar, and PubMed, plus Unpaywall lookup for open versions.
Key features
- 01Search by topic, author, or keyword
- 02Search across arXiv, Semantic Scholar, and PubMed
- 03Retrieve arXiv PDF full text
- 04Fetch PubMed Central articles via BioC
- 05Find open-access versions through Unpaywall
Use cases
- 01Find papers on a research topic
- 02Retrieve an available open-access paper
- 03Locate an open version of a DOI article
MCP support
It exposes paper search and retrieval tools to MCP clients over stdio using JSON-RPC 2.0.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEmcp-scholaris
An MCP server for retrieving academic papers from open access sources. Provides search across arXiv, Semantic Scholar, and PubMed, with full text retrieval via arXiv PDFs, PubMed Central (BioC API), and Unpaywall. No paywalls, no grey area — legitimate open access only.
Installation
pip install mcp-scholaris
Tools
search_papers
Search for academic papers by topic, author, or keyword.
Parameters:
query(required) — search termssources(optional) — list of sources to search:arxiv,semantic_scholar,pubmed. Defaults to all three.max_results(optional) — maximum results per source. Defaults to 5.
fetch_paper
Fetch the full text of a paper. Tries open access sources in order: arXiv → PubMed Central → Unpaywall. Provide at least one identifier.
Parameters:
arxiv_id— e.g.2301.00001orarxiv:2301.00001pubmed_id— PubMed ID (PMID), e.g.36383508doi— e.g.10.1371/journal.pone.0276755
Configuration
Semantic Scholar works without an API key but is rate-limited. For higher limits, create a .env file in your working directory:
SEMANTIC_SCHOLAR_API_KEY=your_key_here
API keys are free at semanticscholar.org.
Usage with an MCP client
Add to your MCP client configuration:
{
"mcpServers": {
"scholaris": {
"command": "scholaris"
}
}
}
Or run directly:
scholaris
The server communicates over stdio using the MCP protocol (JSON-RPC 2.0).
Sources
| Source | Search | Full Text |
|---|---|---|
| arXiv | ✓ | |
| Semantic Scholar | ✓ | ✓ when OA PDF available |
| PubMed | ✓ | ✓ via BioC API (PMC articles) |
| Unpaywall | — | ✓ for any DOI with OA version |
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.