Supports paper retrieval using ArXiv IDs, enabling access to scientific papers and preprints from the ArXiv repository as part of the academic search capabilities.
Enables paper lookup and retrieval using DOI identifiers, allowing access to published academic papers across various publishers and journals.
Provides filtering capability to find papers with open access PDFs, making it easier to discover freely available academic content.
Provides access to the Semantic Scholar Academic Graph API, allowing for searching and retrieving academic papers, author information, citation analysis, reference tracking, and text snippet search across scholarly publications.
Semantic Scholar MCP Server
A Model Context Protocol (MCP) server that provides access to the Semantic Scholar Academic Graph API. This server allows you to search for academic papers, authors, and get detailed information about citations and references.
Features
- Paper Search: Search for academic papers with various filters
- Paper Details: Get detailed information about specific papers
- Batch Paper Retrieval: Get information for multiple papers at once
- Author Search: Find authors by name
- Author Details: Get detailed author information and their papers
- Citation Analysis: Get papers that cite a specific paper
- Reference Analysis: Get papers referenced by a specific paper
- Citation Context: Get the context in which one paper cites another
- Text Snippets: Search for text snippets across academic papers
- PDF Download: Download open access PDFs with proper filenames and metadata
- PDF Availability: Check if PDFs are available before downloading
- Smart Naming: PDFs saved with paper title and year as filename
- Metadata Support: Embeds title, authors, and year in PDF file properties
Installation
- Clone this repository:
- Install dependencies:
- (Optional but recommended) Set up your Semantic Scholar API key:
Note: The API key is optional. The server works without it, but you'll share the public rate limit (1000 requests per second across all unauthenticated users).
- (Optional) Install PDF metadata support:
Development
Setup Development Environment
Running Tests
Code Quality
Configuration
Add this server to your MCP client configuration:
Configuration without API key (shares public rate limit):
Important:
- Replace
your-username
with your actual username - The API key is optional but recommended for dedicated rate limits
- Without an API key: Shared public rate limit (1000 requests/second across all users)
- With a free API key: Dedicated higher rate limits for your usage
Available Tools
Paper Tools
search_papers
Search for academic papers with various filters.
Parameters:
query
(required): Search query stringlimit
: Maximum number of results (default: 10, max: 100)offset
: Number of results to skip (default: 0)fields
: Comma-separated list of fields to returnpublication_types
: Filter by publication typesopen_access_pdf
: Filter for papers with open access PDFsmin_citation_count
: Minimum citation countyear
: Publication year or year range (e.g., "2020-2023")venue
: Publication venue
get_paper
Get detailed information about a specific paper.
Parameters:
paper_id
(required): Paper ID (Semantic Scholar ID, DOI, ArXiv ID, etc.)fields
: Comma-separated list of fields to return
get_paper_batch
Get information for multiple papers in a single request.
Parameters:
paper_ids
(required): Comma-separated list of paper IDsfields
: Comma-separated list of fields to return
Author Tools
search_authors
Search for authors by name.
Parameters:
query
(required): Author name or search querylimit
: Maximum number of results (default: 10, max: 1000)offset
: Number of results to skip (default: 0)fields
: Comma-separated list of fields to return
get_author
Get detailed information about a specific author.
Parameters:
author_id
(required): Author IDfields
: Comma-separated list of fields to return
Citation and Reference Tools
get_paper_citations
Get papers that cite a specific paper.
Parameters:
paper_id
(required): Paper ID to get citations forlimit
: Maximum number of results (default: 10, max: 1000)offset
: Number of results to skip (default: 0)fields
: Comma-separated list of fields to return
get_paper_references
Get papers referenced by a specific paper.
Parameters:
paper_id
(required): Paper ID to get references forlimit
: Maximum number of results (default: 10, max: 1000)offset
: Number of results to skip (default: 0)fields
: Comma-separated list of fields to return
get_citation_context
Get the context in which one paper cites another.
Parameters:
paper_id
(required): ID of the paper being citedciting_paper_id
(required): ID of the paper doing the citing
Text Search Tools
search_snippets
Search for text snippets across academic papers.
Parameters:
query
(required): Search query for text snippetslimit
: Maximum number of results (default: 10, max: 100)offset
: Number of results to skip (default: 0)
PDF Tools
get_paper_pdf_info
Check PDF availability for a paper.
Parameters:
paper_id
(required): Paper ID to check PDF availability
download_paper_pdf
Download the PDF of a paper if available, using the paper title as filename and setting metadata.
Parameters:
paper_id
(required): Paper ID to download PDF fordownload_path
: Directory to save PDF (default: ~/Downloads/semantic_scholar_papers)
Features:
- Uses paper title as filename (e.g., "Machine Learning in Healthcare (2023).pdf")
- Sets PDF metadata with title, authors, and publication year
- Handles duplicate filenames automatically
- Creates organized folder structure
Usage Examples
Search for papers on machine learning
Get details about a specific paper
Find papers that cite a specific work
Search for an author
Get citation context
Check PDF availability
Download a paper PDF
This will save the PDF as something like:
With embedded metadata including title, authors (LeCun, Y., Bengio, Y., Hinton, G.), and year (2015).
API Rate Limits
The Semantic Scholar API has the following rate limits:
- Without API key: 1000 requests per second shared among all unauthenticated users (may be throttled during heavy usage)
- With free API key: Dedicated higher rate limits for your personal usage
Getting a free API key is recommended for consistent performance.
Troubleshooting
Rate Limit Error
If you see this error:
This means you've hit the shared public rate limit or the API is being throttled due to heavy usage.
Immediate Solutions:
- Get a free API key (recommended):
- Visit https://www.semanticscholar.org/product/api
- Sign up for a free account
- Get your API key
- Add it to your Claude Desktop config:
- Restart Claude Desktop
- Wait and retry: The shared public rate limit may be temporarily exceeded
- Use smaller result limits: Reduce the
limit
parameter in your queries - Space out requests: Avoid making many requests in rapid succession
Configuration Issues
- Ensure the Python path in your config points to the correct virtual environment
- Verify the server script path is correct
- Check that all dependencies are installed in the virtual environment
Testing the Connection
You can test if the server is working by asking Claude to search for a single paper with a small limit:
Error Handling
All tools include comprehensive error handling and will return descriptive error messages if requests fail or if the API returns errors.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables access to the Semantic Scholar Academic Graph API for searching and retrieving detailed information about academic papers, authors, citations, and references.
Related MCP Servers
- -securityAlicense-qualitySemantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.Last updated -35PythonMIT License
- AsecurityAlicenseAqualityEnables users to search for academic articles on platforms like arXiv using specific keywords, with plans to integrate more scholarly databases in the future.Last updated -2118PythonMIT License
- AsecurityAlicenseAqualityEnables real-time search and retrieval of academic paper information from multiple sources, providing access to paper metadata, abstracts, and full-text content when available, with structured data responses for integration with AI models that support tool/function calling.Last updated -311PythonAGPL 3.0
- -securityFlicense-qualityEnables search and retrieval of academic papers from PubMed database with advanced features like MeSH term lookup, publication statistics, and PICO-based evidence search.Last updated -Python