# Meshsmiths

> An original, parametric 3D catalogue for people and agents building scenes. Pieces expose dimensions, triangle counts, palettes and factory knobs; kits describe how pieces fit together.

Use metres, Y-up, ground-centred origins and +Z forward. Fetch the live catalogue before choosing assets. Documentation describes the current lightweight HTTP tool bridge, not a full MCP client handshake. Asset access and reuse still depend on the returned entitlement and licence.

## Start here

- [Agent workbench](/agents): Verified plain-HTTP connection, exactly eleven tool names and inputs, scene conventions and a worked walk to public GLB bytes. Desktop/editor MCP sessions are not supported.
- [Agent brief](/prompt.txt): Copy-paste instructions and a cold-start curl workflow.
- [API index](/api): Live conventions and public REST directory.

## Catalogue

- [Pieces](/api/pieces): REST search using q, line, kit, free, max_triangles, min_triangles and sort.
- [Kits](/api/kits): Assembly contracts, grid sizes and scene-wide knobs.
- [Catalogue browser](/catalogue): Human-readable discovery and previews.

## Tool bridge

- [MCP endpoint](/api/mcp): POST JSON-RPC 2.0 tools/list and tools/call. Listing returns names only; initialize is not implemented.

## Prices and plans

- [Live prices and plans](/plans): Owner-confirmed Pro, Founders lifetime, single art asset and flat kit prices. Pro yearly remains an explicitly labelled ten-monthly-payments assumption; Student, Studio, Platform, Enterprise and Commission remain provisional. Read current catalogue offers for checkout totals, tax, discounts and licence scope; do not infer entitlement from a price.

## Conventions and access

- Measurements are metres; Y is up and +Z is forward.
- Origins are ground-centred; read kit grid sizes before placing members.
- Keep named materials and returned palette values.
- Read actual knob names and ranges from the piece record.
- Count every placement toward the scene triangle budget.
- Free eligibility is under 600 triangles per piece.
- A public preview URL is not a download entitlement or a reuse licence.
- Check access and delivery independently; paid access does not release a file.
- A failed database call is unavailable, never a successful write.

## Coverage gaps

- Explain poor or missing coverage before substituting another asset.
- report_need accepts need, kind and optional context.
- Its current storage is process memory, not a durable database.
- preview_scene returns a summary, not a rendered or exported scene.
- Follow the agent brief for the full inputs of all eleven tools.

- [Sitemap](/sitemap.xml): Public page discovery.

## Optional

- [Cairn model](/bank/props/prp_cairn/master.glb): Public GLB used by the worked example; a direct model fetch is not a token-download entitlement.
- [Account identity](/api/me): Entitlement details; provide your own bearer key, never embed a secret in a shared prompt.

## CDN endpoints
- GET /cdn/<pieceId>.json: metadata, knob schema and defaults.
- GET /cdn/<pieceId>.glb: GLB with defaults, or schema-validated p.<knob> query parameters.
- GET /cdn/<pieceId>.js: ES module exporting load({key?}), using three/addons/loaders/GLTFLoader.js. Supply a three.js import map.
- Free pieces need no key. Pro pieces require the existing catalogue entitlement; denied access returns 402 with /plans. Send Authorization: Bearer <key> or X-API-Key. Never publish a private key in a hotlink.
- Responses support CORS and ETag revalidation. Entitled responses use private caching.
- Unity source: integrations/unity/com.meshsmiths.loader (glTFast dependency). Godot 4 source: integrations/godot/addons/meshsmiths.