Dataset product files
A product file with $type Dataset declares one Noun's curated records, the Sources they come from, how often they refresh and what they cover.
A product file with $type: declares a Dataset: curated records of one Noun and the Sources they come from.
products/rates.mdxRatebook's US sales-tax ratesnouns/Rate.mdxthe one Noun it holds
Reference
| Key | Type | Holds | Required | Status |
|---|---|---|---|---|
$type | list | One or more of App, API, Agent, Dataset, Service | required | live |
nouns | Noun names | The Nouns it exposes; a Dataset holds Things of exactly one | live | |
verbs | Verb ids | The Verbs a Customer may call | live | |
interfaces | list | The Interfaces it ships on; every kind by default | live | |
sources | Source ids | Where its records come from, each owned, wrapped or recruited | required | beta |
refresh | hourly, daily, weekly or monthly | How often it re-reads every Source | beta | |
coverage | list of sentences | The population and date range it answers for, never "complete" | required | beta |
Examples
Minimal
---
$type: [Dataset]
nouns: [Rate]
sources: [state-bulletins]
coverage: [Every US taxing jurisdiction]
---Ratebook
---
$type: [Dataset, API]
nouns: [Rate]
sources: [state-bulletins, county-ordinances]
refresh: daily
coverage: [Every US taxing jurisdiction, from 2024 on]
---
A rate for any US address in under 100 milliseconds.What it builds
The SoftwareBuilder compiles the file.
- the Dataset, its records as Resources at their Sources, each with its provenance
- for
API: keyed lookups on the API and as MCP tools, with free misses and a free coverage check - the Dataset's facts beside its price: record count, coverage, last refresh, Source and license
Good to know
- The book is a data product; its reference lists every default and Verb.
nounsnames exactly one Noun. A license is on the Offer, never here.- Add
APIto$typeto sell lookups.