journal-scout-mcp
Search and analyze scholarly literature across multiple sources, with merged results, citation lookup, and Scopus/SciVal metadata.
Unified search: Search all configured journal sources in parallel, merge duplicates by DOI/title, and filter by sources, year range, tech-only, and per-source limit.
Per-source search: Query Scopus, arXiv, OpenAlex, Semantic Scholar, Crossref, or dblp individually with the same filters.
Paper resolution: Resolve a DOI, arXiv ID, Scopus ID, or OpenAlex ID across sources, merge metadata, and attach open-access links.
Citation lookup: Collect a cross-source citation graph for one paper from Scopus, OpenAlex, and Semantic Scholar, with a configurable limit.
Scopus details: Retrieve abstract details for a Scopus ID, fetch author profiles, and check Scopus API quota status.
SciVal analytics: Look up authors/institutions and retrieve author, institution, or topic metrics with optional year ranges.
Note: the provided schema exposes these 17 tools and is narrower than the README’s full 43-tool set; it does not include the README’s abstract/fulltext/export/network/metrics/SLR tools.
Searches arXiv for scholarly papers and retrieves metadata, abstracts, and open-access links.
Searches DBLP for computer science publications and their metadata.
Searches Scopus for scholarly articles and provides abstract details, author profiles, and quota status.
Searches Semantic Scholar for papers, metadata, abstracts, citations, and open-access links.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@journal-scout-mcp search for recent papers on CRISPR gene editing across all sources"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
journal-scout
Multi-source journal research MCP server. Searches Scopus, arXiv, OpenAlex, Crossref, PubMed, Consensus, and Garuda, then merges duplicate results into one entry per paper (DOI-first dedup) and reports partial failures. Unpaywall resolves open-access copies and OpenCitations supplies citation links.
It also builds Connected-Papers-style citation networks (direct citations,
bibliographic coupling, co-citation) and computes Publish-or-Perish style
bibliometrics, and ships a browser UI (josc-web).
Citation links come from OpenCitations as well: 300M+ DOI-to-DOI links, free, no API key, no approval. It is not a searchable source — it only answers citation and reference queries for a known DOI or OpenCitations id.
Tools (43)
Unified (11) | Papers & abstracts (5) | Per-source (8) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
| |
|
| |
| ||
| ||
|
Scopus detail (3) | SciVal (5) | Local archive (2) |
|
|
|
|
|
|
|
| |
| ||
|
Keys (1) | SLR pipeline (8) |
|
|
search_all accepts a topic filter. It runs after the merge and keeps
records whose topics contain the text (case-insensitive substring). It is
deliberately not pushed down to providers: OpenAlex concepts, Crossref
subjects, and PubMed MeSH share no vocabulary, so a local pass costs zero
extra requests and gives one consistent semantic.
Abstract resolution
get_paper_abstract resolves the abstract of one paper (by DOI, another
identifier, or title) across every lookup-capable provider. get_abstracts
fills missing abstracts in a list of paper dicts, such as search_all
results. Both keep the not_found status with a null abstract when no source
has one; nothing is guessed from the title, and an existing abstract is never
overwritten. Provider errors and timeouts are reported per source instead of
aborting the batch.
Full text (open access only)
get_fulltext resolves one identifier through the same lookup path as
get_paper (including the Unpaywall enricher), downloads the best open-access
PDF, and returns its extracted text. arXiv records without a resolved PDF link
fall back to https://arxiv.org/pdf/<id>.
Field | Meaning |
|
|
| Extracted text, capped by |
| True when the source text was longer than |
| Download or extraction failure reason, for |
Extraction needs pypdf, which ships in the pdf extra
(pip install "journal-scout[pdf]") and is installed in the Docker image. A
server without it returns status="error" with an install hint rather than an
empty string. This is not a paywall bypass: a paper with no OA copy reports
no_oa.
Batch lookup
batch_lookup resolves a list of identifiers (DOI, arXiv id, OpenAlex id) in
one call. OpenAlex accepts pipe-separated OR filters (doi:A|B,
openalex:W1|W2) and arXiv accepts a native id_list, so those two answer a
whole batch with a single request each. Providers without a batch endpoint fall
back to one get per identifier, concurrently.
Field | Meaning |
| Resolved records in the same order as |
|
|
| Identifiers no provider recognised |
| Per-provider failure message; other providers still contribute |
Pass sources to restrict the lookup to specific providers. Enrichers such as
Unpaywall are skipped here — they need a DOI and add no lookup value.
Topic classify
topic_classify ranks OpenAlex taxonomy entries that best match free text —
a title, abstract, or research question. Short labels match the taxonomy
search directly; longer text that the taxonomy endpoint cannot match falls
back to aggregating the assigned topics of matching works. Each candidate
carries a relevance score, work counts, keywords, and the full
domain → field → subfield → topic path.
Field | Meaning |
| Required: the text to classify |
|
|
| Candidates to return, best first (default 5) |
Export
export_results renders any list of paper dicts in one of 17 formats:
apa, bibtex, chicago, csiro, csv, csv_bom, csv_header,
csv_plain, endnote, harvard, isi, json, mla, ris, vancouver,
xls, xls_plain. The same engine is exposed over HTTP as POST /api/export.
Citation networks
build_citation_network resolves the seed paper, fetches its references and
citing papers from every capable source, then fetches the reference lists of
the top citing papers to derive three edge types:
Edge | Meaning |
| Direct citation (seed → reference, citing paper → seed) |
| Bibliographic coupling: references shared with the seed |
| Co-citation: reference pairs appearing together in citing papers |
Pass graph_format="graphml" to get a Gephi/VOSviewer file instead of JSON.
get_references exposes just the merged reference list of one paper.
Providers that answer citation queries: OpenAlex, Crossref and OpenCitations. OpenCitations adds links the others miss (and vice versa), and its metadata is resolved through the OpenCitations Meta API with a Crossref batch fallback, so a paper is returned even when one of the two cannot describe it.
Metrics
compute_metrics accepts either author or query and returns papers, total
citations, h-index, i10-index, g-index, max/mean citations, and citation
velocity over the merged multi-source result set. mode="extended" adds the
Publish-or-Perish indices: hc_index, hI_index (Batista), hI_norm,
hm_index (Schreiber), AWCR, AW_index, AWCRpA, plus citation ratios.
Related MCP server: trove-mcp
Config
Copy config.json.example to config.json. Only the Elsevier api_key is
required; the other sources work without a key. polite_email improves rate
limits on OpenAlex, Crossref, and Unpaywall.
search_exa searches the web through Exa's public MCP endpoint
(https://mcp.exa.ai/mcp); it needs no API key. If EXA_API_KEYS (or
EXA_API_KEY) is set, pass a comma- or semicolon-separated list or a JSON
array to rotate across keys round-robin, and an HTTP 401/429 moves the client
to the next key. Keys are read from the environment only, so no file inside
the container is written. Exa answers with plain text rather than JSON; the
provider parses the Title / URL / Published / Author / Highlights
blocks and uses Highlights as the abstract.
Consensus keys work the same way: set CONSENSUS_API_KEYS to a list (or
CONSENSUS_API_KEY for a single key) and the provider rotates on 401/429.
The free tier has a monthly quota: once it is spent the API replies 429 with
code: "hard_cap_reached", and that explanation is passed through in the
tool's errors instead of a bare status code.
Rate limits
Source | Limit |
Scopus | Weekly quota, tracked via |
OpenAlex | 100,000 requests/day (polite pool) |
Crossref | Polite pool, no hard cap |
PubMed | 3 requests/second without a key, 10 with |
arXiv | 1 request per 3 seconds |
Consensus | Per-account quota; rotate keys on 401/429 |
OpenCitations | 180 requests/minute |
Unpaywall | 100,000 requests/day |
Remote MCP server
The MCP server can run as a standalone Streamable HTTP service for remote MCP clients. One image serves both surfaces:
Path | Purpose |
| The |
| REST API used by the browser UI |
| Streamable HTTP MCP endpoint |
| Unauthenticated container health check |
The Docker image builds the frontend in a node:22-alpine stage and listens on
port 8080. Configure JOSC_MCP_TOKEN to enforce bearer-token authentication
on /mcp; the UI and /healthz stay public. The stdio transport remains the
default when running from source.
docker build -t journal-scout .
docker run --rm -p 8080:8080 \
-e JOSC_MCP_TOKEN="$(openssl rand -hex 32)" \
journal-scoutConfigure remote MCP clients with URL https://<your-domain>/mcp and send
Authorization: Bearer <token> when authentication is enabled. The plugin's
.mcp.json points at the hosted server via type: "http"; use
.mcp.remote.json.example as a client config template.
Environment variables:
Variable | Default | Purpose |
|
| Set |
|
| HTTP bind address |
|
| HTTP listen port |
| unset | Optional bearer token; set it for public deployments |
josc-web
web/ is a Vite + React 19 + TanStack Router + Tailwind 4 app that talks to a
thin Starlette API (src/josc/api/) over the same aggregator the MCP server
uses.
pip install -e ".[web]"
cd web && npm install && npm run build && cd ..
josc-web # serves the API and the built UI on :8793For UI development, run npm run dev inside web/ (Vite proxies /api to
127.0.0.1:8793).
Endpoint | Purpose |
| Provider list and capability flags |
| Scopus quota state |
| Fan-out search, optional post-merge topic filter |
| Author search |
| Resolve one paper |
| Citing papers |
| Reference list |
| Related works (OpenAlex) |
| Citation network |
| Bibliometric summary |
| Metrics as CSV / report |
| Recorded search history |
| Import / export history archives |
| Re-run, split, or copy a saved search |
| Delete a saved search |
| Import BibTeX / RIS / CSV records |
| Cache control and telemetry |
| Merge an external record list |
| GraphML download |
| Bibliography export (JSON body: |
The UI has four routes: / (search), /graph, /metrics, and /history
(the recorded search list, with replay, split, duplicate, export, and import).
Objectives
Search 8 scholarly databases from one MCP server, plus OpenCitations for citation links on any DOI.
Merge duplicates by DOI-first dedup.
Resolve abstracts for one paper or a whole result list from all available sources.
Report partial failures (per-source) so callers never get a 500 for one blackholed API.
Degrade gracefully where entitlements are missing (e.g. Scopus
view=FULL).Map citation structure with coupling/co-citation and export it to GraphML.
Development
uv venv
uv pip install -e ".[dev]"
pytestLicense
MIT. See LICENSE.
Available Tools
17 toolsget_abstract_detailsC
Scopus abstract details for a Scopus id.
Inputs: scopus_id (required).
get_author_profileD
Scopus author profile.
Inputs: author_id (required).
get_citationsC
Collect the cross-source citation graph (Scopus + OpenAlex + Semantic Scholar) for one paper.
Inputs: identifier (required), limit.
get_paperA
Resolve a DOI/arXiv/Scopus/OpenAlex id across sources, merge metadata, and attach open-access links.
Inputs: identifier (required).
get_quota_statusC
Scopus API quota status.
Inputs: no named parameters.
scival_author_lookupB
SciVal author lookup by name.
Inputs: query (required), count.
scival_author_metricsD
SciVal author metrics.
Inputs: author_id (required), year_to, year_from.
scival_institution_lookupC
SciVal institution lookup by name.
Inputs: query (required), count.
scival_institution_metricsD
SciVal institution metrics.
Inputs: institution_id (required), year_to, year_from.
scival_topic_metricsD
SciVal topic metrics.
Inputs: topic_id (required), year_to, year_from.
search_allB
Search all journal sources in parallel and merge duplicate results by DOI/title.
Inputs: query (required), sources, year_to, tech_only, +2 more.
search_arxivB
Search arxiv only.
Inputs: query (required), count, year_to, tech_only, +1 more.
search_crossrefC
Search crossref only.
Inputs: query (required), count, year_to, tech_only, +1 more.
search_dblpC
Search dblp only.
Inputs: query (required), count, year_to, tech_only, +1 more.
search_openalexD
Search openalex only.
Inputs: query (required), count, year_to, tech_only, +1 more.
search_scopusC
Search scopus only.
Inputs: query (required), count, year_to, tech_only, +1 more.
search_semanticscholarC
Search semanticscholar only.
Inputs: query (required), count, year_to, tech_only, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Some tools have overlapping purposes: get_author_profile and scival_author_lookup both retrieve author information but from different systems, and get_paper vs get_abstract_details both resolve paper metadata. The individual search_* tools are clearly distinct by source, but the SciVal metrics vs lookup tools may confuse an agent. Overall, boundaries are mostly clear but not every tool has a sharply distinct role.
The search_* and get_* tools follow a consistent verb_noun pattern, but the scival_* tools break this by using a noun_prefix with no verb (e.g., scival_author_metrics vs. get_scival_author_metrics). Within the scival group naming is consistent, but mixing two conventions across the server reduces predictability. The pattern is readable but not uniform.
At 17 tools, the count is slightly above the typical 3-15 sweet spot but still well-scoped for a multi-source scholarly search and metrics server. The number feels justified given the many supported APIs (Scopus, arXiv, OpenAlex, etc.) and SciVal's separate lookups/metrics. It is not excessive and each tool appears to serve a plausible need.
The surface covers the core academic search workflow: combined and source-specific searches, paper resolution, citation graph, author profiles, and SciVal metrics. Minor gaps exist, such as no direct full-text retrieval (only open-access links) and no journal-level search or repository export functionality, but these are not critical for the apparent purpose. Agents can accomplish typical research tasks without dead ends.
Maintenance
Related MCP Connectors
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Scholarly search: OpenAlex, Crossref, arXiv, OpenCitations and PubMed in one endpoint.
Academic paper search, scientific literature, citation analysis, arXiv & semantic related-work.
Search 340M+ academic papers — citation graphs, semantic similarity, and AI literature reviews.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables searching, downloading, and exporting academic papers from 20+ scholarly sources including arXiv, PubMed, and Semantic Scholar. Supports multi-source concurrent search, citation network tracing, and export to CSV, RIS, and BibTeX.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to search and analyze academic papers from multiple sources, fetch metadata and full text, and build structured outputs like literature maps and paper comparisons.77 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables searching Elsevier's Scopus database for scientific literature, retrieving abstracts and metadata, and exporting results in RIS or BibTeX format.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and exploring 340 million academic papers from 15+ databases with semantic search, citation graphs, and knowledge graph connections for biomedical entities.1MIT