Citation Network MCP
Citation-network analysis for Claude and other AI assistants, on Scopus or OpenAlex.
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, and multi-generation citation lineages with main-path analysis, exported as GraphML for VOSviewer or Gephi.
- 🔀 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. 167 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.
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 |
| 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
citation-network-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/citation-network-mcp
claude plugin install citation-network-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": {
"citation-network": {
"command": "uvx",
"args": ["citation-network-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 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.
Metadata
Release files for citation-network-mcp 0.14.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 | |
|---|---|---|---|
| citation_network_mcp-0.14.0.tar.gz | 302.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| citation_network_mcp-0.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 385.3 kB
Release files / citation_network_mcp-0.14.0.tar.gz
| Download URL | citation_network_mcp-0.14.0.tar.gz |
|---|---|
| Size | 302.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
459e5fdb10f8167314cec988633a4d40bc5602e40146225169498944df9bec80
|
|
BLAKE2b-256 checksum How to use checksums |
4e7333e946b0e62389a9c4e36ccbafe6444a0ec07dda66b04cf8eb8a8f44a089
|
| 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 / citation_network_mcp-0.14.0-py3-none-any.whl
| Download URL | citation_network_mcp-0.14.0-py3-none-any.whl |
|---|---|
| Size | 82.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
285932f902a32fc0a99b869e32d51b7b86c865e664862f68c6cb9ca4ab2086eb
|
|
BLAKE2b-256 checksum How to use checksums |
6ab4ab6476ee7b34fe9db1a66afeda9ff3f9bd8c47d2106083173009d07b6562
|
| 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