semantic-scholar-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_RECEIPT_DIR | No | Directory where query receipts are stored as JSONL files. When set, receipt logging is enabled. | |
| MCP_RECEIPT_LOG | No | Legacy path to a single JSONL receipt file. Ignored when MCP_RECEIPT_DIR is set. | |
| MCP_RECEIPT_STRICT | No | If set to '1', receipt logging failures raise an error instead of being silently ignored. | |
| MCP_RECEIPT_SESSION | No | Session slug used for organizing receipts. | |
| SEMANTIC_SCHOLAR_API_KEY | No | Your Semantic Scholar API key. Optional but recommended to avoid rate limits. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| s2_search_papersA | Search Semantic Scholar for papers by keyword, with year, field-of-study, citation-count and open-access filters. Returns the unified envelope. Matching is relevance-ranked over title, abstract and venue (matching_mode relevance_ranked); result.total is the API's estimate. Titles are typed by script: kana or Hangul decide ja or ko, Latin goes to en, and a han-only title stays untyped in extra.title. Coverage of non-English humanities work is thin — a ZERO_RESULTS here is weak evidence; consult the CiNii, J-STAGE, NDL and KCI servers. |
| s2_get_paperA | Look up one paper by S2 ID, DOI, ArXiv ID, or URL. Returns the unified envelope with a single item, or NOT_FOUND. |
| s2_batch_papersA | Look up up to 500 papers at once by ID. Returns the unified envelope; identifiers the API could not resolve are counted in a PARTIAL_NOT_FOUND diagnostic and listed in coverage_note. |
| s2_citationsA | Papers citing a given paper (citations) or cited by it (references). Returns the unified envelope. The API reports no total for this endpoint, so result.total is the returned count (TOTAL_NOT_REPORTED). |
| s2_search_authorsA | Search for authors by name. Returns the unified envelope; each item is an author record (record_type author) with affiliations, paper count, citation count and h-index in extra. |
| s2_get_authorA | Look up one author by Semantic Scholar Author ID. Returns the unified envelope with a single author item, or NOT_FOUND. |
| s2_author_papersA | Papers by one author, paginated. Returns the unified envelope; result.total is the returned count (TOTAL_NOT_REPORTED). |
| s2_recommend_singleA | Papers similar to one seed paper, by Semantic Scholar's recommender. Returns the unified envelope (matching_mode similarity_ranked). |
| s2_recommend_multiA | Papers similar to a set of positive seed papers and unlike optional negative ones. Returns the unified envelope (matching_mode similarity_ranked); the seed IDs are in query.params so the receipt fixes them. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool targets a distinct operation: paper search, single/batch lookup, citations/references, author search, author retrieval, author papers, and single/multi-seed recommendations. The only partial overlap between singles and batch or single/multi recommendations is clearly resolved by scope and descriptions.
All tools share a consistent s2_ prefix and mostly follow an action_object pattern: search_papers, get_paper, get_author, recommend_single. Two names deviate slightly — s2_citations and s2_author_papers are noun phrases rather than imperative verbs — but the naming remains predictable and readable.
Nine tools is a well-scoped size for a Semantic Scholar read-only API: search, retrieval, batch operations, authors, citations, and recommendations. Each tool adds a distinct capability without redundancy or bloat.
The set covers the main Semantic Scholar workflows: keyword search, ID lookup by multiple identifier types, batch resolution, citation/reference traversal, author discovery and author papers, plus both single- and multi-seed recommendations. For a read-only scholarly API there are no obvious dead ends or missing core endpoints.