# AI-AssetStore

> Free asset packs for software projects, served to agents over a JSON REST API
> and a Model Context Protocol server. Every search result explains why it ranked
> where it did.

Currently 2 packs, 45 assets, 2 categories.

## How to use this catalog

Do not download the catalog and choose by reading descriptions. The ranked
endpoints below score every candidate against your wording and return a `reasons`
array for each hit; a raw listing carries neither.

- GET /api/recommend?project={description}&count={n} - start here for a coherent set. Returns one primary pack, mixes in a second only where the first cannot cover the request, and explains every pick.
- GET /api/search?q={query}&type=pack|asset - when the need is already named. &packId= keeps an asset search inside one pack.
- GET /api/assets/{assetId} - then download urls.file.
- Prefer assets from a single pack. Picking the best-scoring asset per need from a different pack each time yields a UI whose assets do not belong together.
- GET /api/catalog and GET /api/packs/{packId} return everything unranked. They are for mirroring the catalog, not for choosing assets.

## Endpoints

- [Recommend](https://moessets.store/api/recommend?project=point%20and%20click%20adventure&count=10): ranked assets for a free-text project description
- [Search](https://moessets.store/api/search?q=pirate&type=pack): scored packs or assets, each explaining itself
- [Packs](https://moessets.store/api/packs): pack metadata, unranked
- [Pack](https://moessets.store/api/packs/{packId}): one pack with all of its assets, unranked
- [Asset](https://moessets.store/api/assets/{assetId}): one asset
- [Health](https://moessets.store/api/health): live counts
- [API index](https://moessets.store/api): every route, including the ones needing a session

## Optional

- [MCP server](https://moessets.store/mcp): Streamable HTTP, stateless. Same answers as the REST
  routes plus `get_asset(includeSvgContent: true)`, which inlines the SVG source.
- [Full catalog](https://moessets.store/api/catalog): every pack and asset in one document. For
  mirroring the catalog, not for choosing assets - it carries no scores.