API & MCP

Everything a person can do on UV Unwrap (LSCM) for OBJ, STL and PLY, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://renderloomuvunwrap.usefulweb.app/api/v1/calculate – run UV Unwrap (LSCM) for OBJ, STL and PLY
GET https://renderloomuvunwrap.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

UV Unwrap (LSCM) for OBJ, STL and PLY

Upload a triangle mesh to get texture coordinates: seams at sharp edges or along your own vertex paths, charts flattened with least-squares conformal maps (LSCM), packed into the unit square with padding, and a distortion report per chart (angle error, quasi-conformal ratio, area distortion, L² stretch). Download an OBJ with vt coordinates and the UV layout as SVG. Runs on the same engine as Renderloom Sculpt Lab.

Inputs of UV Unwrap (LSCM) for OBJ, STL and PLY
Field	Type	Default	Description
`file`	file	—	Mesh file (STL, OBJ or PLY). A triangle mesh up to 200000 triangles. Coincident vertices are welded and faces oriented before unwrapping.
`seamMode`	select (angle, none)	"angle"	Automatic seams
`seamAngle`	number	66	Seam angle (°). Edges whose neighbouring faces bend by at least this angle become seams.
`seams`	textarea	—	Manual seams (vertex numbers). Paths of vertex numbers (1-based, as in OBJ, after welding). Consecutive vertices are joined along the shortest edge path. Separate paths with a semicolon or a new line.
`maxAreaDistortion`	number	0	Split charts above this area distortion (0 = off). Mean \|ln(area ratio)\| of a chart. Lower values give more, flatter charts.
`maxCharts`	integer	64	Maximum number of charts
`resolution`	integer	1024	Texture resolution for the padding (px)
`padding`	integer	4	Padding between charts (px)
`rotate`	boolean	true	Rotate charts to their smallest bounding rectangle

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://renderloomuvunwrap.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: renderloom_uv_unwrap
Local stdio connector: node src/mcp-stdio.ts --tool=renderloom-uv-unwrap

{
  "mcpServers": {
    "renderloom-uv-unwrap": { "type": "http", "url": "https://renderloomuvunwrap.usefulweb.app/mcp" }
  }
}