Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/judegomila--onco/badge.svg)](/listings/judegomila--onco)

HTML

<a href="/listings/judegomila--onco"><img src="/api/listings/judegomila--onco/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. # OnCo: Total information dominance on cancer.
  2. **Live:** https://onco.cc
  3. 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.
  4. 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.
  5. The website is one surface. The same corpus ships as:
  6. - **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;
  7. - **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;
  8. - **an MCP server and a command-line tool** (`packages/`), so agents and scripts can search, fetch, compare and ask over the corpus;
  9. - **browser WebMCP tools** for read-only record search and lookup in supporting browsers ([implementation and testing](docs/webmcp.md));
  10. - **eight interface languages** with translated TL;DRs where a translation exists.
  11. > **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.
  12. 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.
  13. ## Screenshots
  14. Captured from the built site on 17 September 2026. Click any image to open the live page.
  15. | | |
  16. |---|---|
  17. | [![Home: total information dominance on cancer](docs/screenshots/home.png)](https://onco.cc/) | [![Body map: pick where the cancer is](docs/screenshots/body-map.png)](https://onco.cc/body/) |
  18. | [![Graph explorer: every page is a node](docs/screenshots/graph.png)](https://onco.cc/graph/) | [![Molecule gallery: 3D structures of every product](docs/screenshots/molecules.png)](https://onco.cc/molecules/) |
  19. | [![Cancer page: leukaemia with its subtypes](docs/screenshots/cancer-leukaemia.png)](https://onco.cc/cancers/leukaemia/) | [![Timeline: scrub through the years](docs/screenshots/timeline.png)](https://onco.cc/timeline/) |
  20. | [![Landscape grid: count what exists where](docs/screenshots/pivot.png)](https://onco.cc/pivot/) | [![Models and datasets with maker logos](docs/screenshots/models.png)](https://onco.cc/models/) |
  21. <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>
  22. ## How the site is organised
  23. | Area | What it holds |
  24. |---|---|
  25. | **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 |
  26. | **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 |
  27. | **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 |
  28. | **Who's who** | Institutions, universities, trial leadership, companies, countries and country deep dives, cases by country, funding, people with portraits, heroes and heroines |
  29. | **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 |
  30. | **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 |
  31. 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.
  32. ## Repository layout
  33. ```
  34. src/data/ The corpus: TypeScript records, one array per kind or theme
  35. index.ts ALL_INPUTS: every array that becomes part of the graph
  36. cancers.ts, drugs.ts, targets.ts, technologies.ts, companies.ts, institutions.ts, ...
  37. spikes/ Per-cancer deep dives merged into the cancer records at load time
  38. people/, key-papers/, ideas-waves/, institutions/ Multi-file kinds, each with an index
  39. regional-approvals.ts, payloads.ts, resistance.ts, biomarkers.ts, ... Structured side data
  40. src/lib/schema.ts Zod schemas for every kind, KIND_META (routes, labels), REL_FIELDS
  41. src/lib/graph.ts Builds the graph: validates ids, resolves references, derives backlinks
  42. src/lib/nav.ts Navigation groups and every top-level route
  43. src/app/ Next.js App Router pages; src/app/[kind]/ renders every index, src/components/EntityDetail.tsx every object page
  44. src/components/ UI: EntityBrowser (the shared filterable table), Wireframe3D and schematics, Tip (tooltips), icons, maps
  45. scripts/ Fetchers and checks: structures (PubChem/RCSB), logos, OpenAlex, GLOBOCAN, trials, papers, factcheck, audit, provenance, API build
  46. public/ Self-hosted structures, logos, portraits, snapshots, the static JSON API under /api/v1/
  47. packages/ onco (CLI) and onco-mcp (Model Context Protocol server) over the API
  48. docs/ GAPS.md (what is still missing) and design notes
  49. ```
  50. ### Adding or fixing a record
  51. 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.
  52. 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.
  53. 3. Run `npm run validate`. It rejects duplicate ids, dangling references and malformed records, and prints the counts per kind.
  54. 4. Run `npm run typecheck && npm run lint && npm test && npm run build`.
  55. 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.
  56. 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.
  57. ### Scripts
  58. | Command | Purpose |
  59. |---|---|
  60. | `npm run validate` | Parse the corpus, check ids and references, print counts |
  61. | `npm run dev` / `npm run build` | Develop / build the static site into `out/` |
  62. | `npm run fetch:structures` | Pull molecule structures from PubChem and RCSB for `src/data/structures.ts` |
  63. | `npm run fetch:logos` | Self-host institution and company logos (Wikidata or favicon) |
  64. | `npm run fetch:openalex`, `fetch:countries`, `fetch:globocan`, `fetch:trials`, `fetch:papers` | Refresh research output, country rankings, incidence, trial registry and literature snapshots |
  65. | `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 |
  66. | `npm run build:api` | Emit the static JSON API |
  67. GitHub Actions run the checks on every push and open weekly pull requests with refreshed snapshots.
  68. ## Principles
  69. - **One page per object, links everywhere.** If it can be a page, it is a page.
  70. - **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.
  71. - **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.
  72. - **Nothing stale by design.** Counts and dates are computed at build time from the corpus, never written into copy.
  73. - **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.
  74. ## Changelog
  75. 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.
  76. ## Cite and reuse
  77. - **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.
  78. - **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.
  79. - **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`.
  80. ## Contributing and safety
  81. 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.
  82. 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 in

Free to use. If it’s helped, pass it on.