QuoteBuild is an MCP server published by io.github.joea836, hosted at mcp.quotebuild.co.uk. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 31 tools, including discover_calculators, prepare_calculation, run_calculation, compare_calculations, review_estimate_scope.
UK building calculators, estimate comparisons and account-scoped quoting and job costs.
1,196 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Finds the narrowest deterministic QuoteBuild calculator for a UK building task.
| Parameter | Type | Description |
|---|---|---|
| query | string |
{
"name": "discover_calculators",
"title": "Discover QuoteBuild calculators",
"description": "Finds the narrowest deterministic QuoteBuild calculator for a UK building task.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns the exact questions and typed inputs required before a deterministic calculation can run.
| Parameter | Type | Description |
|---|---|---|
| supplied | object | |
| calculatorId * | string | one of ["bathroom","kitchen","extension","flatRoof","boarding","room","patio"] |
{
"name": "prepare_calculation",
"title": "Prepare a calculation",
"description": "Returns the exact questions and typed inputs required before a deterministic calculation can run.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"calculatorId"
],
"properties": {
"supplied": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"calculatorId": {
"enum": [
"bathroom",
"kitchen",
"extension",
"flatRoof",
"boarding",
"room",
"patio"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| values * | object | |
| pricing | object | |
| calculatorId * | string | one of ["bathroom","kitchen","extension","flatRoof","boarding","room","patio"] |
{
"name": "run_calculation",
"title": "Run a QuoteBuild calculation",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"calculatorId",
"values"
],
"properties": {
"values": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"pricing": {
"type": "object",
"properties": {
"marginMode": {
"enum": [
"markup",
"gross_margin"
],
"type": "string",
"default": "markup"
},
"vatPercent": {
"type": "number"
},
"marginPercent": {
"type": "number"
},
"contingencyPercent": {
"type": "number"
}
}
},
"calculatorId": {
"enum": [
"bathroom",
"kitchen",
"extension",
"flatRoof",
"boarding",
"room",
"patio"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Runs and compares up to five scenarios using the same versioned QuoteBuild formula.
| Parameter | Type | Description |
|---|---|---|
| scenarios * | array | |
| calculatorId * | string | one of ["bathroom","kitchen","extension","flatRoof","boarding","room","patio"] |
{
"name": "compare_calculations",
"title": "Compare calculation scenarios",
"description": "Runs and compares up to five scenarios using the same versioned QuoteBuild formula.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"calculatorId",
"scenarios"
],
"properties": {
"scenarios": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"values"
],
"properties": {
"name": {
"type": "string"
},
"values": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"pricing": {
"type": "object",
"properties": {
"marginMode": {
"enum": [
"markup",
"gross_margin"
],
"type": "string",
"default": "markup"
},
"vatPercent": {
"type": "number"
},
"marginPercent": {
"type": "number"
},
"contingencyPercent": {
"type": "number"
}
}
}
}
}
},
"calculatorId": {
"enum": [
"bathroom",
"kitchen",
"extension",
"flatRoof",
"boarding",
"room",
"patio"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Checks line completeness, unresolved scope and zero rates without changing the estimate. This does not establish construction scope completeness or readiness to quote.
| Parameter | Type | Description |
|---|---|---|
| items * | array |
{
"name": "review_estimate_scope",
"title": "Review estimate scope",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"properties": {
"rate": {
"type": "number"
},
"unit": {
"type": "string"
},
"trade": {
"type": "string"
},
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"quantity": {
"type": "number"
},
"description": {
"type": "string"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
}
}
}
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Lists the signed-in user’s jobs. Client contact details and full addresses are omitted unless clients:read is granted.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| status | string |
{
"name": "list_jobs",
"title": "List jobs",
"description": "Lists the signed-in user’s jobs. Client contact details and full addresses are omitted unless clients:read is granted.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"default": 25
},
"status": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Gets one owned job with client data redacted unless clients:read is granted.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string |
{
"name": "get_job",
"title": "Get job",
"description": "Gets one owned job with client data redacted unless clients:read is granted.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Gets the latest or requested immutable estimate version for one owned job.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| versionNumber | number |
{
"name": "get_estimate",
"title": "Get estimate",
"description": "Gets the latest or requested immutable estimate version for one owned job.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
},
"versionNumber": {
"type": "number"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Gets one owned quote and its recipient-visible pack data.
| Parameter | Type | Description |
|---|---|---|
| quoteId * | string |
{
"name": "get_quote",
"title": "Get quote",
"description": "Gets one owned quote and its recipient-visible pack data.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"quoteId"
],
"properties": {
"quoteId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns current estimate, quote, cost, variation and invoice totals for one owned job.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string |
{
"name": "get_job_financials",
"title": "Get job financials",
"description": "Returns current estimate, quote, cost, variation and invoice totals for one owned job.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Lists variations belonging to one owned job.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string |
{
"name": "list_variations",
"title": "List variations",
"description": "Lists variations belonging to one owned job.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Lists invoices belonging to one owned job.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string |
{
"name": "list_invoices",
"title": "List invoices",
"description": "Lists invoices belonging to one owned job.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Lists job photos and files without exposing private storage credentials.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string |
{
"name": "list_job_files",
"title": "List job files",
"description": "Lists job photos and files without exposing private storage credentials.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns aggregate business and margin totals for an owned date range.
| Parameter | Type | Description |
|---|---|---|
| to * | string | |
| from * | string |
{
"name": "get_business_report",
"title": "Get business report",
"description": "Returns aggregate business and margin totals for an owned date range.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Returns subscription and trial entitlement status, never payment-card data.
No parameters.
{
"name": "get_billing_status",
"title": "Get billing status",
"description": "Returns subscription and trial entitlement status, never payment-card data.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Creates an owned job draft. This does not contact the client.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| notes | string | |
| address | string | |
| jobType * | string | |
| clientName * | string | |
| clientEmail | string | |
| clientPhone | string | |
| idempotencyKey * | string |
{
"name": "create_job",
"title": "Create job draft",
"description": "Creates an owned job draft. This does not contact the client.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"name",
"clientName",
"jobType"
],
"properties": {
"name": {
"type": "string"
},
"notes": {
"type": "string"
},
"address": {
"type": "string"
},
"jobType": {
"type": "string"
},
"clientName": {
"type": "string"
},
"clientEmail": {
"type": "string"
},
"clientPhone": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Creates a new immutable estimate version; it never overwrites the last valid version.
| Parameter | Type | Description |
|---|---|---|
| items * | array | |
| jobId * | string | |
| label | string | |
| notes | string | |
| vatRate | number | |
| vatEnabled | boolean | |
| marginLabour | number | |
| idempotencyKey * | string | |
| expectedVersion | string | |
| marginMaterials | number | |
| contingencyPercent | number |
Creates an unsent quote from an owned, versioned estimate and recalculates every monetary total inside QuoteBuild.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| notes | string | |
| validUntil | string | |
| quoteNumber * | string | |
| idempotencyKey * | string | |
| expectedVersion * | string | |
| estimateVersionNumber | number |
{
"name": "create_quote_draft",
"title": "Create quote draft",
"description": "Creates an unsent quote from an owned, versioned estimate and recalculates every monetary total inside QuoteBuild.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"jobId",
"expectedVersion",
"quoteNumber"
],
"properties": {
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"validUntil": {
"type": "string"
},
"quoteNumber": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"expectedVersion": {
"type": "string"
},
"estimateVersionNumber": {
"type": "number"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Adds one actual or forecast job cost to an owned job.
| Parameter | Type | Description |
|---|---|---|
| unit * | string | |
| jobId * | string | |
| notes | string | |
| trade * | string | |
| itemType * | string | one of ["materials","labour","subcontractor","hire","other"] |
| quantity * | number | |
| unitCost * | number | |
| actualCost | number | |
| description * | string | |
| expenseDate | string | |
| idempotencyKey * | string | |
| expectedVersion |
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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["supplier_receipt","customer_payment_proof","job_evidence"] |
| note | string | |
| jobId * | string | |
| fileName * | string | |
| fileSize * | number | |
| mimeType * | string | one of ["image/jpeg","image/png","image/webp"] |
| invoiceId | string | |
| costItemId | string | |
| idempotencyKey * | string |
Registers a host-provided file after upload reservation validation. It never performs OCR or plan reading.
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| fileName * | string | |
| fileSize * | number | |
| mimeType * | string | |
| hostFileUrl * | string | |
| idempotencyKey * | string |
{
"name": "attach_job_file",
"title": "Attach job file",
"description": "Registers a host-provided file after upload reservation validation. It never performs OCR or plan reading.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"jobId",
"fileName",
"mimeType",
"fileSize",
"hostFileUrl"
],
"properties": {
"jobId": {
"type": "string"
},
"fileName": {
"type": "string"
},
"fileSize": {
"type": "number"
},
"mimeType": {
"type": "string"
},
"hostFileUrl": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Creates an unsent variation draft and calculates its amount from the supplied reviewed lines inside QuoteBuild.
| Parameter | Type | Description |
|---|---|---|
| items * | array | |
| jobId * | string | |
| notes | string | |
| quoteId | string | |
| description * | string | |
| idempotencyKey * | string |
{
"name": "create_variation_draft",
"title": "Create variation draft",
"description": "Creates an unsent variation draft and calculates its amount from the supplied reviewed lines inside QuoteBuild.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"jobId",
"description",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"properties": {
"rate": {
"type": "number"
},
"unit": {
"type": "string"
},
"trade": {
"type": "string"
},
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"quantity": {
"type": "number"
},
"description": {
"type": "string"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
}
}
}
},
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"quoteId": {
"type": "string"
},
"description": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Creates an unsent invoice draft and calculates its amount from the supplied reviewed lines inside QuoteBuild.
| Parameter | Type | Description |
|---|---|---|
| items * | array | |
| jobId * | string | |
| notes | string | |
| dueDate | string | |
| quoteId | string | |
| invoiceNumber * | string | |
| idempotencyKey * | string |
{
"name": "create_invoice_draft",
"title": "Create invoice draft",
"description": "Creates an unsent invoice draft and calculates its amount from the supplied reviewed lines inside QuoteBuild.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"jobId",
"invoiceNumber",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"properties": {
"rate": {
"type": "number"
},
"unit": {
"type": "string"
},
"trade": {
"type": "string"
},
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"quantity": {
"type": "number"
},
"description": {
"type": "string"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
}
}
}
},
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"dueDate": {
"type": "string"
},
"quoteId": {
"type": "string"
},
"invoiceNumber": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Shows the exact unpaid invoice and records a one-use ten-minute confirmation. It does not mark the invoice paid.
| Parameter | Type | Description |
|---|---|---|
| paidAt | string | |
| invoiceId * | string | |
| paymentMethod * | string | one of ["bank_transfer","cash","card","cheque","other"] |
| idempotencyKey * | string | |
| paymentProofId | string | |
| expectedVersion * | string | |
| paymentReference | string |
{
"name": "prepare_invoice_payment_record",
"title": "Prepare invoice payment record",
"description": "Shows the exact unpaid invoice and records a one-use ten-minute confirmation. It does not mark the invoice paid.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"invoiceId",
"expectedVersion",
"paymentMethod"
],
"properties": {
"paidAt": {
"type": "string"
},
"invoiceId": {
"type": "string"
},
"paymentMethod": {
"enum": [
"bank_transfer",
"cash",
"card",
"cheque",
"other"
],
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"paymentProofId": {
"type": "string"
},
"expectedVersion": {
"type": "string"
},
"paymentReference": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Marks the exact prepared invoice as paid only after an explicit, one-use confirmation. It never contacts the customer or payment provider.
| Parameter | Type | Description |
|---|---|---|
| invoiceId * | string | |
| idempotencyKey * | string | |
| confirmationToken * | string |
{
"name": "record_invoice_payment",
"title": "Record confirmed invoice payment",
"description": "Marks the exact prepared invoice as paid only after an explicit, one-use confirmation. It never contacts the customer or payment provider.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"invoiceId",
"confirmationToken"
],
"properties": {
"invoiceId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"confirmationToken": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Previews the exact current quote recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.
| Parameter | Type | Description |
|---|---|---|
| quoteId * | string | |
| idempotencyKey * | string | |
| expectedVersion * | string |
{
"name": "prepare_quote_send",
"title": "Prepare quote send",
"description": "Previews the exact current quote recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"quoteId",
"expectedVersion",
"idempotencyKey"
],
"properties": {
"quoteId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"expectedVersion": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Sends the exact prepared quote payload after validating the one-use confirmation token.
| Parameter | Type | Description |
|---|---|---|
| quoteId * | string | |
| idempotencyKey * | string | |
| confirmationToken * | string |
{
"name": "send_quote",
"title": "Send quote",
"description": "Sends the exact prepared quote payload after validating the one-use confirmation token.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"quoteId",
"confirmationToken",
"idempotencyKey"
],
"properties": {
"quoteId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"confirmationToken": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Previews the exact current variation recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.
| Parameter | Type | Description |
|---|---|---|
| variationId * | string | |
| idempotencyKey * | string | |
| expectedVersion * | string |
{
"name": "prepare_variation_send",
"title": "Prepare variation send",
"description": "Previews the exact current variation recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"variationId",
"expectedVersion",
"idempotencyKey"
],
"properties": {
"variationId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"expectedVersion": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Sends the exact prepared variation payload after validating the one-use confirmation token.
| Parameter | Type | Description |
|---|---|---|
| variationId * | string | |
| idempotencyKey * | string | |
| confirmationToken * | string |
{
"name": "send_variation",
"title": "Send variation",
"description": "Sends the exact prepared variation payload after validating the one-use confirmation token.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"variationId",
"confirmationToken",
"idempotencyKey"
],
"properties": {
"variationId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"confirmationToken": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Previews the exact current invoice recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.
| Parameter | Type | Description |
|---|---|---|
| invoiceId * | string | |
| idempotencyKey * | string | |
| expectedVersion * | string |
{
"name": "prepare_invoice_send",
"title": "Prepare invoice send",
"description": "Previews the exact current invoice recipient and payload, then stores a one-use ten-minute confirmation token. This does not send.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"invoiceId",
"expectedVersion",
"idempotencyKey"
],
"properties": {
"invoiceId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"expectedVersion": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Sends the exact prepared invoice payload after validating the one-use confirmation token.
| Parameter | Type | Description |
|---|---|---|
| invoiceId * | string | |
| idempotencyKey * | string | |
| confirmationToken * | string |
{
"name": "send_invoice",
"title": "Send invoice",
"description": "Sends the exact prepared invoice payload after validating the one-use confirmation token.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"invoiceId",
"confirmationToken",
"idempotencyKey"
],
"properties": {
"invoiceId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"confirmationToken": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}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.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "save_estimate_draft",
"title": "Save estimate version",
"description": "Creates a new immutable estimate version; it never overwrites the last valid version.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"jobId",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"trade",
"description",
"quantity",
"unit",
"rate",
"category"
],
"properties": {
"rate": {
"type": "number"
},
"unit": {
"type": "string"
},
"trade": {
"type": "string"
},
"category": {
"enum": [
"materials",
"labour",
"hire"
],
"type": "string"
},
"quantity": {
"type": "number"
},
"description": {
"type": "string"
},
"scopeStatus": {
"enum": [
"included",
"excluded",
"optional",
"provisional_sum",
"client_supplied",
"contractor_supplied",
"by_others",
"to_be_confirmed"
],
"type": "string"
}
}
}
},
"jobId": {
"type": "string"
},
"label": {
"type": "string"
},
"notes": {
"type": "string"
},
"vatRate": {
"type": "number",
"default": 20
},
"vatEnabled": {
"type": "boolean",
"default": false
},
"marginLabour": {
"type": "number",
"default": 30
},
"idempotencyKey": {
"type": "string"
},
"expectedVersion": {
"type": "string"
},
"marginMaterials": {
"type": "number",
"default": 20
},
"contingencyPercent": {
"type": "number",
"default": 0
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| string |
{
"name": "add_job_cost",
"title": "Add live job cost",
"description": "Adds one actual or forecast job cost to an owned job.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"jobId",
"trade",
"description",
"itemType",
"quantity",
"unit",
"unitCost"
],
"properties": {
"unit": {
"type": "string"
},
"jobId": {
"type": "string"
},
"notes": {
"type": "string"
},
"trade": {
"type": "string"
},
"itemType": {
"enum": [
"materials",
"labour",
"subcontractor",
"hire",
"other"
],
"type": "string"
},
"quantity": {
"type": "number"
},
"unitCost": {
"type": "number"
},
"actualCost": {
"type": "number"
},
"description": {
"type": "string"
},
"expenseDate": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
},
"expectedVersion": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}{
"name": "prepare_job_evidence_upload",
"title": "Prepare receipt or payment-proof upload",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotencyKey",
"jobId",
"kind",
"fileName",
"mimeType",
"fileSize"
],
"properties": {
"kind": {
"enum": [
"supplier_receipt",
"customer_payment_proof",
"job_evidence"
],
"type": "string"
},
"note": {
"type": "string"
},
"jobId": {
"type": "string"
},
"fileName": {
"type": "string"
},
"fileSize": {
"type": "number"
},
"mimeType": {
"enum": [
"image/jpeg",
"image/png",
"image/webp"
],
"type": "string"
},
"invoiceId": {
"type": "string"
},
"costItemId": {
"type": "string"
},
"idempotencyKey": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"warnings",
"assumptions",
"nextActions"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UNAUTHENTICATED",
"FORBIDDEN",
"VALIDATION_ERROR",
"CONFLICT",
"RATE_LIMITED",
"FEATURE_UNAVAILABLE",
"RETRYABLE"
],
"type": "string"
},
"message": {
"type": "string"
},
"recovery": {
"type": "string"
}
},
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"provenance": {
"type": "object",
"properties": {
"rateSources": {
"type": "array",
"items": {
"type": "string"
}
},
"recordVersion": {
"type": "string"
},
"formulaVersion": {
"type": "number"
},
"calculationRunId": {
"type": "string"
}
},
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"nextActions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"requiresConfirmation"
],
"properties": {
"action": {
"type": "string"
},
"requiresConfirmation": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}