---
name: kura
description: >-
  Use Kura (仓 / assetsSrcAPI) to discover and fetch CC0 mini-game asset packs
  for agents. Covers kura.query/v1, kura.fetch/v1, KayKit and Kenney catalogs.
  Use when an agent needs game kits, hex tiles, characters, props, or when the
  user mentions Kura, assetsSrc, KayKit, Kenney Hexagon Kit, or importing CC0
  packs into a game project.
---

# Kura

Agent surface for free CC0 **game-making** packs. Not photogrammetry / HDRI catalogs.

## Base URL

- `https://kuroneko.chat/assets`
- Full agent doc: `https://kuroneko.chat/assets/AGENT.md`
- Machine descriptor: `GET https://kuroneko.chat/assets/api/query` (`audience: "agent"`, protocol `kura.query/v1`)

## Workflow

1. `GET https://kuroneko.chat/assets/api/query` — read allowed fields. Never send `native`.
2. Discover packs:
   - `GET https://kuroneko.chat/assets/api/query?scope=discover&text=hexagon&providerIds=kenney`
   - or `POST https://kuroneko.chat/assets/api/query` with `{ "protocol":"kura.query/v1","scope":"discover","query":{…} }`
3. `GET https://kuroneko.chat/assets/api/fetch?providerId=…&externalId=…` — take **origin** URL first.
4. Download the origin zip on the caller machine. Do not proxy through Kura when origin works.

## Providers

| Id | Use for |
|----|---------|
| `kaykit` | Stylized character / dungeon / furniture kits |
| `kenney` | Game packs including **Hexagon Kit** (`hexagon-kit`) |

Search by purpose (`dungeon`, `hexagon`, `character`), not by smaller file size.

## Import into headless Cocos (caller machine)

```bash
cd $SRC   # assetsSrcAPI repo with dist/
node tools/import-to-headless.mjs --project $GAME --id <externalId>
```

## Do not

- Use Poly Haven / ambientCG as the mini-game default
- Filter by 1K / small zip as the selection rule
- Download via vault when origin is available