> For the complete documentation index, see [llms.txt](/llms.txt). [miniwebtool /api](/) [tools](/tools/) [docs](/docs/) [reference](/v1/docs) [pricing](/#pricing) [log in](/dashboard/login/) [get free key →](/billing/checkout/?plan=free) - [~](/) - / - [tools](/tools/) - / - [construction](/tools/#construction) - / - Tile Calculator API # Tile Calculator API construction 1 credit / call v2026-04-22 Estimate tile count, boxes, grout, adhesive, sealer, waste, and optional cost. One POST adds Tile Calculator to your app, site, workflow, or agent — formula, validation, edge cases, and docs already handled. prefer a UI? [Open the Tile Calculator on miniwebtool.com →](https://miniwebtool.com/tile-calculator/) [Start free — get a key →](/billing/checkout/?plan=free) 1,000 credits · no card · 30 seconds ### Endpoint POST · 1cr ```text POST https://api.miniwebtool.com/v1/tools/tile-calculator/run ``` ### Request body Field Type Req. `project_type` floor | wall `str` — `unit_system` imperial | metric `str` — `layout_pattern` straight | brick | diagonal | herringbone `str` — `room_length` `float` — `room_width` `float | None` — `wall_height` `float | None` — `tile_length` `float` — `tile_width` `float` — `grout_width` `float` — `waste_percentage` `float` — `tiles_per_box` `int` — `tile_price` `float | None` — `precision` `int` — ### Cost & access - 1 credit per successful call — failed calls refund. - Starts on: Free. - Max payload:`65536`bytes. - Privacy mode:`hash_only` - Available on: free, starter, pro, business, scale ### Response envelope ```text { "request_id": "01K...", "tool": "tile-calculator", "tool_version": "2026-04-22", "credits_used": 1, "result": {... } } ``` ### Try it API key * Stored only in this browser tab. Playground test key is prefilled and only works on this page. [Get a live key →](/billing/checkout/?plan=free) project_type (str) floor wall floor | wall unit_system (str) imperial metric imperial | metric layout_pattern (str) straight brick diagonal herringbone straight | brick | diagonal | herringbone room_length (float) room_width (float | None) wall_height (float | None) tile_length (float) tile_width (float) grout_width (float) waste_percentage (float) tiles_per_box (int) tile_price (float | None) precision (int) Send request → Response copy body This endpoint starts on Free Your key is valid, but its current plan cannot call`tile-calculator`. Upgrade to Free or higher to run this tool. [Start Free →](/billing/checkout/?plan=free) [Compare plans](/#pricing) ```text ``` Response headers ```text ``` ### Code examples cURL Python JavaScript PHP Ruby Go Java copy ```text curl -X POST https://api.miniwebtool.com/v1/tools/tile-calculator/run \ -H 'Authorization: Bearer mwt_live_YOUR_KEY' \ -H 'Content-Type: application/json' \ -d '{"project_type":"floor","unit_system":"imperial","layout_pattern":"straight","room_length":12,"room_width":10,"tile_length":12,"tile_width":12,"grout_width":0.125,"waste_percentage":10,"tiles_per_box":10,"precision":2}' ``` copy ```text import requests resp = requests.post( 'https://api.miniwebtool.com/v1/tools/tile-calculator/run', headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'}, json={'project_type': 'floor', 'unit_system': 'imperial', 'layout_pattern': 'straight', 'room_length': 12, 'room_width': 10, 'tile_length': 12, 'tile_width': 12, 'grout_width': 0.125, 'waste_percentage': 10, 'tiles_per_box': 10, 'precision': 2}, ) resp.raise_for_status() print(resp.json()) ``` copy ```text const resp = await fetch( 'https://api.miniwebtool.com/v1/tools/tile-calculator/run', { method: 'POST', headers: { 'Authorization': 'Bearer mwt_live_YOUR_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({"project_type":"floor","unit_system":"imperial","layout_pattern":"straight","room_length":12,"room_width":10,"tile_length":12,"tile_width":12,"grout_width":0.125,"waste_percentage":10,"tiles_per_box":10,"precision":2}), } ); const data = await resp.json(); console.log(data); ``` copy ```text true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer mwt_live_YOUR_KEY', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'project_type' => 'floor', 'unit_system' => 'imperial', 'layout_pattern' => 'straight', 'room_length' => 12, 'room_width' => 10, 'tile_length' => 12, 'tile_width' => 12, 'grout_width' => 0.125, 'waste_percentage' => 10, 'tiles_per_box' => 10, 'precision' => 2 ]), ]); $resp = curl_exec($ch); curl_close($ch); print_r(json_decode($resp, true)); ``` copy ```text require 'net/http' require 'json' require 'uri' uri = URI('https://api.miniwebtool.com/v1/tools/tile-calculator/run') http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = (uri.scheme == 'https') req = Net::HTTP::Post.new(uri) req['Authorization'] = 'Bearer mwt_live_YOUR_KEY' req['Content-Type'] = 'application/json' req.body = { 'project_type' => 'floor', 'unit_system' => 'imperial', 'layout_pattern' => 'straight', 'room_length' => 12, 'room_width' => 10, 'tile_length' => 12, 'tile_width' => 12, 'grout_width' => 0.125, 'waste_percentage' => 10, 'tiles_per_box' => 10, 'precision' => 2 }.to_json resp = http.request(req) puts JSON.parse(resp.body).inspect ``` copy ```text package main import ( "bytes" "encoding/json" "fmt" "io" "net/http" ) func main() { body, _:= json.Marshal(map[string]interface{}{ "project_type": "floor", "unit_system": "imperial", "layout_pattern": "straight", "room_length": 12, "room_width": 10, "tile_length": 12, "tile_width": 12, "grout_width": 0.125, "waste_percentage": 10, "tiles_per_box": 10, "precision": 2, }) req, _:= http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/tile-calculator/run", bytes.NewReader(body)) req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY") req.Header.Set("Content-Type", "application/json") resp, err:= http.DefaultClient.Do(req) if err!= nil { panic(err) } defer resp.Body.Close() out, _:= io.ReadAll(resp.Body) fmt.Println(string(out)) } ``` copy ```text import java.net.URI; import java.net.http.*; var client = HttpClient.newHttpClient(); var req = HttpRequest.newBuilder() .uri(URI.create("https://api.miniwebtool.com/v1/tools/tile-calculator/run")) .header("Authorization", "Bearer mwt_live_YOUR_KEY") .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString("{\"project_type\":\"floor\",\"unit_system\":\"imperial\",\"layout_pattern\":\"straight\",\"room_length\":12,\"room_width\":10,\"tile_length\":12,\"tile_width\":12,\"grout_width\":0.125,\"waste_percentage\":10,\"tiles_per_box\":10,\"precision\":2}")) .build(); var resp = client.send(req, HttpResponse.BodyHandlers.ofString()); System.out.println(resp.body()); ``` how-to call tile-calculator - Get an API key [Get an API key](/billing/checkout/?plan=free). Sign up free for a bearer token. 1,000 credits/month, no card. - Assemble the JSON body Required fields:. See the Request body table above for the full schema. - POST to`https://api.miniwebtool.com/v1/tools/tile-calculator/run` Headers:`Authorization: Bearer `and`Content-Type: application/json`. Copy-paste snippets in 7 languages are under Code examples. - Parse the response Envelope:`{request_id, tool, tool_version, credits_used, result}`. The typed output lives in`result`. faq frequently asked What does the Tile Calculator API do? + Estimate tile count, boxes, grout, adhesive, sealer, waste, and optional cost. Use it to add this utility without rebuilding formulas, validation, examples, and documentation. How much does one call to Tile Calculator cost? + 1 credit per successful call. Failed calls (validation errors, 5xx) don't bill. What parameters does the Tile Calculator API require? + Required fields: (none). Full schema at /v1/openapi.json. Is the Tile Calculator API deterministic? + Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version. Can an AI agent call the Tile Calculator API? + Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `tile-calculator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result. What format does the API return? + JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`. mcp use from an AI agent Every endpoint on this site is also exposed via the [Model Context Protocol](/docs/#mcp) at`https://api.miniwebtool.com/v1/mcp`. Claude, Cursor, and any MCP-capable agent can discover this tool (`tile-calculator`) and its JSON Schema automatically — no client codegen. ```text # List tools the agent can call curl -s https://api.miniwebtool.com/v1/mcp \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \ | jq '.result.tools[] | select(.name=="tile-calculator")' ``` see-also related construction tools [ Carpet Calculator Estimate carpet area, waste, roll length, padding, installation, and cost. ](/tools/carpet-calculator/) [ Decking Calculator Estimate decking boards, joists, beams, posts, fasteners, and waste. ](/tools/decking-calculator/) [ Wallpaper Calculator Estimate wallpaper drops, rolls, waste, coverage, and optional cost. ](/tools/wallpaper-calculator/) [ Board Foot Calculator Calculate lumber volume in board feet, cubic volume, weight, and optional cost. ](/tools/board-foot-calculator/) API OPERATIONAL v1 · OpenAPI 3.1 · MCP 2025-06-18 [terms](https://miniwebtool.com/about/terms-and-disclaimer/#api-terms) [privacy](https://miniwebtool.com/about/privacy/#api-privacy) [llms.txt](/llms.txt) [consumer site →](https://miniwebtool.com) © 2026 miniwebtool