THE CHARACTER IS YOURS

Build with the public library

Read original skins, block textures and building blueprints through a versioned API, with explicit sources, licenses and revocable keys.

Approved work, with its source

Search skins, texture packs and building blueprints, read their licenses and attribution, then download exact generated files. Private projects, raw images, prompts and jobs are outside this API.

Download OpenAPI 3.1 contract

API v1 · contract 1.1.0 · scope library:read

Predictable request quotas

Each key permits 60 requests per minute and 5000 per UTC day. These requests do not spend generation credits. Read the remaining quota in response headers; respect Retry-After on 429.

Cache with ETag and If-None-Match. Revalidation checks the key and current publication state before returning 304. Withdrawn content returns 404; revoked or expired keys return 401.

Create a read-only key

Query, inspect, download

Keep your key in a trusted server configuration file. Send it as an Authorization header. Preserve sourceUrl, author, license and inherited attributions when displaying or redistributing a work. Noncommercial licenses remain noncommercial.

# 1. Search approved skins
curl 'https://mcskingen.com/api/v1/library/skins?limit=2&model=classic' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 2. Read a publication from its returned id
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. Download one of the returned assets
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

For building structures, use /library/buildings?category=houses. Voxel JSON and material CSV are separate from game files, which appear only after their release checks pass.

For block resource packs, use /library/textures and its returned download URLs. Each file retains its target game version; file checks do not certify game-client import.

For another page, send the returned nextCursor as cursor with unchanged filters and limit. A null cursor marks the end. Search supports literal text, license and skin arm model; unrecognized or repeated parameters return 400.

Access boundaries

MCP connection & authorization →

This release exposes approved public-library reads only. API keys cannot create jobs, obtain quotes, read a wallet, upload references, manage keys or purchase credits. Website account sessions manage keys separately. MCP tools use separate website OAuth authorization.