# BantuNomics Verbs — the Bantu verb as a generative 9-slot equation

> The verb domain (ABS-300 / BTS-V100): the 9-slot verb equation, the full morpheme
> inventory, an interactive builder, a progressive tutorial, and consented 6-in-1
> code-switch recordings. We share the PROGRAM, not just data. Living platform —
> recording coverage moves as native speakers record.

## Read first (public, no key)
- The verb equation + interactive builder:  https://verbs.bantunomics.com/equation
- The slot taxonomy + spec (BTS-E100-115):   https://verbs.bantunomics.com/spec
- The tutorial (preview):                    https://verbs.bantunomics.com/tutorial
- Per-language VT structure + live coverage: https://verbs.bantunomics.com/languages
- 6-in-1 recordings (one take = six datasets): https://verbs.bantunomics.com/why-it-matters

## Machine surface (read-only, NO key)
- Verb coverage (per language, as-of):   GET https://verbs.bantunomics.com/api/verbs/coverage
- Language VT table-of-contents:         GET https://verbs.bantunomics.com/api/verbs/<iso>/toc   (e.g. bem)
- The 9-slot equation inventory:         GET https://verbs.bantunomics.com/api/v1/verbs/slots
- Your tier + capabilities:              GET https://verbs.bantunomics.com/api/v1/verbs/whoami
- OpenAPI:                               GET https://verbs.bantunomics.com/openapi.json
- MCP (Streamable HTTP): {"url":"https://verbs.bantunomics.com/mcp"}  tools: whoami, verb_coverage,
  language_toc, generate_verb, decompose_verb
- MCP discovery:                         https://verbs.bantunomics.com/.well-known/mcp.json

## The generative engine — PUBLIC (batch size clamped by tier)
- Build a verb from slots (valid OR labelled-invalid, for contrastive training):
    POST https://verbs.bantunomics.com/api/v1/verbs/generate   {"S2":"n","S5":"bomb","S8":"a"}  -> "mbomba"
    Batch: {"verbs":[{...},{...}]}  (clamped to your tier's engine_cap)
- Decompose a surface verb into slots + Leipzig gloss + translation:
    POST https://verbs.bantunomics.com/api/v1/verbs/decompose  {"surface_form":"balebomba"}

## Dataset strategies — PUBLIC shape teaser
- The catalogue (LLM / minimal-pair / TTS / tonal / MRS) + live stats + a 2-record
  sample of each, so you can see the shape before licensing:
    GET https://verbs.bantunomics.com/api/v1/verbs/strategies

## Licensed (gated - evaluation / pilot / partner)
- The full 37-chapter interactive tutorial, uncapped engine batch, and the CONSENTED
  AUDIO corpus (opaque proxy — never a raw path):
    GET https://verbs.bantunomics.com/api/v1/verbs/corpus/<iso>   (401 without a grant; 403 outside your set)
- BULK dataset export (Full Annual Subscription) — JSON or HuggingFace-ready JSONL:
    GET https://verbs.bantunomics.com/api/v1/verbs/export?kind=llm|paired|tts|tonal|mrs|all&format=jsonl
  Start a free evaluation (self-serve):  https://bantunomics.com/evaluation