# Tridsy

> Parametric low-poly 3D assets for humans and AI agents.

Tridsy serves parametric low-poly 3D assets. Every asset is a small program with typed knobs (numbers, ints, colors, booleans, selects).
Workflow: search_assets -> get_asset (read its params schema) -> export_asset with the knob values you want -> download the returned URL.
Conventions: +Y up, +Z front, meters, origin at ground center. Assets in the same kit share palette and grid, so they compose cleanly.
Use format "glb" for most engines, "js" for three.js projects that should stay parametric at runtime, "usdz" for Apple AR, "obj" as a fallback.

## Endpoints

- MCP (Streamable HTTP): https://tridsy.com/api/mcp — tools: search_assets, get_asset, list_kits, export_asset
- Catalog: https://tridsy.com/api/v1/assets (query: q, category, kit, tier, limit, offset)
- Asset details + knob schema: https://tridsy.com/api/v1/assets/{slug}
- Export: https://tridsy.com/api/v1/assets/{slug}/export?format=glb|usdz|obj|js&<knob>=<value>
- Kits: https://tridsy.com/api/v1/kits
- Auth: optional `Authorization: Bearer tds_...` (create keys at https://tridsy.com/account). Anonymous callers get free assets only.

## Kits

- Medieval Village (`medieval-village`, 2 m grid): Timber, thatch and cobblestone.
- Space Base (`space-base`, 4 m grid): Habitats and hardware for the red frontier.
- Wild Nature (`wild-nature`, 1 m grid): Forests, rocks and everything that grows.
- City Block (`city-block`, 4 m grid): Towers, streets and the stuff on sidewalks.
- Characters (`characters`, 1 m grid): People and robots as configs, not meshes.
- Pirate Port (`pirate-port`, 2 m grid): Ships, docks and buried treasure.

## Assets

- [Timber Cottage](https://tridsy.com/api/v1/assets/cottage) `cottage` — free, medieval-village: A half-timbered village cottage with a gabled roof, optional chimney and configurable floors.
- [Stone Well](https://tridsy.com/api/v1/assets/stone-well) `stone-well` — free, medieval-village: A round village well with a wooden frame, a little roof and a bucket.
- [Wooden Fence](https://tridsy.com/api/v1/assets/wooden-fence) `wooden-fence` — free, medieval-village: A modular post-and-rail fence. Set the number of segments to match your grid.
- [Stone Watchtower](https://tridsy.com/api/v1/assets/watchtower) `watchtower` — pro, medieval-village: A round stone watchtower with arrow slits, a crenellated parapet and a pennant flying from the top.
- [Market Stall](https://tridsy.com/api/v1/assets/market-stall) `market-stall` — free, medieval-village: A wooden market stall with a striped canvas awning and a counter piled with goods.
- [Wooden Barrel](https://tridsy.com/api/v1/assets/barrel) `barrel` — free, medieval-village: A classic bulging stave barrel with iron hoops and an optional lid.
- [Hay Cart](https://tridsy.com/api/v1/assets/hay-cart) `hay-cart` — pro, medieval-village: A two- or four-wheeled farm cart with shafts for a horse and a configurable load of hay.
- [Stone Wall](https://tridsy.com/api/v1/assets/stone-wall) `stone-wall` — free, medieval-village: A modular dry-stone wall segment with optional battlements. Snap segments end-to-end along the grid.
- [Habitat Dome](https://tridsy.com/api/v1/assets/habitat-dome) `habitat-dome` — free, space-base: A pressurized geodesic habitat on a ring foundation, with a band of windows and a front airlock.
- [Cargo Crate](https://tridsy.com/api/v1/assets/cargo-crate) `cargo-crate` — free, space-base: Reinforced supply crates with hazard stripes. Stack up to four for instant set dressing.
- [Antenna Dish](https://tridsy.com/api/v1/assets/antenna-dish) `antenna-dish` — pro, space-base: A deep-space communications dish on a lattice mast. Aim it with tilt and rotation knobs.
- [Solar Array](https://tridsy.com/api/v1/assets/solar-array) `solar-array` — free, space-base: A ground-mounted grid of tilted photovoltaic panels on a steel frame.
- [Mars Rover](https://tridsy.com/api/v1/assets/mars-rover) `mars-rover` — pro, space-base: A six- or four-wheeled planetary rover with rocker-bogie suspension, mast camera and optional cargo bed.
- [Landing Pad](https://tridsy.com/api/v1/assets/landing-pad) `landing-pad` — pro, space-base: A circular landing pad with painted markings and a ring of glowing guide lights.
- [Pine Tree](https://tridsy.com/api/v1/assets/pine-tree) `pine-tree` — free, wild-nature: A tiered conifer with stacked cones, an optional snow cap and seeded variation.
- [Round Tree](https://tridsy.com/api/v1/assets/round-tree) `round-tree` — free, wild-nature: A broadleaf tree with a lumpy canopy made of seeded blobs, optionally carrying fruit.
- [Rock Cluster](https://tridsy.com/api/v1/assets/rock-cluster) `rock-cluster` — free, wild-nature: A seeded pile of faceted boulders. Scatter a few with different seeds for natural variety.
- [Leafy Bush](https://tridsy.com/api/v1/assets/bush) `bush` — free, wild-nature: A rounded shrub built from overlapping blobs with optional berries.
- [Toadstool Cluster](https://tridsy.com/api/v1/assets/mushroom) `mushroom` — pro, wild-nature: Storybook mushrooms with domed caps and optional spots, grouped in a seeded cluster.
- [Flower Patch](https://tridsy.com/api/v1/assets/flower-patch) `flower-patch` — pro, wild-nature: A round patch of simple five-petal flowers with a choice of color palettes.
- [Birch Tree](https://tridsy.com/api/v1/assets/birch-tree) `birch-tree` — pro, wild-nature: A slender white-barked birch with dark bark marks, an airy canopy and adjustable lean.
- [Apartment Block](https://tridsy.com/api/v1/assets/apartment-block) `apartment-block` — free, city-block: A mid-rise residential building with a ground-floor band, window grid, rooftop parapet and optional water tank.
- [Street Lamp](https://tridsy.com/api/v1/assets/street-lamp) `street-lamp` — free, city-block: A city street light with one or two arms and glowing lamp heads in classic or modern style.
- [Park Bench](https://tridsy.com/api/v1/assets/park-bench) `park-bench` — free, city-block: A slatted wooden bench on metal legs, with or without a backrest.
- [Sedan Car](https://tridsy.com/api/v1/assets/sedan-car) `sedan-car` — pro, city-block: A compact four-door sedan with a glass cabin, lights and choice of wheel style.
- [Fire Hydrant](https://tridsy.com/api/v1/assets/fire-hydrant) `fire-hydrant` — free, city-block: A classic sidewalk fire hydrant with side nozzles and a domed cap.
- [Traffic Cone](https://tridsy.com/api/v1/assets/traffic-cone) `traffic-cone` — free, city-block: A road cone with a square base and reflective stripes.
- [Humanoid](https://tridsy.com/api/v1/assets/humanoid) `humanoid` — free, characters: A stylized low-poly person built as a config: height, build, age, hair, outfit and pose. Every variant shares the same named joint layout.
- [Service Robot](https://tridsy.com/api/v1/assets/robot) `robot` — pro, characters: A friendly boxy robot. Mix head shapes, locomotion and arms; eyes and lights glow in any color.
- [Knight](https://tridsy.com/api/v1/assets/knight) `knight` — pro, characters: An armored knight with a swappable helmet, cape, weapon and heraldic shield. Same joint layout as the humanoid.
- [Pirate Ship](https://tridsy.com/api/v1/assets/pirate-ship) `pirate-ship` — pro, pirate-port: A square-rigged sailing ship with a raised sterncastle, bowsprit and jib, gun ports along both sides and a flag on the mainmast.
- [Harbor Lighthouse](https://tridsy.com/api/v1/assets/lighthouse) `lighthouse` — pro, pirate-port: A tapered, striped lighthouse on a stone plinth with a railed gallery and a glowing lantern room.
- [Harbor Tavern](https://tridsy.com/api/v1/assets/harbor-tavern) `harbor-tavern` — free, pirate-port: A weathered clapboard tavern with a covered porch, shuttered windows, a hanging sign and barrels by the door.
- [Wooden Dock](https://tridsy.com/api/v1/assets/wooden-dock) `wooden-dock` — free, pirate-port: A modular pier of planks on pilings with mooring bollards and an optional lamp post at the end. Set segments to match your grid.
- [Ship Cannon](https://tridsy.com/api/v1/assets/ship-cannon) `ship-cannon` — free, pirate-port: A cast-iron cannon on a wooden carriage, either a four-wheel naval truck or a two-wheel field carriage, with an optional pile of shot.
- [Treasure Chest](https://tridsy.com/api/v1/assets/treasure-chest) `treasure-chest` — free, pirate-port: A banded wooden chest with a domed lid you can open, a heap of gold and gems inside and loose coins scattered around.
- [Palm Tree](https://tridsy.com/api/v1/assets/palm-tree) `palm-tree` — free, pirate-port: A coconut palm with a curving ringed trunk and drooping fronds. Every seed bends it a little differently.
- [Rowboat](https://tridsy.com/api/v1/assets/rowboat) `rowboat` — free, pirate-port: A small open boat with bench seats, a pair of oars and optional cargo in the bow.