Skip to main content
Glama
doaj-discovery-mcp

doaj-discovery-mcp

DOAJ Discovery MCP

Search the Directory of Open Access Journals from any AI client — no account, no API key, no payment

Claude Code compatible Node MCP SDK Tools Transport License

Problem · Tools · Quick Start · Local · Docker · Privacy · Development · Deployment


🎯 The Problem

The DOAJ indexes over 23,000 peer-reviewed open access journals, but finding the right one is manual work. Its API speaks Elasticsearch query syntax — bare multi-word searches are AND-ed together, so a natural-language question or a pasted abstract silently returns nothing. Filtering by article processing charge, licence, publisher country, or language means knowing field paths like bibjson.apc.has_apc and that DOAJ stores "NL" rather than "Netherlands".

Meanwhile, an AI assistant asked "which no-fee journals publish Syriac manuscript studies?" will answer from training data — plausible journal names, stale APC policies, no verifiable links.

This server closes that gap. It translates plain-language questions and manuscript abstracts into valid DOAJ queries, applies real metadata filters server-side, ranks candidates locally, and returns source links for verification.

NOTE

Public beta. Free to use, no uptime SLA. Verify important results on DOAJ and the journal's own website.

IMPORTANT

Independent project. DOAJ Discovery MCP is an independent, unofficial open-source project. It is not affiliated with, endorsed by, sponsored by, or operated by DOAJ.


Related MCP server: nara-mcp-server

🧰 Tools

Eight read-only tools. None performs editorial review, acceptance prediction, compliance checking, or publishing decisions.

Tool

Key inputs

What it does

search_doaj_journals

query, country, language, license, noApcOnly, strict

Journal search with DOAJ-side metadata filters and local lexical ranking

search_doaj_articles

query, limit, strict

Article search with local lexical ranking

recommend_doaj_journals_for_manuscript

abstract, title, preferredLanguage, preferredCountry, noApcOnly

Manuscript-fit discovery candidates from an abstract

find_diamond_oa_journals

query, limit

No-fee journals via the bibjson.apc.has_apc:false filter

find_similar_doaj_articles

abstract, title

Articles similar to a given abstract

get_doaj_journal_by_issn

issn

Direct lookup by print or electronic ISSN

get_doaj_article_by_doi

doi

Direct lookup by DOI

explain_doaj_metadata

term

Explains APC, licence, language, ISSN, diamond OA — fully local, no network call

Every search response includes the effective DOAJ query it ran, the upstream total, and how many results were returned, so you can see and audit what was actually asked.

Why connect this instead of asking directly?

An AI client can query current DOAJ metadata rather than relying on model memory. It can find journal or article candidates, identify no-APC records, rank results for a topic, and preserve links for verification. The connection exposes no private DOAJ data.


🚀 Quick Start

Remote (Streamable HTTP)

No account, API key, or payment required. Add this URL:

https://doaj-discovery-mcp-hbyczavkfq-ew.a.run.app/mcp

Client

Where to add it

Claude (paid plans)

Settings → Connectors → Add custom connector

ChatGPT (Business, Enterprise, Edu)

Settings → Apps, developer mode enabled, created by an authorized admin or developer

Codex / other MCP clients

Add as a remote Streamable HTTP MCP server

Client availability and menu names change. See the current Claude connector guide and ChatGPT developer mode guide.

Local (stdio)

For clients that launch MCP servers as a subprocess:

npm ci && npm run build
{
  "mcpServers": {
    "doaj-discovery": {
      "command": "node",
      "args": ["/absolute/path/to/doaj-discovery-mcp/dist/src/stdio.js"]
    }
  }
}

💻 Run Locally

Requires Node.js 22 or newer.

npm ci
cp .env.example .env
npm run dev

Open http://localhost:3000/. The MCP endpoint is http://localhost:3000/mcp; health is http://localhost:3000/health. For the stdio transport instead, run npm run dev:stdio.

Configuration is documented in .env.example. The public DOAJ API is used without an API key.


🐳 Docker

docker build -t doaj-discovery-mcp .
docker run --rm -p 3000:3000 --env-file .env doaj-discovery-mcp

🔒 Privacy

Do not send confidential, unpublished, personal, or sensitive manuscript text to the public service. Requests pass through Google Cloud and the public DOAJ API. Query text and abstracts are not intentionally persisted by the application, and production caching is disabled. Read PRIVACY.md for details.


🛠 Development

npm run check                 # tests, build, lint, format check
DOAJ_LIVE_TEST=1 npm test     # additionally hit the real DOAJ API
docker build -t doaj-discovery-mcp:local .

The live tests are skipped by default so CI stays hermetic. They exist as a regression guard: a DOAJ query can be syntactically valid and still match zero records, which unit tests with a stubbed fetch cannot detect.

See CONTRIBUTING.md and the MIT License.


☁️ Deployment

Pushes to main are verified by CI and then deployed to Google Cloud Run through keyless Workload Identity Federation. See docs/CLOUD_RUN.md.

Available Tools

8 tools
explain_doaj_metadataExplain DOAJ metadataA
Read-onlyIdempotent

Explain DOAJ metadata terms such as APC, license, language, ISSN, or diamond OA.

Inputs: term (required).

find_diamond_oa_journalsFind diamond OA journalsA
Read-onlyIdempotent

Find no-fee or diamond open-access DOAJ journals.

Inputs: query (required), limit, strict.

find_similar_doaj_articlesFind similar DOAJ articlesB
Read-onlyIdempotent

Find similar articles using local lexical and metadata similarity.

Inputs: abstract (required), limit, title.

get_doaj_article_by_doiGet DOAJ article by DOIA
Read-onlyIdempotent

Look up a single DOAJ-indexed article by its DOI.

Inputs: doi (required).

get_doaj_journal_by_issnGet DOAJ journal by ISSNA
Read-onlyIdempotent

Look up a single DOAJ-indexed journal by its print or electronic ISSN.

Inputs: issn (required).

recommend_doaj_journals_for_manuscriptRecommend DOAJ journals for manuscript fitA
Read-onlyIdempotent

Suggest discovery candidates for a manuscript abstract or topic; not an acceptance prediction.

Inputs: abstract (required), limit, title, noApcOnly, +2 more.

search_doaj_articlesSearch DOAJ articlesA
Read-onlyIdempotent

Find DOAJ-indexed articles using lexical relevance and metadata preferences.

Inputs: query (required), limit, strict.

search_doaj_journalsSearch DOAJ journalsA
Read-onlyIdempotent

Find DOAJ-indexed journals using lexical relevance and metadata preferences.

Inputs: query (required), limit, strict, country, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation4/5

    Tools are mostly distinct, but find_diamond_oa_journals and search_doaj_journals both find journals, and search_doaj_articles vs find_similar_doaj_articles could be confused; descriptions clarify, but some overlap remains.

    Naming Consistency5/5

    All tool names follow the verb_noun pattern with snake_case, using descriptive and consistent nouns (doaj_journals, doaj_articles, doaj_metadata, etc.).

    Tool Count5/5

    8 tools is a well-scoped set for a discovery service, covering search, retrieval, recommendation, and explanation without excess.

    Completeness5/5

    The surface covers the full discovery workflow: searching journals and articles, retrieving by ISSN/DOI, finding similar content, recommending journals, and explaining metadata terms.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables querying the Crossref API to search for academic publications by title, author, or DOI, returning structured metadata about scholarly works.
      3
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Read-only Model Context Protocol server for the US National Archives Catalog API, enabling search and retrieval of archival records, child records, extracted text, comments, and tags.
      7
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server for scholarly tools, enabling AI assistants to interact with scholarly data and services via discoverable tools.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      A Model Context Protocol server for searching and downloading academic papers from multiple free and public sources, enabling LLM-driven academic research workflows.
      57
      MIT