Skip to main content

Scopus Plus MCP

The Scopus MCP server that goes further: search, full text, citation networks, journal quality and bibliometrics, for Claude and other AI assistants.

Tests PyPI Python 3.10+ License: MIT

Search the literature, trace who cites whom across generations, map research fronts and intellectual bases, and pull the counts, metrics and bibliography you need, from a conversation. It is an MCP server, so any MCP client can use it: Claude Desktop, Claude Code, Cursor.

  • 🕸️ Citation networks. Bibliographic coupling, co-citation, multi-generation citation lineages, and the citation network within any set of papers, with SPC/SPLC/SPNP main paths and key routes, RPYS and a historiograph, exported for Pajek, VOSviewer or Gephi.
  • 🧾 Audited, not just built. Citer sets verified across search strategies, reference lists checked against Crossref for gaps, and the sentences behind each citation, with their intent, from Semantic Scholar.
  • 🔀 Two data sources. Scopus by default; add source="openalex" to run the same analyses without a Scopus subscription.
  • 📊 Bibliometrics. Where a topic is published and in which quartile per field; journals above a percentile cut-off in chosen categories; publications per year; journal metrics; BibTeX for any list of papers.
  • 🔎 Full-text search. Find Elsevier papers that use a term in their body, and see how often and where each one uses it.
  • 🩺 Honest about access. One call tells you which tools your current Scopus access supports, and why the rest fail.
  • ✅ Tested. 510 test functions, CI on Linux, macOS and Windows, and a live check of every tool against the real APIs.

How it compares with the other Scopus MCP servers and with bibliometrics packages (bibliometrix, pybliometrics, VOSviewer, Pajek, ...): comparison.

Ask things like

Map the research front around these six papers on organizing visions.

Trace two generations of work citing Swanson & Ramiller (1997) and show me the main path.

Build the citation network of every Basket of Eight paper citing the organizing-vision papers, and show how the main path cites its predecessors.

How has publishing on "digital transformation" grown since 2010?

Get SJR and CiteScore for the Basket of Eight, and BibTeX for the papers we just found.

Tools

Search and records search_scopus · search_all · search_fulltext · get_abstract_details · resolve_identifier · search_authors · get_author_profile · get_fulltext
Citations get_references · get_citing_papers
Networks bibliographic_coupling · co_citation · citation_lineage · citation_network · historiograph · rpys · research_fronts
Audit resolve_citers · citation_context · path_transmission · coding_agreement · index_coverage · check_retractions
Bibliometrics publication_counts · topic_landscape · thematic_evolution · get_journal_metrics · find_journals · get_bibtex · import_records
Diagnostics and jobs diagnose_connection · get_quota_status · get_server_info · job_status · job_result

Parameters and details for each: tool reference.

Install

You need an API key from the Elsevier Developer Portal (register with your institutional email). OpenAlex needs no key.

Claude Desktop — one click:

  1. Download scopus-plus-mcp-<version>.mcpb from the latest release.
  2. Open it (or drag it into Settings → Extensions), click Install, and paste your API key when asked. Claude stores it securely.

Claude Code — two commands:

claude plugin marketplace add michalhron/scopus-plus-mcp
claude plugin install scopus-plus-mcp@michalhron

Then make your key available, either in your shell (export SCOPUS_API_KEY=...) or, better, in the OS secret store.

Any other MCP client (needs uv):

{
  "mcpServers": {
    "scopus-plus": {
      "command": "uvx",
      "args": ["scopus-plus-mcp"],
      "env": { "SCOPUS_API_KEY": "YOUR_KEY" }
    }
  }
}

Then ask your assistant to run diagnose_connection: it checks your key and tells you which tools your Scopus access supports.

Documentation

Tool reference Every tool and parameter, generated from the code
Data sources Scopus vs OpenAlex: when to use which, measured coverage
Configuration All settings; keeping keys in the OS secret store
Access and troubleshooting Off-campus access, tokens, proxies, reading diagnose_connection
Comparison This project vs the other Scopus MCP servers, and vs bibliometrics packages
Development Tests, live smoke tests, releases
Prompt examples · Changelog · Roadmap

Origins

Formerly citation-network-mcp (and before that michalhron/scopus-mcp). This project began as a fork of qwe4559999/scopus-mcp by thinktraveller and qwe4559999, which provides Scopus search, abstracts, author profiles and citing papers. Everything since version 0.2 was developed here by Michal Hron. MIT licensed; see LICENSE.

Scopus and ScienceDirect are trademarks of Elsevier B.V. This project is independent and not affiliated with or endorsed by Elsevier; it uses their public APIs with your own key and subscription.

Metadata

Release files for scopus-plus-mcp 0.24.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scopus-plus-mcp 0.24.0
File Size Uploaded
scopus_plus_mcp-0.24.0.tar.gz 525.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for scopus-plus-mcp 0.24.0
File Interpreter ABI Platform
scopus_plus_mcp-0.24.0-py3-none-any.whl Python 3 none any Details

Total release size: 696.6 kB

Release files / scopus_plus_mcp-0.24.0.tar.gz

Download URL scopus_plus_mcp-0.24.0.tar.gz
Size 525.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a71f79bed3be69cb9c909c507898ad462600fb0da002fb4048d72c4cbaf48f57
BLAKE2b-256 checksum
How to use checksums
9b7422a3a3fb02e927455f6a9e120f991923483561c4ca702c55a10adfad4d5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

Release files / scopus_plus_mcp-0.24.0-py3-none-any.whl

Download URL scopus_plus_mcp-0.24.0-py3-none-any.whl
Size 171.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
efe22541413a4a05c8aaa2921874ba2bfaf1636fb6fb2e1f2a6beb172ec4ff92
BLAKE2b-256 checksum
How to use checksums
77a4f472c9c7601ff9e270db5da97d75c70b7fc1fc80742ae92cb124008b2e0d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.24.0 This release

2 release files

0.23.0

2 release files

0.20.0

2 release files

0.19.0

2 release files

0.18.0

2 release files

0.17.0

2 release files

0.16.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page