Skip to main content
Glama
smaniches

Semantic Scholar MCP Server

by smaniches
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

semantic_scholar_get_paper

Read-onlyIdempotent

Get paper details. Accepts: S2 ID, DOI:xxx, ARXIV:xxx, PMID:xxx, CorpusId:xxx

Instructions

Get paper details. Accepts: S2 ID, DOI:xxx, ARXIV:xxx, PMID:xxx, CorpusId:xxx

Returns title, abstract, authors, venue, year, citation counts, TLDR,
and open-access PDF link for one paper, e.g. paper_id='ARXIV:1706.03762'.
Set include_citations / include_references to also list citing and
referenced papers (fetched in parallel, 1-100 per page each). Paginate
the two directions independently with citations_offset/references_offset;
JSON output exposes citations_page.next and references_page.next.
Results are cached
in memory for 5 minutes; an unknown ID raises a not-found error. Client-side
requests use a 1.0-second unkeyed interval and a conservative 1.1-second
authenticated default; explicitly higher S2-assigned quotas can be configured.
429/502/503 responses retry automatically with backoff. Returns
Markdown by default, response_format='json' for raw JSON. To fetch many
papers at once use semantic_scholar_bulk_papers.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
paramsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv1.2.17
    • addedInput schema / $defs / PaperDetailsInput / properties / citations_offset
      Added value: +{
+  "default": 0,
+  "description": "Pagination offset for citing papers (default 0)",
+  "minimum": 0,
+  "title": "Citations Offset",
+  "type": "integer"
+}
    • addedInput schema / $defs / PaperDetailsInput / properties / references_offset
      Added value: +{
+  "default": 0,
+  "description": "Pagination offset for referenced papers (default 0)",
+  "minimum": 0,
+  "title": "References Offset",
+  "type": "integer"
+}
  2. Changed1 schema field changedv1.2.13
    • changedOutput schema / (root)
      Previous value: -{
-  "properties": {
-    "result": {
-      "title": "Result",
-      "type": "string"
-    }
-  },
-  "required": [
-    "result"
-  ],
-  "title": "get_paper_detailsOutput",
-  "type": "object"
-}New value: +null
  3. Changed5 schema fields changedv1.2.12
    • changedInput schema / $defs / PaperDetailsInput / properties / citations_limit / description
      Previous value: -"Max citations to return"New value: +"Max citing papers returned when include_citations=true (1-100, default 10)"
    • changedInput schema / $defs / PaperDetailsInput / properties / include_citations / description
      Previous value: -"Include citing papers"New value: +"Also list papers that cite this one (default false)"
    • changedInput schema / $defs / PaperDetailsInput / properties / include_references / description
      Previous value: -"Include referenced papers"New value: +"Also list papers this one cites (default false)"
    • changedInput schema / $defs / PaperDetailsInput / properties / paper_id / description
      Previous value: -"Paper ID: S2 ID, DOI:xxx, ARXIV:xxx, PMID:xxx, CorpusId:xxx"New value: +"Paper ID: a 40-character S2 hex ID ('649def34f8be52c8b66281af98ae884c09aef38b'), 'DOI:10.18653/v1/N18-3011', 'ARXIV:1706.03762', 'PMID:19872477', 'CorpusId:215416146', 'ACL:W12-3903', or 'URL:https://...'"
    • changedInput schema / $defs / PaperDetailsInput / properties / references_limit / description
      Previous value: -"Max references to return"New value: +"Max referenced papers returned when include_references=true (1-100, default 10)"
  4. Changed2 schema fields changedv1.2.6
    • addedInput schema / $defs / PaperDetailsInput / properties / api_key / deprecated
      Added value: +true
    • changedInput schema / $defs / PaperDetailsInput / properties / api_key / description
      Previous value: -"API key (overrides SEMANTIC_SCHOLAR_API_KEY env var)"New value: +"API key (overrides SEMANTIC_SCHOLAR_API_KEY env var). Deprecated: prefer the environment variable. Removal planned for v2.0.0."
  5. Changed1 schema field changedv1.0.3
    • addedInput schema / $defs / PaperDetailsInput / properties / api_key
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "API key (overrides SEMANTIC_SCHOLAR_API_KEY env var)",
+  "title": "Api Key"
+}
  6. First observed

TDQS

Score is being calculated.

Deploy Server

Other Tools