A deterministic, reusable MCP substrate for scholarly publication retrieval.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"scholarly-gateway-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# scholarly-gateway-mcp [](https://github.com/curtis-d-williams/scholarly-gateway-mcp/actions/workflows/ci.yml) A reusable MCP (Model Context Protocol) server that provides a deterministic, provenance-aware gateway to scholarly publication sources. The V1 contract is frozen; behavior and tool schemas are stable and will not change without an explicit contract revision. ## Start here - [Integration Guide](docs/INTEGRATION_GUIDE.md) — what this server is, quickstart, canonical tool call patterns, provider_status interpretation, and a reproducibility checklist - [Examples](docs/EXAMPLES.md) — three canonical workflows: single-provider lookup, multi-provider query with not_supported handling, and re-run determinism verification - [Troubleshooting](docs/TROUBLESHOOTING.md) — top failure modes with contract-aligned resolution steps ## V1 Contract Authoritative spec: [docs/V1_CONTRACT.md](docs/V1_CONTRACT.md) ## Governance - [CONTRIBUTING.md](CONTRIBUTING.md) — PR types, determinism rules, contract rule, and how to propose new features - [docs/GOVERNANCE.md](docs/GOVERNANCE.md) — authority model, change control, versioning doctrine, and release checklist ## Setup (dev) python3 -m venv .venv source .venv/bin/activate pip install -U pip pip install -e ".[dev]" pytest -q ## Install For local development (editable install): pip install -e ".[dev]" For a regular install: pip install . ## Run scholarly-gateway ## Configuration Environment variables: - SCHOLARLY_GATEWAY_DB_PATH (optional): path to SQLite DB file used for cross-session lookup persistence. - Default: ./.data/scholarly_gateway.db
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.