Server definition
- Hash
- sha256:8caeb9cf10cfdf1227be4234585fa290b6a8d242a464ae787d159273b17d05f0
- What it is
- What a remote MCP server returned when asked what it offers: 31 tools
The blob, as servednamed by its sha256
{
"instructions": "Start with discover_calculators and prepare_calculation. Ask missing questions before running a real-job calculation; defaults are examples, not confirmed project facts. Confirm labour, rates, VAT and markup versus gross margin. Use returned totals only and show warnings, assumptions and defaulted inputs. Scope review checks line completeness only. Read records before writes and use returned versions. Reuse the same idempotency key for the same uncertain retry; read back after a conflict. Drafting never authorizes sending. Prepare the exact payload, show the recipient and document, and obtain explicit user confirmation before sending or recording payment. Never treat a receipt as proof that an invoice was paid.",
"tools": [
{
"description": "Adds one actual or forecast job cost to an owned job.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"actualCost": {
"type": "number"
},
"description": {
"type": "string"
},
"expectedVersion": {
"type": "string"
},
"expenseDate": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"itemType": {
"enum": [
"materials",
"labour",
"subcontractor",
"hire",
"other"
],
"type": "string"
},
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"quantity": {
"type": "number"
},
"trade": {
"type": "string"
},
"unit": {
"type": "string"
},
"unitCost": {
"type": "number"
}
},
"required": [
"idempotencyKey",
"jobId",
"trade",
"description",
"itemType",
"quantity",
"unit",
"unitCost"
],
"type": "object"
},
"name": "add_job_cost",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Registers a host-provided file after upload reservation validation. It never performs OCR or plan reading.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"fileName": {
"type": "string"
},
"fileSize": {
"type": "number"
},
"hostFileUrl": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"jobId": {
"type": "string"
},
"mimeType": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"jobId",
"fileName",
"mimeType",
"fileSize",
"hostFileUrl"
],
"type": "object"
},
"name": "attach_job_file",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Runs and compares up to five scenarios using the same versioned QuoteBuild formula.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calculatorId": {
"enum": [
"bathroom",
"kitchen",
"extension",
"flatRoof",
"boarding",
"room",
"patio"
],
"type": "string"
},
"scenarios": {
"items": {
"properties": {
"name": {
"type": "string"
},
"pricing": {
"properties": {
"contingencyPercent": {
"type": "number"
},
"marginMode": {
"default": "markup",
"enum": [
"markup",
"gross_margin"
],
"type": "string"
},
"marginPercent": {
"type": "number"
},
"vatPercent": {
"type": "number"
}
},
"type": "object"
},
"values": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"name",
"values"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"calculatorId",
"scenarios"
],
"type": "object"
},
"name": "compare_calculations",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Creates an unsent invoice draft and calculates its amount from the supplied reviewed lines inside QuoteBuild.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"dueDate": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"invoiceNumber": {
"type": "string"
},
"items": {
"items": {
"properties": {
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"description": {
"type": "string"
},
"quantity": {
"type": "number"
},
"rate": {
"type": "number"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
},
"trade": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"type": "object"
},
"type": "array"
},
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"quoteId": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"jobId",
"invoiceNumber",
"items"
],
"type": "object"
},
"name": "create_invoice_draft",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Creates an owned job draft. This does not contact the client.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"address": {
"type": "string"
},
"clientEmail": {
"type": "string"
},
"clientName": {
"type": "string"
},
"clientPhone": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"jobType": {
"type": "string"
},
"name": {
"type": "string"
},
"notes": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"name",
"clientName",
"jobType"
],
"type": "object"
},
"name": "create_job",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Creates an unsent quote from an owned, versioned estimate and recalculates every monetary total inside QuoteBuild.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"estimateVersionNumber": {
"type": "number"
},
"expectedVersion": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"quoteNumber": {
"type": "string"
},
"validUntil": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"jobId",
"expectedVersion",
"quoteNumber"
],
"type": "object"
},
"name": "create_quote_draft",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Creates an unsent variation draft and calculates its amount from the supplied reviewed lines inside QuoteBuild.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"description": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"items": {
"items": {
"properties": {
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"description": {
"type": "string"
},
"quantity": {
"type": "number"
},
"rate": {
"type": "number"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
},
"trade": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"type": "object"
},
"type": "array"
},
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"quoteId": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"jobId",
"description",
"items"
],
"type": "object"
},
"name": "create_variation_draft",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Finds the narrowest deterministic QuoteBuild calculator for a UK building task.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string"
}
},
"type": "object"
},
"name": "discover_calculators",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Returns subscription and trial entitlement status, never payment-card data.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_billing_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Returns aggregate business and margin totals for an owned date range.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "get_business_report",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Gets the latest or requested immutable estimate version for one owned job.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"jobId": {
"type": "string"
},
"versionNumber": {
"type": "number"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "get_estimate",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Gets one owned job with client data redacted unless clients:read is granted.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "get_job",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Returns current estimate, quote, cost, variation and invoice totals for one owned job.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "get_job_financials",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Gets one owned quote and its recipient-visible pack data.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"quoteId": {
"type": "string"
}
},
"required": [
"quoteId"
],
"type": "object"
},
"name": "get_quote",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Lists invoices belonging to one owned job.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "list_invoices",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Lists job photos and files without exposing private storage credentials.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "list_job_files",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Lists the signed-in user’s jobs. Client contact details and full addresses are omitted unless clients:read is granted.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"default": 25,
"type": "number"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"name": "list_jobs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Lists variations belonging to one owned job.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"jobId": {
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
},
"name": "list_variations",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Returns the exact questions and typed inputs required before a deterministic calculation can run.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calculatorId": {
"enum": [
"bathroom",
"kitchen",
"extension",
"flatRoof",
"boarding",
"room",
"patio"
],
"type": "string"
},
"supplied": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"calculatorId"
],
"type": "object"
},
"name": "prepare_calculation",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Shows the exact unpaid invoice and records a one-use ten-minute confirmation. It does not mark the invoice paid.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"expectedVersion": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"invoiceId": {
"type": "string"
},
"paidAt": {
"type": "string"
},
"paymentMethod": {
"enum": [
"bank_transfer",
"cash",
"card",
"cheque",
"other"
],
"type": "string"
},
"paymentProofId": {
"type": "string"
},
"paymentReference": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"invoiceId",
"expectedVersion",
"paymentMethod"
],
"type": "object"
},
"name": "prepare_invoice_payment_record",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Previews the exact current invoice recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"expectedVersion": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"invoiceId": {
"type": "string"
}
},
"required": [
"invoiceId",
"expectedVersion",
"idempotencyKey"
],
"type": "object"
},
"name": "prepare_invoice_send",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Creates a one-time, ten-minute secure image upload for a supplier receipt, customer payment proof or job evidence. Uploading proof never marks an invoice as paid.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"costItemId": {
"type": "string"
},
"fileName": {
"type": "string"
},
"fileSize": {
"type": "number"
},
"idempotencyKey": {
"type": "string"
},
"invoiceId": {
"type": "string"
},
"jobId": {
"type": "string"
},
"kind": {
"enum": [
"supplier_receipt",
"customer_payment_proof",
"job_evidence"
],
"type": "string"
},
"mimeType": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"jobId",
"kind",
"fileName",
"mimeType",
"fileSize"
],
"type": "object"
},
"name": "prepare_job_evidence_upload",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Previews the exact current quote recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"expectedVersion": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"quoteId": {
"type": "string"
}
},
"required": [
"quoteId",
"expectedVersion",
"idempotencyKey"
],
"type": "object"
},
"name": "prepare_quote_send",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Previews the exact current variation recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"expectedVersion": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"variationId": {
"type": "string"
}
},
"required": [
"variationId",
"expectedVersion",
"idempotencyKey"
],
"type": "object"
},
"name": "prepare_variation_send",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Marks the exact prepared invoice as paid only after an explicit, one-use confirmation. It never contacts the customer or payment provider.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"confirmationToken": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"invoiceId": {
"type": "string"
}
},
"required": [
"idempotencyKey",
"invoiceId",
"confirmationToken"
],
"type": "object"
},
"name": "record_invoice_payment",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Checks line completeness, unresolved scope and zero rates without changing the estimate. This does not establish construction scope completeness or readiness to quote.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"items": {
"items": {
"properties": {
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"description": {
"type": "string"
},
"quantity": {
"type": "number"
},
"rate": {
"type": "number"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
},
"trade": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"name": "review_estimate_scope",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Runs one versioned QuoteBuild formula. Missing inputs use disclosed example defaults; confirm them and labour inclusion before drafting. Rates are baseline allowances. The model must not calculate monetary totals itself.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"calculatorId": {
"enum": [
"bathroom",
"kitchen",
"extension",
"flatRoof",
"boarding",
"room",
"patio"
],
"type": "string"
},
"pricing": {
"properties": {
"contingencyPercent": {
"type": "number"
},
"marginMode": {
"default": "markup",
"enum": [
"markup",
"gross_margin"
],
"type": "string"
},
"marginPercent": {
"type": "number"
},
"vatPercent": {
"type": "number"
}
},
"type": "object"
},
"values": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"calculatorId",
"values"
],
"type": "object"
},
"name": "run_calculation",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Creates a new immutable estimate version; it never overwrites the last valid version.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"contingencyPercent": {
"default": 0,
"type": "number"
},
"expectedVersion": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"items": {
"items": {
"properties": {
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"description": {
"type": "string"
},
"quantity": {
"type": "number"
},
"rate": {
"type": "number"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
},
"trade": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"type": "object"
},
"type": "array"
},
"jobId": {
"type": "string"
},
"label": {
"type": "string"
},
"marginLabour": {
"default": 30,
"type": "number"
},
"marginMaterials": {
"default": 20,
"type": "number"
},
"notes": {
"type": "string"
},
"vatEnabled": {
"default": false,
"type": "boolean"
},
"vatRate": {
"default": 20,
"type": "number"
}
},
"required": [
"idempotencyKey",
"jobId",
"items"
],
"type": "object"
},
"name": "save_estimate_draft",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Sends the exact prepared invoice payload after validating the one-use confirmation token.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"confirmationToken": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"invoiceId": {
"type": "string"
}
},
"required": [
"invoiceId",
"confirmationToken",
"idempotencyKey"
],
"type": "object"
},
"name": "send_invoice",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Sends the exact prepared quote payload after validating the one-use confirmation token.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"confirmationToken": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"quoteId": {
"type": "string"
}
},
"required": [
"quoteId",
"confirmationToken",
"idempotencyKey"
],
"type": "object"
},
"name": "send_quote",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
},
{
"description": "Sends the exact prepared variation payload after validating the one-use confirmation token.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"confirmationToken": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"variationId": {
"type": "string"
}
},
"required": [
"variationId",
"confirmationToken",
"idempotencyKey"
],
"type": "object"
},
"name": "send_variation",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumptions": {
"items": {
"type": "string"
},
"type": "array"
},
"data": {},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextActions": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"required": [
"action",
"requiresConfirmation"
],
"type": "object"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"provenance": {
"additionalProperties": false,
"properties": {
"calculationRunId": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"rateSources": {
"items": {
"type": "string"
},
"type": "array"
},
"recordVersion": {
"type": "string"
}
},
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:8caeb9cf10cfdf1227be4234585fa290b6a8d242a464ae787d159273b17d05f0 | sha256sum