API & MCP
Everything a person can do on 3D Mesh Boolean (union, difference, intersection), a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://renderloommeshboolean.usefulweb.app/api/v1/calculate– run 3D Mesh Boolean (union, difference, intersection)GET https://renderloommeshboolean.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
3D Mesh Boolean (union, difference, intersection)
Upload two closed STL, OBJ, PLY or GLB meshes and get their union, difference (first minus second) or intersection as a new watertight mesh. Move the second mesh with an offset, then download the result as STL, OBJ, PLY or GLB with a volume report.
| Field | Type | Default | Description |
|---|---|---|---|
fileA (required) | file | — | First mesh (STL, OBJ, PLY or GLB). A closed mesh with up to 60000 triangles. |
fileB (required) | file | — | Second mesh (STL, OBJ, PLY or GLB). A closed mesh with up to 60000 triangles. For a difference, this is the part that is cut away. |
operation | select (union, difference, intersection) | "union" | Operation |
offsetX | number | 0 | Move the second mesh along X |
offsetY | number | 0 | Move the second mesh along Y |
offsetZ | number | 0 | Move the second mesh along Z |
unit | select (mm, cm, m, in) | "mm" | Model units. Used for the volume in cm³ and for GLB output (GLB stores metres). Both meshes must use the same units. |
output | select (stl-binary, stl-ascii, obj, ply-binary, ply-ascii, glb) | "stl-binary" | Output format |
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://renderloommeshboolean.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
renderloom_mesh_boolean - Local stdio connector:
node src/mcp-stdio.ts --tool=renderloom-mesh-boolean
{
"mcpServers": {
"renderloom-mesh-boolean": { "type": "http", "url": "https://renderloommeshboolean.usefulweb.app/mcp" }
}
}