Skip to main content
Glama
JOSETRA44

scopus-mcp

by JOSETRA44
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNoLogging verbosity: DEBUG, INFO, WARNING, ERROR (default: INFO)
SCOPUS_API_KEYYesYour Elsevier API key (required)
SCOPUS_CACHE_TTLNoCache TTL in seconds (default: 300, set 0 to disable)
SCOPUS_INST_TOKENNoInstitutional token for off-campus/full-text access
SCOPUS_MAX_RETRIESNoMax retries on rate-limit errors (default: 3)

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
scopus_searchA

Search the Scopus academic database for papers using Boolean query syntax.

Common field codes:

  • TITLE-ABS-KEY(term) — search title, abstract, and keywords (most useful)

  • TITLE(term) — title only

  • AUTH(name) — author name, e.g. AUTH("Smith J")

  • AFFIL(institution) — author affiliation

  • PUBYEAR > 2020 — filter by publication year

  • DOCTYPE(ar) — document type: ar=article, re=review, cp=conference paper

Boolean operators: AND, OR, AND NOT Example: TITLE-ABS-KEY("machine learning" AND cancer) AND PUBYEAR > 2020

Read the scopus://search-syntax resource for the full syntax reference.

scopus_search_authorsA

Search for author profiles in the Scopus author index.

Query field codes:

  • AUTHLASTNAME(Smith) — last name

  • AUTHFIRST(John) — first name or initials

  • ORCID(0000-0002-1234-5678) — ORCID identifier

  • AF-ID(60027950) — affiliation ID

Example: AUTHLASTNAME(Smith) AND AUTHFIRST(J) AND AFFIL(MIT)

Use scopus_get_author with the returned author_id to fetch full metrics.

scopus_search_affiliationsA

Search for institution and affiliation records in Scopus.

Query examples:

  • AFFIL(MIT) — by name keyword

  • AFFIL(Harvard) AND COUNTRY(United States)

  • AFFIL-ID(60027950) — by Scopus affiliation ID

Returns affiliation_id needed for author searches and filtering.

scopus_get_abstractA

Retrieve full paper details from Scopus using any supported identifier.

Identifier types:

  • scopus_id — Scopus internal numeric ID (e.g. "85123456789")

  • doi — Digital Object Identifier (e.g. "10.1016/j.labeco.2024.102505")

  • eid — Electronic ID (e.g. "2-s2.0-85123456789")

  • pubmed_id — PubMed/MEDLINE numeric ID

Returns: title, full abstract, authors with affiliations, keywords, subject areas, citation count, DOI, and open access status.

scopus_get_authorA

Retrieve a researcher's full Scopus profile by their Scopus Author ID.

Returns: h-index, total citation count, document count, current institutional affiliation, subject areas, ORCID (if available), and publication year range.

To find an author's ID, first use scopus_search_authors. Example author IDs: '7401234567' or '57209123456'.

scopus_get_citation_countA

Get the current total citation count for a paper.

Provide either a Scopus ID or a DOI — at least one is required. This endpoint is lightweight and cached; use it for quick citation lookups without fetching the full abstract.

scopus_get_citations_overviewA

Get a year-by-year citation timeline for a paper.

Returns how many times the paper was cited in each calendar year within the specified date range. Useful for tracking research impact and citation trends over time.

Requires a Scopus ID. Use scopus_search or scopus_get_abstract first to obtain the scopus_id.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Scopus Search Syntax GuideComplete reference for Scopus Boolean query syntax: field codes, operators, wildcards, document types, subject areas, and examples.
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored across 7 tools

Disambiguation5/5

Each tool targets a distinct operation: paper retrieval, author profiles, citation count, citation timeline, paper search, affiliation search, and author search. No two tools overlap in purpose.

Naming Consistency5/5

All tools follow the consistent pattern 'scopus_<verb>_<noun>' (e.g., scopus_get_abstract, scopus_search_authors). No mixing of styles or irregular names.

Tool Count5/5

7 tools is a reasonable number for a Scopus API wrapper, covering search, retrieval, and citation tracking without being overwhelming or insufficient.

Completeness4/5

The tool set covers core Scopus operations (search, retrieve abstracts/authors, citation info). Minor gaps like pagination for large result sets or listing citing papers are absent but not critical for basic use.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources