Skip to main content
Glama
smaniches

Semantic Scholar MCP Server

by smaniches
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

semantic_scholar_recommendations

Read-onlyIdempotent

Get paper recommendations based on a seed paper.

Instructions

Get paper recommendations based on a seed paper.

Provide one paper you already know (e.g. paper_id='ARXIV:1706.03762') and
receive up to `limit` similar papers. from_pool picks the candidate pool:
'recent' (default, recently published papers from all fields) or 'all-cs'
(computer-science papers of any age). When steering with several positive
or negative examples, use semantic_scholar_multi_recommend instead. An
unknown seed 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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
paramsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.2.13
    • changedOutput schema / (root)
      Previous value: -{
-  "properties": {
-    "result": {
-      "title": "Result",
-      "type": "string"
-    }
-  },
-  "required": [
-    "result"
-  ],
-  "title": "get_recommendationsOutput",
-  "type": "object"
-}New value: +null
  2. Changed3 schema fields changedv1.2.12
    • changedInput schema / $defs / PaperRecommendationsInput / properties / from_pool / description
      Previous value: -"Paper pool: 'recent' (default) or 'all-cs'"New value: +"Candidate pool: 'recent' (default; recently published papers from all fields) or 'all-cs' (computer-science papers of any age)"
    • changedInput schema / $defs / PaperRecommendationsInput / properties / limit / description
      Previous value: -"Max recommendations"New value: +"Max recommendations (1-100, default 10)"
    • changedInput schema / $defs / PaperRecommendationsInput / properties / paper_id / description
      Previous value: -"Seed paper ID for recommendations"New value: +"Seed paper the recommendations should resemble: 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://...'"
  3. Changed2 schema fields changedv1.2.6
    • addedInput schema / $defs / PaperRecommendationsInput / properties / api_key / deprecated
      Added value: +true
    • changedInput schema / $defs / PaperRecommendationsInput / 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."
  4. Changed2 schema fields changedv1.0.3
    • addedInput schema / $defs / PaperRecommendationsInput / 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"
+}
    • addedInput schema / $defs / PaperRecommendationsInput / properties / from_pool
      Added value: +{
+  "default": "recent",
+  "description": "Paper pool: 'recent' (default) or 'all-cs'",
+  "title": "From Pool",
+  "type": "string"
+}
  5. First observed

TDQS

Score is being calculated.

Deploy Server

Other Tools