io.github.SMABoundless/semanticscholar

NPM · SEMANTICSCHOLAR-MCP-SERVER · SCANNED AUG 3

Search 200M+ papers, authors, citations, and recommendations via Semantic Scholar

Available components

+25 this week 61 61 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency19

Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 29 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability61

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 3786 tokens (~236/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · semanticscholar-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add smaboundless-semanticscholar -- npx -y semanticscholar-mcp-server

# add to Codex CLI

codex mcp add smaboundless-semanticscholar -- npx -y semanticscholar-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "smaboundless-semanticscholar": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "semanticscholar-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add smaboundless-semanticscholar --command npx --arg -y --arg semanticscholar-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  smaboundless-semanticscholar:
    command: "npx"
    args: ["-y", "semanticscholar-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "smaboundless-semanticscholar": {
      "command": "npx",
      "args": [
        "-y",
        "semanticscholar-mcp-server"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 −3

No change was recorded against any check on this day. Supply Chain Security went from 97 to 87. Other categories moved too: Stability & Change Management rose 4.
2 Aug 26 +51
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
1 Aug 26 −5
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Capabilities: pass → unverified ▼ functional
31 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 36

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 16 exposed · ~3,786 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

author_batch ~176

Retrieve profiles for multiple authors in a single request (up to 1000). More efficient than calling author_get repeatedly.

Input Output Examples

Name	Type	Req	Description
author_ids	array	yes	List of Semantic Scholar Author IDs to retrieve (1-1000).
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

author_get ~180

Retrieve full profile for a Semantic Scholar author. Returns name, affiliations, homepage, h-index, paper count, and citation count.

Input Output Examples

Name	Type	Req	Description
author_id	string	yes	Semantic Scholar Author ID (numeric string, e.g. '1741101')
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

author_papers ~219

Get all papers published by a specific author, paginated. Returns the author's publication list with title, year, venue, and citation counts.

Input Output Examples

Name	Type	Req	Description
author_id	string	yes	Semantic Scholar Author ID (numeric string, e.g. '1741101')
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
limit	integer	—	Number of results to return (1-100, default: 10)
offset	integer	—	Offset for pagination (default: 0)
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

author_search ~198

Search for authors by name. Returns matching author profiles with h-index, paper count, and affiliation.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
limit	integer	—	Number of results to return (1-100, default: 10)
offset	integer	—	Offset for pagination (default: 0)
query	string	yes	Author name search query.
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_authors ~265

Get the list of authors for a specific paper with author-level details (affiliations, h-index, paper count, citation count).

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
limit	integer	—	Number of results to return (1-100, default: 10)
offset	integer	—	Offset for pagination (default: 0)
paper_id	string	yes	Paper identifier. Accepts: bare S2 Paper ID (40-char hash), DOI:10.xxxx/xxxx, ARXIV:xxxx.xxxx, PMID:nnnnn, PMCID:PMCnnnnn, MAG:nnnnn, ACL:xxx, CorpusId:nnnnn
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_autocomplete ~83

Autocomplete a partial paper title, returning up to 10 suggestions. Use for title disambiguation or quick lookup of papers by partial title.

Input Output Examples

Name	Type	Req	Description
query	string	yes	Partial paper title to autocomplete (max 100 characters).
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_batch ~188

Retrieve details for multiple papers in a single request (up to 500). More efficient than calling paper_get repeatedly. Pass a list of paper IDs in any supported format.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
paper_ids	array	yes	List of paper IDs to retrieve (1-500). Supports all ID formats.
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_citations ~270

Get papers that cite a given paper (forward citations / 'cited by'). Shows which papers reference this work, with influential citation annotations and citation context snippets.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
limit	integer	—	Number of results to return (1-100, default: 10)
offset	integer	—	Offset for pagination (default: 0)
paper_id	string	yes	Paper identifier. Accepts: bare S2 Paper ID (40-char hash), DOI:10.xxxx/xxxx, ARXIV:xxxx.xxxx, PMID:nnnnn, PMCID:PMCnnnnn, MAG:nnnnn, ACL:xxx, CorpusId:nnnnn
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_get ~237

Retrieve full details for a single paper by its identifier. Returns title, abstract, authors, venue, year, citation counts, external IDs, open access PDF link, and more.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
paper_id	string	yes	Paper identifier. Accepts: bare S2 Paper ID (40-char hash), DOI:10.xxxx/xxxx, ARXIV:xxxx.xxxx, PMID:nnnnn, PMCID:PMCnnnnn, MAG:nnnnn, ACL:xxx, CorpusId:nnnnn
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_match ~181

Find the single best paper matching a given title string. Useful for resolving a known paper title to its Semantic Scholar ID and metadata. More precise than keyword search when you know the exact title.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
query	string	yes	The paper title to match.
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_references ~263

Get papers cited by a given paper (its bibliography / reference list). Shows what this paper references, with influential citation annotations.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
limit	integer	—	Number of results to return (1-100, default: 10)
offset	integer	—	Offset for pagination (default: 0)
paper_id	string	yes	Paper identifier. Accepts: bare S2 Paper ID (40-char hash), DOI:10.xxxx/xxxx, ARXIV:xxxx.xxxx, PMID:nnnnn, PMCID:PMCnnnnn, MAG:nnnnn, ACL:xxx, CorpusId:nnnnn
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

paper_search ~468

Search for academic papers by keyword across 200M+ papers in the Semantic Scholar corpus. Supports filtering by year range, venue, field of study, open access, citation count, and publication type. Results are ranked by relevance.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
fieldsOfStudy	string	—	Comma-separated fields of study, e.g. 'Computer Science,Medicine'. Valid values: Computer Science, Medicine, Physics, Mathematics, Biology, Chemistry, etc.
limit	integer	—	Number of results to return (1-100, default: 10)
minCitationCount	integer	—	Minimum number of citations a paper must have.
offset	integer	—	Offset for pagination (default: 0)
openAccessPdf	boolean	—	If true, only return papers with an open access PDF available.
publicationDateOrYear	string	—	Filter by publication date. Supports ranges: '2019-03-05:2020-06-15', '2019-03:', ':2020-06'.
publicationTypes	string	—	Comma-separated publication types: JournalArticle, Conference, Review, Book, BookSection, Preprint, LettersAndComments, ClinicalTrial, CaseReport, Editorial, News.
query	string	yes	Search query string. Supports phrases with quotes and boolean operators.
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data
venue	string	—	Filter by publication venue name, e.g. 'Nature', 'NeurIPS', 'ICLR'. Comma-separated for multiple.
year	string	—	Year filter. Single year '2023' or range '2020-2023'. Also supports open ranges: '2020-' or '-2023'.

No output schema declared.

No examples provided.

paper_search_bulk ~341

Bulk-search papers with cursor-based pagination for retrieving large result sets (up to 10M results). Returns a continuation token to fetch subsequent pages. Use for systematic literature collection.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
fieldsOfStudy	string	—	Fields of study, comma-separated.
limit	integer	—	Results per page (1-1000, default: 100).
minCitationCount	integer	—	Minimum citation count.
openAccessPdf	boolean	—	Only open access papers.
publicationTypes	string	—	Publication types, comma-separated.
query	string	yes	Search query string.
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data
sort	string	—	Sort order: 'citationCount' (desc), 'publicationDate' (desc), or 'paperId' (asc). Default: relevance.
token	string	—	Continuation token from a previous bulk search response to get next page.
venue	string	—	Venue filter, comma-separated.
year	string	—	Year filter, e.g. '2020' or '2018-2023'.

No output schema declared.

No examples provided.

recommendations_for_paper ~295

Get papers recommended as similar or related to a given paper, using Semantic Scholar's machine learning recommendation engine. Choose 'recent' pool for latest papers or 'all-cs' for all Computer Science papers.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
from	string	—	Recommendation pool: 'recent' for recently added papers (default), 'all-cs' for all Computer Science papers.
limit	integer	—	Number of recommendations to return (1-500, default: 10).
paper_id	string	yes	Paper identifier. Accepts: bare S2 Paper ID (40-char hash), DOI:10.xxxx/xxxx, ARXIV:xxxx.xxxx, PMID:nnnnn, PMCID:PMCnnnnn, MAG:nnnnn, ACL:xxx, CorpusId:nnnnn
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

recommendations_from_lists ~258

Get paper recommendations based on a list of positive example papers (papers you like) and optional negative examples (papers to avoid). Useful for discovering papers in a specific research niche or building a reading list.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated fields to return, overriding defaults. Paper fields: paperId, title, abstract, authors, year, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fie…
limit	integer	—	Number of recommendations to return (1-500, default: 10).
negative_paper_ids	array	—	Optional list of paper IDs to steer away from (0-100). These are used as negative examples.
positive_paper_ids	array	yes	List of paper IDs the user finds relevant/interesting (1-100). These are used as positive examples for the recommendation engine.
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

snippet_search ~164

Search for text snippets from within paper bodies (not just titles and abstracts). Returns matching text passages with section labels and the papers they come from. Useful for finding papers that discuss specific methods, datasets, or concepts in detail.

Input Output Examples

Name	Type	Req	Description
fields	string	—	Comma-separated paper fields to include with each snippet. E.g. 'paperId,title,year,authors,url,citationCount'. Default includes paperId, title, year, authors, url.
limit	integer	—	Number of snippet results to return (1-1000, default: 10).
query	string	yes	Text to search for within paper bodies.
response_format	string	—	Output format: 'markdown' for human-readable text (default), 'json' for raw structured data

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug