semantic-scholar-mcp
Provides tools to search for academic papers, retrieve paper details, author information, and generate formatted citations using the Semantic Scholar API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@semantic-scholar-mcp search for recent papers on reinforcement learning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Semantic Scholar MCP Server
Note: A lightweight CLI alternative is available at
semantic-scholar-cli. It is designed for LLM tool-use workflows with strict typed inputs, stable JSON envelopes, and small default payloads — usable without an MCP server.
A Model Context Protocol (MCP) server that provides access to Semantic Scholar's academic paper database through their API.
Features
Paper Search: Search for academic papers with filters for year, fields of study, and open access
Paper Details: Get comprehensive information about specific papers including abstracts, authors, and citation counts
Author Information: Retrieve detailed author data including affiliations, h-index, and citation metrics
Citation Export: Generate citations in multiple formats (BibTeX, APA, MLA, Chicago)
Related MCP server: semanticscholar-mcp
Usage
Get API Key
While the Semantic Scholar API can be used without authentication, having an API key provides higher rate limits. To get an API key:
Visit Semantic Scholar API
Request an API key
Add to Claude Code configuration
Run the following command to add the Semantic Scholar MCP server to your project-scope Claude Code configuration:
claude mcp add semantic-scholar-mcp -s project -e SEMANTIC_SCHOLAR_API_KEY="your-api-key-here" -- uv run --with "git+https://github.com/FujishigeTemma/semantic-scholar-mcp" semantic-scholar-mcp serveOr manually add it to your .mcp.json configuration file:
{
"mcpServers": {
"semantic-scholar-mcp": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"--with",
"git+https://github.com/FujishigeTemma/semantic-scholar-mcp",
"semantic-scholar-mcp",
"serve"
],
"env": {
"SEMANTIC_SCHOLAR_API_KEY": "your-api-key-here"
}
}
}
}Available Tools
search_paper - Search for papers
Required:
query(search terms)Optional:
fields,limit,offset,year,fieldsOfStudy,openAccessPdf
get_paper - Get detailed paper information
Required:
paper_id(supports multiple ID types: DOI, ArXiv ID, S2 Paper ID, etc.)Optional:
fields(customize returned data, see: Field Customization)
get_authors - Get author information for a paper
Required:
paper_idOptional:
fields,limit,offset
get_citation - Generate formatted citations
Required:
paper_idOptional:
format(bibtex, apa, mla, chicago)
CLI Examples
Search for papers:
semantic-scholar-mcp tools search_paper "machine learning" --limit 5 --year "2020-2023"Get paper details:
semantic-scholar-mcp tools get_paper "10.1038/nature12373"Get authors for a paper:
semantic-scholar-mcp tools get_authors "649def34f8be52c8b66281af98ae884c09aef38b"Generate BibTeX citation:
semantic-scholar-mcp tools get_citation "649def34f8be52c8b66281af98ae884c09aef38b" --format bibtexField Customization
All tools support a fields parameter to customize the returned data. This allows you to request only the information you need, reducing response size and improving performance.
Paper Fields (for search_paper and get_paper)
Basic fields:
paperId- Unique paper identifiertitle- Paper titleabstract- Paper abstractyear- Publication yearpublicationDate- Full publication date
Author information:
authors- List of authors (returnsauthorIdandnameby default)authors.authorId- Author's unique identifierauthors.name- Author's nameauthors.affiliations- Author's institutional affiliationsauthors.citationCount- Author's total citation countauthors.hIndex- Author's h-index
Citation and reference data:
citationCount- Number of times this paper has been citedreferenceCount- Number of references in this papercitations- List of papers that cite this paperreferences- List of papers referenced by this paper
Publication details:
journal- Journal information (name, volume, pages, etc.)venue- Publication venuepublicationTypes- Types of publication (e.g., JournalArticle, Conference)fieldsOfStudy- Academic fields (e.g., Computer Science, Medicine)s2FieldsOfStudy- Semantic Scholar's field classifications
Additional metadata:
doi- Digital Object IdentifierarxivId- ArXiv identifierurl- Paper URLopenAccessPdf- Open access PDF informationembedding- Paper embedding vectors (for similarity analysis)
Author Fields (for get_authors)
authorId- Unique author identifiername- Author's nameaffiliations- Institutional affiliationscitationCount- Total citation counthIndex- h-index metricpaperCount- Number of papers publishedurl- Author's profile URL
Example Field Usage
Get basic paper information:
semantic-scholar-mcp tools search_paper "machine learning" --fields "paperId,title,year,citationCount"Get detailed paper with author affiliations:
semantic-scholar-mcp tools get_paper "10.1038/nature12373" --fields "title,abstract,authors.name,authors.affiliations,journal,year"Get comprehensive author information:
semantic-scholar-mcp tools get_authors "649def34f8be52c8b66281af98ae884c09aef38b" --fields "authorId,name,affiliations,citationCount,hIndex,paperCount"Development
Setting up the development environment
uv sync
uv run pytest tests/
uv run ruff format .
uv run ruff check . --fix
uv run ty checkProject Structure
semantic-scholar-mcp/
src/
semantic_scholar_mcp/
__init__.py
server.py # Main server implementation
cli.py # CLI interface
tests/ # Test files
pyproject.toml # Project configuration
README.md # This fileAPI Rate Limits
Without API key: 100 requests per 5 minutes
With API key: 1 request per second (higher limits available on request)
Supported Paper ID Types
The API supports various paper identifier formats:
Semantic Scholar ID (e.g., "649def34f8be52c8b66281af98ae884c09aef38b")
DOI (e.g., "10.1038/nature12373")
ArXiv ID (e.g., "arXiv:2106.15928")
MAG ID
ACL ID
PubMed ID
Corpus ID
License
MIT License
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Acknowledgments
This project uses the Semantic Scholar API to access academic paper data.
Available Tools
4 toolsget_authorsB
Get authors information for a specific paper. Use 'fields' parameter to customize author data returned.
Inputs: paper_id (required), fields, offset, limit.
get_citationB
Get citation information in various formats.
Inputs: paper_id (required), format.
get_paperB
Get detailed information about a specific paper. Use 'fields' parameter to customize returned data.
Inputs: paper_id (required), fields.
search_paperB
Search for papers using Semantic Scholar. Use 'fields' parameter to customize returned data
Inputs: query (required), fields, publicationTypes, openAccessPdf, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct aspect of scholarly data: searching papers, retrieving paper details, fetching author info, and obtaining citation formats. No overlap in functionality.
All tool names follow a consistent verb_noun pattern (get_authors, get_citation, get_paper, search_paper) using lowercase snake_case, making them predictable.
Four tools cover the core operations for a semantic scholar client (search, detail, authors, citations) without being excessive or insufficient.
The set covers primary use cases but lacks tools for listing citations or references of a paper, which are common scholarly queries. Still, the essential workflows are supported.
Maintenance
Related MCP Connectors
Academic research MCP server for paper search, citation checks, graphs, and deep research.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn MCP server that enables academic research by searching Google Scholar, fetching paper content, and converting web pages to clean Markdown.1MIT
- AlicenseBqualityDmaintenanceMCP server that provides Semantic Scholar academic search capabilities, including paper search, detail query, citation analysis, author search, and intelligent recommendations.984 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and retrieving academic papers, authors, citations, and references from Semantic Scholar via an HTTP MCP server with caching and rate limiting.103 npmMIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for academic research combining local document search with Semantic Scholar API integration.MIT