semanticscholar-mcp-server
v1.0.0
Published
MCP server for the Semantic Scholar Academic Graph API
Maintainers
Readme
Semantic Scholar MCP Server
An MCP (Model Context Protocol) server for the Semantic Scholar Academic Graph API — 200M+ papers with citation networks, author profiles, and full-text snippet search.
Built with the MCP TypeScript SDK and Zod.
Tools (16 total)
Papers (9 tools)
| Tool | Description |
|------|-------------|
| paper_search | Search papers by keyword with filtering (year, venue, field, open access, citations, type) |
| paper_search_bulk | Bulk search with cursor pagination for large result sets (up to 10M) |
| paper_match | Find the single best match for a known paper title |
| paper_autocomplete | Autocomplete partial paper titles (up to 10 suggestions) |
| paper_get | Get full details for a paper by ID (S2 ID, DOI, ArXiv, PMID, etc.) |
| paper_batch | Retrieve up to 500 papers in a single request |
| paper_citations | Get papers that cite a given paper (forward citations) |
| paper_references | Get a paper's reference list (bibliography) |
| paper_authors | Get author details for a specific paper |
Authors (4 tools)
| Tool | Description |
|------|-------------|
| author_get | Get full author profile (h-index, affiliations, stats) |
| author_batch | Retrieve up to 1000 author profiles in one request |
| author_search | Search for authors by name |
| author_papers | Get all papers by a specific author |
Recommendations (2 tools)
| Tool | Description |
|------|-------------|
| recommendations_for_paper | Get ML-powered paper recommendations for a given paper |
| recommendations_from_lists | Get recommendations from positive/negative example papers |
Snippets (1 tool)
| Tool | Description |
|------|-------------|
| snippet_search | Search within paper bodies for specific text passages |
Setup
1. Get an API key (optional but recommended)
Get a free key at semanticscholar.org/product/api. Without a key, requests are heavily rate-limited.
2. Install and build
cd semanticscholar-mcp-server
npm install
npm run build3. Add to Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"semantic-scholar": {
"command": "node",
"args": ["/path/to/semanticscholar-mcp-server/dist/index.js"],
"env": {
"SEMANTICSCHOLAR_API_KEY": "your-api-key"
}
}
}
}Or if using Claude Code CLI:
claude mcp add semantic-scholar \
node \
/path/to/semanticscholar-mcp-server/dist/index.js \
-e SEMANTICSCHOLAR_API_KEY=your-api-keyFeatures
- Multiple ID formats: Accepts S2 Paper IDs, DOIs, ArXiv IDs, PMIDs, PMCIDs, CorpusIds
- Markdown or JSON output: Every tool supports
response_format: "json"for structured data - Custom field selection: Override default fields with the
fieldsparameter - Built-in rate limiting: Token bucket limiter prevents API throttling
- Batch operations: Retrieve up to 500 papers or 1000 authors in a single call
Usage examples
- "Search Semantic Scholar for papers on transformer architectures from 2023"
- "Get recommendations for papers similar to this one"
- "Find the citation network for DOI 10.1038/nature14539"
- "Search for text snippets mentioning 'chain of thought prompting'"
- "Look up author profile for researcher 1741101"
License
MIT
