Sandbox view — Colorado
A single reference for everything in the Colorado METRC sandbox: what exists, how it’s linked, and which tools, skills, and framework items to use. Use this page to navigate the sandbox and the docs.
Environment: Colorado sandbox · Recommended license: SF-SBX-CO-21-8002 (Retail Cultivation). Get all licenses via metrc_get_facilities. See Sandbox Limitations for facility selection guidance.
1. License and facility
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Facilities | Multiple (Cultivation, Manufacturer, Store, etc.) | metrc_get_facilities | Every skill needs license_number; get it here. |
| License number | e.g. SF-SBX-CO-1-8002 |
Same | Pass to all facility-scoped tools. |
Checking other facilities
The sandbox has 28 facilities (SF-SBX-CO-1-8002 through SF-SBX-CO-28-8002). Data varies by type:
| Type (example) | License | Typical data |
|---|---|---|
| Retail Cultivation | SF-SBX-CO-21-8002 | Full lifecycle: strains, ForPlants locations, plants, harvests, packages. Recommended for seed-to-sale. |
| Retail Store | SF-SBX-CO-24-8002 | Items, categories, customer types, transfer types. |
| Retail Testing Lab | SF-SBX-CO-25-8002 | Lab test types and recording. |
| Accelerator Cultivation | SF-SBX-CO-1-8002 | Limited: 0 item categories, no ForPlants location type. Not recommended. |
| Others | SF-SBX-CO-4 through 28 | Varies; many have items, 0 packages/harvests until data is created or transferred. |
Use the Sandbox view UI: Load facilities, pick a facility, then Refresh data to see locations, strains, items, harvests, and packages for that license. For Chat and Adam Freed Q&A, select the facility whose data you want to query.
2. Reference data (no or single license)
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Units of measure | Ounces, Grams, Pounds, Each, etc. | metrc_get_units_of_measure | FIFO / aging pull, Inventory summary, packaging. |
| Waste methods | For harvest/package waste | metrc_get_waste_methods | metrc_post_harvest_waste. |
| Sandbox setup | Seeds test data | metrc_sandbox_setup | Optional before populate script. |
3. Strains
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Strains | e.g. SBX Strain 1, 2, … (12 after populate) | metrc_get_strains · metrc_get_harvest · metrc_create_strain · metrc_update_strain | Traceability · Strain/product fit · FIFO / aging. |
| Lookup | By ID | metrc_get_harvest (harvest) | Package/harvest lineage. |
Strains are referenced by Id and Name in plant batches, harvests, items, and packages. Use strains when creating plantings, items, and for reporting by strain.
4. Locations and location types
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Location types | e.g. Centralized Processing Hub (ForPlants, ForPackages vary) | metrc_get_location_types | Need a type with ForPlants: true to create plantings. |
| Locations | e.g. SBX Centralized Processing Hub Location 1 | metrc_get_locations · metrc_create_location | Facility summary · Inventory by location · Fragmentation. |
| Use | Plants, harvests, packages | — | Drying location for harvest; location for packages. |
Colorado sandbox may only expose types with ForPlants: false; then plantings are skipped until a plant-capable type exists. See Populate script.
5. Plants and plant batches
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Plant batch types | Seed, Clone, Genetic Material | metrc_get_plant_batch_types | Create plantings. |
| Plant tags (available) | Many (for new plantings) | metrc_get_tags_plant_available | metrc_create_plant_batch_plantings. |
| Plant batches | After create plantings | metrc_get_plant_batches · metrc_get_plant_batches_inactive | Traceability. |
| Vegetative plants | Before moving to flowering | metrc_get_plants_vegetative · metrc_change_plants_growth_phase | Seed → vegetative → flowering. |
| Flowering plants | Required before harvest | metrc_get_plants_flowering | metrc_harvest_plants. |
| Single plant | By ID or label | metrc_get_plant | Traceability. |
Lifecycle: Plantings (Seed/Clone) → Vegetative → Flowering → Harvest. All steps require a location that allows plants except harvest (drying location).
6. Harvests
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Active harvests | After harvesting flowering plants | metrc_get_harvests · metrc_get_harvest | Audit-ready snapshot · FIFO / aging · Traceability. |
| Create harvest | From flowering plants | metrc_harvest_plants | Colorado: plant_labels, weight, unit, drying_location_id. |
| Harvest actions | Move, rename, finish, waste | metrc_move_harvest · metrc_rename_harvest · metrc_finish_harvest · metrc_post_harvest_waste | Needs attention · §9 Compliance. |
| Packages from harvest | Create packages from a harvest | metrc_create_harvest_packages | Seed-to-sale completion. |
| Inactive harvests | Finished or historical | metrc_get_harvests_inactive | Audit, reconciliation. |
7. Packages
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Active packages | Saleable or in-progress | metrc_get_packages · metrc_get_packages_with_pagination | Inventory summary · Fragmentation · Sample-out · FIFO. |
| Single package | By ID or label | metrc_get_package | Traceability. |
| Package tags (available) | For new packages | metrc_get_tags_package_available | metrc_create_package · metrc_create_harvest_packages. |
| Create package | Standalone or from harvest | metrc_create_package · metrc_create_harvest_packages | §1 Bulk. |
| Adjust / move / finish | Single or bulk | metrc_adjust_package · metrc_change_package_location · metrc_finish_package · metrc_bulk_* | Needs attention · §7 Package optimization. |
| Inactive packages | Finished or retired | metrc_get_packages_inactive | Audit. |
8. Items (products)
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Items | e.g. Flower - Usable (after populate) | metrc_get_items · metrc_create_item · metrc_update_item | Required to create packages. Inventory summary · Strain/product. |
Items are referenced by ItemId when creating or inspecting packages.
9. Transfers, lab, waste, processing
| What | In sandbox | Tools | Skills / framework |
|---|---|---|---|
| Transfers | Incoming / outgoing | metrc_get_transfers_incoming · metrc_get_transfers_outgoing | Needs attention · Audit-ready snapshot. |
| Lab tests | Types, batches, results | metrc_get_lab_test_types · metrc_get_lab_test_batches · metrc_get_lab_test_results | Traceability · §14 Yield. |
| Processing | Active jobs, job types | metrc_get_processing_active · metrc_get_processing_job_types | §11 Tolling. |
10. Lifecycle (seed → sale) — tools and skills
Flow in the sandbox and where to use tools/skills:
| Stage | What happens | Tools | Skills |
|---|---|---|---|
| 1. Seed/clone | Plant batch + plantings | metrc_get_location_types · metrc_create_location · metrc_get_tags_plant_available · metrc_get_plant_batch_types · metrc_create_plant_batch_plantings | — |
| 2. Vegetative | Plants in veg | metrc_get_plants_vegetative | — |
| 3. Flowering | Move to flower | metrc_change_plants_growth_phase | — |
| 4. Harvest | Harvest flowering plants | metrc_get_plants_flowering · metrc_harvest_plants | — |
| 5. Package | Create packages from harvest | metrc_get_items · metrc_get_tags_package_available · metrc_create_harvest_packages | — |
| 6. Sale-ready | Finish packages | metrc_finish_package · metrc_bulk_finish_packages | — |
| 7. Optional | Harvest waste, finish harvests, lab types, adjust packages | metrc_post_harvest_waste · metrc_finish_harvest · metrc_get_lab_test_types · metrc_adjust_package | — |
| Ongoing | Query and analyze | All read tools | Facility summary · Needs attention · Audit-ready · FIFO · Fragmentation · Sample-out · Traceability · Inventory summary |
11. Populate scripts
populate-sandbox
Seeds the Colorado sandbox with 12 strains and a full lifecycle (plantings → flowering → harvest → packages → finish) where the API allows:
- Run:
npm run populate-sandbox(see README). - Requires:
.envwithMETRC_VENDOR_API_KEYandMETRC_USER_API_KEY. - Creates: Strains (SBX Strain 1–12), optional plant location, plantings (if ForPlants location exists), harvest(s), item(s), packages, and finishes packages.
- Default facility: CO-21 (Retail Cultivation) — has full ForPlants location types and item categories. Override with
METRC_LICENSEenv var. Avoid CO-1 (Accelerator) which has crippled categories.
populate-simulated-year (full lifecycle in simulated time)
Runs the entire seed-to-sale lifecycle with backdated dates over ~52 weeks so the sandbox has a year of data:
- Run:
npm run populate-simulated-year - Requires: Same
.env; optionalMETRC_LICENSE(defaultSF-SBX-CO-21-8002). Enough plant tags and package tags in the sandbox (run sandbox setup or populate-sandbox first if needed). - Steps (in order):
- Sandbox setup → strains → locations (plant + harvest/drying)
- Grow: 12 cycles, each: Seed → plants (plantings) → vegetative → flowering → harvest (all backdated)
- Items (product catalog)
- Packages from harvests (process harvest → packaged product)
- Harvest waste (record 0.1 oz on one harvest)
- Finish harvests (processing complete)
- Lab (fetch lab test types)
- Finish packages (ready for sale)
- Optional: adjust one package (e.g. sample)
- Use metrc_get_harvests, metrc_get_packages, metrc_get_harvests_inactive, metrc_get_packages_inactive to inspect the result.
After either script, use metrc_get_facilities, metrc_get_strains, metrc_get_harvests, metrc_get_packages to inspect the sandbox.
12. Quick links
| Doc | Purpose |
|---|---|
| Getting started | Setup, credentials, MCP config |
| Tools | All MCP tools by category |
| Skills | Analysis skills and MCP resource URIs |
| Master Framework | Feature framework (bulk, aging, compliance, yield, etc.) |
| Framework Q&A | Example questions and answers per framework item |
| ← Back to documentation | Tools | Skills | Framework |