# Spritefetch

> Game assets your agent can find and use. Curated CC0 2D sprite sheets and tilesets with machine-readable licenses, slicing data, SHA-256 checksums, and versioned URLs that never change.

No key is needed. An optional free API key (Authorization: Bearer <API_KEY>) raises the limits.

## Connect
- MCP (Streamable HTTP, stateless): https://api.spritefetch.dev/mcp  — tools: search, get_asset, download
- REST: https://api.spritefetch.dev/v1/search?q=pixel-art+knight+run
- OpenAPI: https://api.spritefetch.dev/openapi.json
- Asset schema: https://api.spritefetch.dev/schemas/asset.v1.json
- Catalog (id, version, sha256, file_url): https://api.spritefetch.dev/catalog.json

## How to use a result
1. Search, then pin id + version + sha256 (and metadata_revision if you need reproducible slicing).
2. Read license_spdx, attribution_required, attribution_text before you ship. Every asset is CC0-1.0 in the MVP.
3. Download file_url and verify: echo "<sha256>  <filename>" | sha256sum -c
4. Slice: frame i is at col = i mod grid_cols, row = floor(i / grid_cols); x = margin + col*(frame_width+spacing), y = margin + row*(frame_height+spacing). Pivot is in px from each frame's top-left. Tilesets map to Tiled (tilewidth, tileheight, margin, spacing, tilecount, columns).
5. Per-asset markdown: https://api.spritefetch.dev/v1/assets/{id}/v/{n}/index.md

## Limits (planning defaults)
- Anonymous (per IP): 30/min, 500/day (UTC)
- Free key: 60/min, 2000/day
- Files, thumbnails, license.txt, docs, openapi.json, llms.txt, catalog.json and MCP initialize/tools/list are not counted.

## Docs
- Quickstart: https://api.spritefetch.dev/docs/quickstart
- API: https://api.spritefetch.dev/docs/api
- MCP: https://api.spritefetch.dev/docs/mcp
- Licensing and verification labels: https://api.spritefetch.dev/docs/licensing
- Errors: https://api.spritefetch.dev/docs/errors

Assets are provided as is, without warranty. Check each license before you ship.
Found a problem or have feedback? Tell us at support@spritefetch.com.