Skip to main content
Glama

scopus-mcp

npm version Node.js License: MIT

An MCP server for the Elsevier Scopus API. Runs over stdio with npx and keeps the API's parameter names and JSON responses.

Quick start

Requires Node.js 22.22.0 or newer, npm, and an MCP client with stdio support. Get an API key from the Elsevier Developer Portal and add this server to your client's configuration:

{
  "mcpServers": {
    "scopus": {
      "command": "npx",
      "args": ["-y", "scopus-mcp"],
      "env": {
        "ELSEVIER_API_KEY": "your-elsevier-api-key"
      }
    }
  }
}

Reload the client to connect. To pin a release, use scopus-mcp@<version> in args.

Related MCP server: openrhyme-mcp

Configuration

Environment variable

Description

ELSEVIER_API_KEY

Required for all tools except subject_classifications.

ELSEVIER_INST_TOKEN

Institutional token, if provided by your institution.

Set credentials in the client's env object. The server does not load .env files. Access to data and views depends on your Elsevier subscription and institutional access.

The server reports its version in MCP serverInfo and the startup log on stderr.

Tools

Tool

Description

scopus_search

Find publications.

author_search

Find authors and co-authors.

affiliation_search

Find institutions.

author_retrieval

Get author profiles by ID, EID, or ORCID.

affiliation_retrieval

Get an institution profile by ID or EID.

citation_overview

Get yearly citation counts and summaries.

plumx_metrics

Get publication metrics by identifier.

subject_classifications

Look up subject codes; no API key needed.

Each call makes one API request. For additional pages, use the tool's pagination parameters. Requests support cancellation and a 30-second timeout; retries and redirects are not automatic.

Responses and errors

Results follow each tool's outputSchema. The original API JSON is returned in both structuredContent and a text content block, without reshaping fields or converting values.

Available quota headers are returned as strings in _meta["scopus-mcp/headers"]: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and Retry-After.

API failures return isError: true and a JSON text error with code, message, and, when available, an HTTP status. Credentials are redacted. Invalid arguments are rejected before an API request.

Error

What to check

MISSING_API_KEY

Set ELSEVIER_API_KEY in the server's environment.

HTTP 401 or 403

Check your key, subscription, institutional network, and token.

HTTP 429

Check quota headers and Retry-After before retrying.

TIMEOUT or NETWORK_ERROR

Check connectivity to api.elsevier.com.

INVALID_RESPONSE

Elsevier returned invalid JSON or an unexpected response shape.

API documentation

Development

See Contributing for local setup and changes, and Releases for publishing.

License

MIT © 2026 Andrii Baran. Independent project, not affiliated with Elsevier.

Available Tools

8 tools
affiliation_retrievalAffiliation RetrievalA
Read-onlyIdempotent

Retrieve a Scopus institution profile by affiliation_id or eid. Returns the original Elsevier JSON, including profile data or one page of related documents/authors when requested through view. Access depends on entitlements; no linked records or additional pages are fetched automatically.

Inputs: eid, ver, view, field, +4 more. Returns: affiliation-retrieval-response

author_retrievalAuthor RetrievalA
Read-onlyIdempotent

Retrieve Scopus author profiles by author_id, eid, or orcid. Comma-separated author_id or eid values use one native batch request. Returns the original Elsevier JSON; view access depends on entitlements. Pagination and superseded-profile resolution are explicit.

Inputs: eid, ver, view, alias, +6 more. Returns: author-retrieval-response, author-retrieval-response-list

citation_overviewCitation OverviewA
Read-onlyIdempotent

Retrieve yearly citation counts and summaries for Scopus documents. Supply one native document identifier type, with comma-separated values for multiple documents. Returns the original Elsevier JSON in one request. Citation Overview access must be enabled for your API key.

Inputs: doi, pii, ver, date, +10 more. Returns: abstract-citations-response

plumx_metricsPlumX MetricsA
Read-onlyIdempotent

Retrieve native PlumX metrics for one publication or artifact by identifier. Returns the original Elsevier JSON, including metric categories, count types and sources. Requires active Scopus access. HTTP 404 can mean that no metrics are available or that the identifier is unknown.

Inputs: idType (required), idValue (required), reqId. Returns: id_type, id_value, count_categories

subject_classificationsScopus Subject ClassificationsA
Read-onlyIdempotent

Retrieve or filter Scopus subject classifications. Returns the original Elsevier JSON, including subject codes, descriptions, details, and abbreviations. Omit filters to list all classifications. This public endpoint does not require an API key.

Inputs: code, field, abbrev, detail, +1 more. Returns: subject-classifications

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool pairs a distinct entity with a distinct action: author_search/author_retrieval and affiliation_search/affiliation_retrieval are cleanly separated by query-vs-id, and citation_overview, plumx_metrics, scopus_search, and subject_classifications each target unique resources. There is no meaningful overlap that would cause misselection.

    Naming Consistency4/5

    Most tools follow a predictable entity_action pattern (author_search, affiliation_retrieval, scopus_search, etc.), which is easy to parse. However, citation_overview, plumx_metrics, and subject_classifications are noun-only with no verb, a minor deviation from the dominant convention.

    Tool Count5/5

    Eight tools is well-scoped for a Scopus API wrapper, with two search/retrieve pairs for authors and affiliations plus publication search, citations, metrics, and classifications. Each tool earns its place without redundancy.

    Completeness4/5

    Coverage is broad: search and retrieval for authors and affiliations, publication search, citation overview, PlumX metrics, and subject classifications. The main gap is a document-level retrieval tool (e.g., fetch a specific publication by DOI/EID), which agents must currently work around.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides access to the Elsevier Scopus API, enabling AI assistants to search for academic papers, retrieve detailed abstracts, and look up author profiles. It facilitates bibliometric research and scholarly data analysis through natural language commands.
      5
      177 PyPI
      55
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables any MCP-compatible agent to query a local OpenRhyme activity timeline, search history, and issue control commands over stdio while keeping all data on-machine.
      5
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to connect to Agenzax's REST API over stdio, providing tools for messaging, session management, and review-mode oversight.
      18
      135 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides a runnable local stdio Python server scaffold that coding agents extend into custom tool integrations by describing an idea and letting the agent investigate, build, test, and install it. Ships with no prebuilt tools, so it enables guided, agent-assisted creation of MCP tools connected to external APIs, databases, or websites while writes stay disabled until explicitly agreed.
      1
      MIT