OnCo
OnCo: total information dominance on cancer. A public, cited knowledge graph of oncology with a website, JSON API, MCP server and CLI: one page per cancer, treatment, target, trial, institution, person and idea.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/judegomila/OnCo with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/judegomila/OnCo'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/judegomila--onco)HTML
<a href="/listings/judegomila--onco"><img src="/api/listings/judegomila--onco/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 113 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # OnCo: Total information dominance on cancer.
- **Live:** https://onco.cc
- OnCo is an open repository for cancer. The whole corpus, every page, source, drawing, translation and script, is in this repository under an open licence (CC BY-NC 4.0 for the data, MIT for the code), built in public, corrected through issues and pull requests, and free for patients, clinicians, researchers, companies and AI agents to read and reuse. If you know something the site does not, open an issue or a pull request: the gate runs the same checks on every contribution.
- OnCo is a public, cited knowledge graph of oncology, aiming at total information dominance on cancer: every cancer, front, technology, target, biomarker readout, treatment and test, company, institution, person, pathway, trial, key paper, journal, pairing, roadmap, bottleneck and idea, one page each, with a plain-English TL;DR before the technical layer and links in every direction. Readers start in a Global view and pick their country, so "approved" means their regulator's verdict. It exists so that a patient, a carer, a clinician, a scientist, an investor or a policymaker can walk from any object to everything connected to it and see the state of the art, the history, what is being done about each problem, and what is coming.
- The website is one surface. The same corpus ships as:
- - **the site** (https://onco.cc): tables with filters, tooltips on every technical term, molecule and target renderings, animated schematics, a graph explorer, Ask OnCo question answering, a living-with-cancer area (side effects, symptoms, second opinions, hair loss, complementary approaches graded by evidence), coverage of what insurers and the NHS pay for, and a completeness dashboard that states how much of the known world each kind covers;
- - **a static JSON API** under https://onco.cc/api/v1/ with CORS, per-entity Markdown context files for language models, Atom feeds and RDF triples;
- - **an MCP server and a command-line tool** (`packages/`), so agents and scripts can search, fetch, compare and ask over the corpus;
- - **browser WebMCP tools** for read-only record search and lookup in supporting browsers ([implementation and testing](docs/webmcp.md));
- - **eight interface languages** with translated TL;DRs where a translation exists.
- > **Work in progress. Verify at source.** Every fact is being built and checked in the open and may be incomplete, out of date or wrong. Nothing here is medical advice. Do your own research and check anything that matters at its primary source, which every page links.
- Current counts live at https://onco.cc/about/ and print from `npm run validate`. This file deliberately carries no numbers, so it never goes stale.
- ## Screenshots
- Captured from the built site on 17 September 2026. Click any image to open the live page.
- | | |
- |---|---|
- | [](https://onco.cc/) | [](https://onco.cc/body/) |
- | [](https://onco.cc/graph/) | [](https://onco.cc/molecules/) |
- | [](https://onco.cc/cancers/leukaemia/) | [](https://onco.cc/timeline/) |
- | [](https://onco.cc/pivot/) | [](https://onco.cc/models/) |
- <p align="center"><a href="https://onco.cc/cancers/pancreatic/"><img src="docs/screenshots/mobile-cancer.png" width="280" alt="A cancer page on a phone"></a></p>
- ## How the site is organised
- | Area | What it holds |
- |---|---|
- | **Start here** | Explore (ranked, filterable view of everything for a cancer), For me (pick your cancer type), Navigator, Tumour board, Compare, Landscape grid, Timeline, Query builder, Graph explorer, Body map |
- | **Cancers & treatments** | One page per cancer type, front, technology, target, treatment or test, trial, pairing, pathway, roadmap, key paper and glossary term; the Mechanics of cancer atlas; the Resistance atlas |
- | **News & evidence** | Evidence ranking, readout calendar, congress digests, research pulse, what the world is publishing, approvals by region, failures, payloads and linkers, toxicity, isotopes, key papers, journals, annual report, changelog, audit and corrections |
- | **Who's who** | Institutions, universities, trial leadership, companies, countries and country deep dives, cases by country, funding, people with portraits, heroes and heroines |
- | **Living with cancer** | Preparing for appointments, side effects and symptoms, report reader, second opinions, diet and lifestyle, hair loss, complementary and supportive approaches with evidence grades, survivorship |
- | **Learn & contribute** | Reading paths, About and methodology, Roadmap (what we are building), Completeness (how much of the known world we cover), Gaps, Bottlenecks of the war on cancer, Ideas, Suggest an edit, Evaluation, Open API, MCP and CLI |
- Every treatment with a small-molecule structure shows the exact molecule as a slowly rotating wireframe; antibodies, cells, vaccines, devices and tests show an explained placeholder. Fronts, technologies, cancers, targets and glossary categories carry hand-drawn animated schematics. Readers pick their country in the header, and "approved" then means their regulator's verdict, with other regions shown as flags.
- ## Repository layout
- ```
- src/data/ The corpus: TypeScript records, one array per kind or theme
- index.ts ALL_INPUTS: every array that becomes part of the graph
- cancers.ts, drugs.ts, targets.ts, technologies.ts, companies.ts, institutions.ts, ...
- spikes/ Per-cancer deep dives merged into the cancer records at load time
- people/, key-papers/, ideas-waves/, institutions/ Multi-file kinds, each with an index
- regional-approvals.ts, payloads.ts, resistance.ts, biomarkers.ts, ... Structured side data
- src/lib/schema.ts Zod schemas for every kind, KIND_META (routes, labels), REL_FIELDS
- src/lib/graph.ts Builds the graph: validates ids, resolves references, derives backlinks
- src/lib/nav.ts Navigation groups and every top-level route
- src/app/ Next.js App Router pages; src/app/[kind]/ renders every index, src/components/EntityDetail.tsx every object page
- src/components/ UI: EntityBrowser (the shared filterable table), Wireframe3D and schematics, Tip (tooltips), icons, maps
- scripts/ Fetchers and checks: structures (PubChem/RCSB), logos, OpenAlex, GLOBOCAN, trials, papers, factcheck, audit, provenance, API build
- public/ Self-hosted structures, logos, portraits, snapshots, the static JSON API under /api/v1/
- packages/ onco (CLI) and onco-mcp (Model Context Protocol server) over the API
- docs/ GAPS.md (what is still missing) and design notes
- ```
- ### Adding or fixing a record
- 1. Find the kind's file under `src/data/` (or the right sub-file for multi-file kinds) and add or edit the record. Every record needs an `id`, `name`, `tldr` (plain English, one or two sentences), `summary`, `asOf`, and at least one primary `links` entry.
- 2. Reference other objects by id in the relationship fields (`cancers`, `drugs`, `targets`, `technologies`, `trials`, `terms`, `people`, `bottlenecks`, `keyPapers`, `related`, and so on). Backlinks are derived, so link in one direction only.
- 3. Run `npm run validate`. It rejects duplicate ids, dangling references and malformed records, and prints the counts per kind.
- 4. Run `npm run typecheck && npm run lint && npm test && npm run build`.
- 5. Open an issue first (the site's forms prefill it); pull requests that change data reference the triaged issue, so every change passes the same safety check.
- New kinds need: a schema in `src/lib/schema.ts` (plus `KIND_META`, and the rel field in `Base` and `REL_FIELDS` if objects can point at it), a data file spread into `ALL_INPUTS`, a `case` in `buildBrowser` (`src/app/[kind]/page.tsx`) for the index table, a `case` in `kindTabs` (`src/components/EntityDetail.tsx`) for the page, a colour in `src/lib/text.ts` and `GraphExplorer`, and a nav entry.
- ### Scripts
- | Command | Purpose |
- |---|---|
- | `npm run validate` | Parse the corpus, check ids and references, print counts |
- | `npm run dev` / `npm run build` | Develop / build the static site into `out/` |
- | `npm run fetch:structures` | Pull molecule structures from PubChem and RCSB for `src/data/structures.ts` |
- | `npm run fetch:logos` | Self-host institution and company logos (Wikidata or favicon) |
- | `npm run fetch:openalex`, `fetch:countries`, `fetch:globocan`, `fetch:trials`, `fetch:papers` | Refresh research output, country rankings, incidence, trial registry and literature snapshots |
- | `npm run factcheck`, `npm run audit`, `npm run provenance` | Cross-check against openFDA and ClinicalTrials.gov, find stale or contradictory facts, map records to commits |
- | `npm run build:api` | Emit the static JSON API |
- GitHub Actions run the checks on every push and open weekly pull requests with refreshed snapshots.
- ## Principles
- - **One page per object, links everywhere.** If it can be a page, it is a page.
- - **Plain English first.** Every object opens with a TL;DR a newcomer understands; the technical layer follows. Technical terms are glossary objects and get hover explanations wherever they appear.
- - **Cited, dated, honest about gaps.** Every record links a primary source, carries the date it was last checked, and says "no data" rather than guessing.
- - **Nothing stale by design.** Counts and dates are computed at build time from the corpus, never written into copy.
- - **Open for good.** Code is MIT. Data is copyright OnCo, free for individual and educational use under CC BY-NC 4.0 with attribution; commercial use must contact us to pay for the data (see `LICENSE-DATA`). Logos remain their owners' trademarks.
- ## Changelog
- What changed, release by release, is in [CHANGELOG.md](CHANGELOG.md) and rendered live at [onco.cc/changelog](https://onco.cc/changelog/). The Unreleased section is regenerated from the commit log every time the site ships (`npm run changelog`, also run by `npm run build`), so it is never behind the live site. Version sections are written by hand when a release is cut.
- ## Cite and reuse
- - **Cite:** `CITATION.cff` holds the citation for the software and, under `preferred-citation`, for the corpus as a dataset; GitHub's "Cite this repository" button reads it. Each tagged release attaches the corpus (JSON, NDJSON, CSV, JSON Schema, OpenAPI, Markdown context files) at https://github.com/judegomila/OnCo/releases, and Zenodo archives releases with a DOI once the repository is linked there; the DOI goes into `CITATION.cff` when issued.
- - **Reuse:** data under CC BY-NC 4.0 (`LICENSE-DATA`): free for individual and educational use with the attribution line "Data from OnCo (onco.cc)" and a link to https://onco.cc; commercial use must contact us to pay for the data (issue labelled "licensing", or the contact on https://onco.cc/about/). Code under MIT (`LICENSE`). Every export, API file and CLI result carries the same attribution line.
- - **Machine access:** https://onco.cc/api/ (endpoint list), https://onco.cc/api/v1/openapi.json (OpenAPI 3.1), https://onco.cc/llms.txt and https://onco.cc/llms-full.txt (for language models), `npx onco-cc` and `npx -y onco-mcp` (`docs/ACCESS.md`). Distribution plan and press kit: `docs/DISTRIBUTION.md`, `docs/press-kit.md`.
- ## Contributing and safety
- See `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md` and `SECURITY.md`. No personal or patient data belongs in this repository; only public knowledge about the science, the products and the organisations.
- Data and structures from PubChem, RCSB PDB, Wikimedia Commons and Wikidata, OpenAlex, GLOBOCAN (IARC), ClinicalTrials.gov, Europe PMC, openFDA and the publishers and institutions linked on each page.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.