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.
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 main path and key routes, 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. 443 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: 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 |
| Audit | resolve_citers · citation_context |
| Bibliometrics | publication_counts · topic_landscape · get_journal_metrics · find_journals · get_bibtex |
| Diagnostics | diagnose_connection · get_quota_status · get_server_info |
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:
- Download
scopus-plus-mcp-<version>.mcpbfrom the latest release. - 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 |
| 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.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| scopus_plus_mcp-0.17.0.tar.gz | 337.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scopus_plus_mcp-0.17.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 446.7 kB
Release files / scopus_plus_mcp-0.17.0.tar.gz
| Download URL | scopus_plus_mcp-0.17.0.tar.gz |
|---|---|
| Size | 337.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe39ff9ede6f1acd8ae6c087489e135d47727889fe64afa617e6d01df9d53d05
|
|
BLAKE2b-256 checksum How to use checksums |
c28add4926333fc741a586479ef08654236ec9ae508b11377c025a9fb2178a50
|
| 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 logRelease files / scopus_plus_mcp-0.17.0-py3-none-any.whl
| Download URL | scopus_plus_mcp-0.17.0-py3-none-any.whl |
|---|---|
| Size | 109.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
50c114c7581ac182a0d7d142df813c8cbbad258002451d858fa5c6dac7b9051a
|
|
BLAKE2b-256 checksum How to use checksums |
ae673f57297195be20f740e1fdbc3587a39bba7aab2134ce84327e28ddfae84c
|
| 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