For the complete documentation index, see llms.txt.
Estimate carpet area, waste, roll length, padding, installation, and cost.
One POST adds Carpet Calculator to your app, site, workflow, or agent — formula, validation, edge cases, and docs already handled.
prefer a UI? Open the Carpet Calculator on miniwebtool.com →
POST https://api.miniwebtool.com/v1/tools/carpet-calculator/run
| Field | Type | Req. |
|---|---|---|
room_shape
rectangle | l_shape
|
str |
— |
unit
ft | in | m | cm
|
str |
— |
length
|
float | None |
— |
width
|
float | None |
— |
l1
|
float | None |
— |
w1
|
float | None |
— |
l2
|
float | None |
— |
w2
|
float | None |
— |
carpet_grade
budget | mid | premium | luxury | custom
|
str |
— |
custom_price_per_sqft
|
float | None |
— |
padding
none | basic | standard | premium | luxury
|
str |
— |
roll_width_ft
|
float |
— |
waste_percent
|
float |
— |
install_cost_per_sqft
|
float |
— |
precision
|
int |
— |
65536 bytes.hash_only{
"request_id": "01K...",
"tool": "carpet-calculator",
"tool_version": "2026-04-22",
"credits_used": 1,
"result": { ... }
}
curl -X POST https://api.miniwebtool.com/v1/tools/carpet-calculator/run \
-H 'Authorization: Bearer mwt_live_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"room_shape":"rectangle","unit":"ft","length":12,"width":10,"carpet_grade":"mid","padding":"standard","roll_width_ft":12,"waste_percent":10,"install_cost_per_sqft":1.5,"precision":2}'
import requests
resp = requests.post(
'https://api.miniwebtool.com/v1/tools/carpet-calculator/run',
headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
json={'room_shape': 'rectangle', 'unit': 'ft', 'length': 12, 'width': 10, 'carpet_grade': 'mid', 'padding': 'standard', 'roll_width_ft': 12, 'waste_percent': 10, 'install_cost_per_sqft': 1.5, 'precision': 2},
)
resp.raise_for_status()
print(resp.json())
const resp = await fetch(
'https://api.miniwebtool.com/v1/tools/carpet-calculator/run',
{
method: 'POST',
headers: {
'Authorization': 'Bearer mwt_live_YOUR_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({"room_shape":"rectangle","unit":"ft","length":12,"width":10,"carpet_grade":"mid","padding":"standard","roll_width_ft":12,"waste_percent":10,"install_cost_per_sqft":1.5,"precision":2}),
}
);
const data = await resp.json();
console.log(data);
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/carpet-calculator/run');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer mwt_live_YOUR_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'room_shape' => 'rectangle',
'unit' => 'ft',
'length' => 12,
'width' => 10,
'carpet_grade' => 'mid',
'padding' => 'standard',
'roll_width_ft' => 12,
'waste_percent' => 10,
'install_cost_per_sqft' => 1.5,
'precision' => 2
]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
require 'net/http'
require 'json'
require 'uri'
uri = URI('https://api.miniwebtool.com/v1/tools/carpet-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 = {
'room_shape' => 'rectangle',
'unit' => 'ft',
'length' => 12,
'width' => 10,
'carpet_grade' => 'mid',
'padding' => 'standard',
'roll_width_ft' => 12,
'waste_percent' => 10,
'install_cost_per_sqft' => 1.5,
'precision' => 2
}.to_json
resp = http.request(req)
puts JSON.parse(resp.body).inspect
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
body, _ := json.Marshal(map[string]interface{}{
"room_shape": "rectangle",
"unit": "ft",
"length": 12,
"width": 10,
"carpet_grade": "mid",
"padding": "standard",
"roll_width_ft": 12,
"waste_percent": 10,
"install_cost_per_sqft": 1.5,
"precision": 2,
})
req, _ := http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/carpet-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))
}
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/carpet-calculator/run"))
.header("Authorization", "Bearer mwt_live_YOUR_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("{\"room_shape\":\"rectangle\",\"unit\":\"ft\",\"length\":12,\"width\":10,\"carpet_grade\":\"mid\",\"padding\":\"standard\",\"roll_width_ft\":12,\"waste_percent\":10,\"install_cost_per_sqft\":1.5,\"precision\":2}"))
.build();
var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
https://api.miniwebtool.com/v1/tools/carpet-calculator/run
Authorization: Bearer <key> and Content-Type: application/json. Copy-paste snippets in 7 languages are under Code examples.
{request_id, tool, tool_version, credits_used, result}. The typed output lives in result.
Estimate carpet area, waste, roll length, padding, installation, and cost. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.
1 credit per successful call. Failed calls (validation errors, 5xx) don't bill.
Required fields: (none). Full schema at /v1/openapi.json.
Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version.
Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `carpet-calculator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.
JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.
Every endpoint on this site is also exposed via the
Model Context Protocol at
https://api.miniwebtool.com/v1/mcp.
Claude, Cursor, and any MCP-capable agent can discover this tool
(carpet-calculator)
and its JSON Schema automatically — no client codegen.
# 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=="carpet-calculator")'