Receipt extraction, invoice-to-PO quantity allocation, and free three-document discrepancy checks.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Extract and validate structured expense data from receipt text or a provider-neutral receipt extraction. Use when an agent needs merchant, date, tax, total, line items, confidence, duplicate detection, and arithmetic validation before creating or reconciling an expense. The result is advisory and always requires human review. Paid tool: 0.25 USDC per accepted request. Requires an owner-authorized x402-capable client. Use get_document_example with service='receipt' for a fixed free example.
One receipt supplied as bounded OCR text or a provider-neutral structured extraction. Choose exactly one input kind.
Required request contract identifier; send this exact version string.
Receipt fingerprints already known to the caller for duplicate comparison. Supply lowercase 64-character SHA-256 hex strings, or an empty array when none are available; at most 10,000 entries.
Extract and validate structured expense data from receipt text or a provider-neutral receipt extraction. Use when an agent needs merchant, date, tax, total, line items, confidence, duplicate detection, and arithmetic validation before creating or reconciling an expense. The result is advisory and always requires human review. Paid tool: 0.25 USDC per accepted request. Requires an owner-authorized x402-capable client. Use get_document_example with service='receipt' for a fixed free example.
| Argument | Type | Description |
|---|---|---|
| input* | any | One receipt supplied as bounded OCR text or a provider-neutral structured extraction. Choose exactly one input kind. |
| contract_version* | any | Required request contract identifier; send this exact version string. |
| existing_fingerprints* | array | Receipt fingerprints already known to the caller for duplicate comparison. Supply lowercase 64-character SHA-256 hex strings, or an empty array when none are available; at most 10,000 entries. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contract_version",
"input",
"existing_fingerprints"
],
"properties": {
"input": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"text"
],
"properties": {
"kind": {
"const": "text",
"description": "Selects receipt text input; supply the text property."
},
"text": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "OCR or receipt text for one document, up to 20,000 characters. Exclude payment-card data, credentials, customer-record payloads, and financial posting instructions."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"analysis"
],
"properties": {
"kind": {
"const": "structured",
"description": "Selects structured receipt input; supply the analysis property."
},
"analysis": {
"type": "object",
"properties": {
"tax": {
"oneOf": [
{
"type": "string",
"maxLength": 32,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 32,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Total tax amount printed on the receipt, in the receipt currency. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"total": {
"oneOf": [
{
"type": "string",
"maxLength": 32,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 32,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Final receipt total, in the receipt currency. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"vendor": {
"oneOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Merchant or supplier name printed on the receipt. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"currency": {
"oneOf": [
{
"type": "string",
"maxLength": 3,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 3,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Three-letter currency code shown on the receipt, for example USD. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"subtotal": {
"oneOf": [
{
"type": "string",
"maxLength": 32,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 32,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Receipt subtotal before tax, in the receipt currency. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"amount": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Extended amount printed for this line item, in the receipt currency. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"quantity": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Quantity purchased for this line item. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"unit_price": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Price per unit for this line item, in the receipt currency. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"description": {
"oneOf": [
{
"type": "string",
"maxLength": 240,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 240,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Item description printed on the receipt. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"product_code": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Product identifier or SKU printed for this line item. Supply the extracted value directly or wrap it with optional extraction confidence."
}
},
"minProperties": 1,
"additionalProperties": false
},
"maxItems": 100,
"description": "Extracted receipt line items, limited to 100 entries; omit unavailable item fields."
},
"purchase_date": {
"oneOf": [
{
"type": "string",
"maxLength": 10,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 10,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Purchase date as extracted; YYYY-MM-DD is recommended. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"purchase_order": {
"oneOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Purchase-order reference printed on the receipt; this does not select or link an Ardaro job. Supply the extracted value directly or wrap it with optional extraction confidence."
},
"receipt_reference": {
"oneOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "number"
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"oneOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "number"
}
],
"description": "The extracted field value, supplied as text or a number before receipt normalization."
},
"confidence": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Optional caller-supplied extraction confidence: 0 to 1 is a fraction; values greater than 1 are percentages up to 100. A value of 1 means full confidence."
}
},
"additionalProperties": false
}
],
"description": "Receipt, invoice, or transaction reference printed on the document. Supply the extracted value directly or wrap it with optional extraction confidence."
}
},
"description": "Provider-neutral receipt extraction using only the listed fields. Omit fields that were not extracted.",
"minProperties": 1,
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"description": "One receipt supplied as bounded OCR text or a provider-neutral structured extraction. Choose exactly one input kind."
},
"contract_version": {
"const": "ardaro.agent-receipt-intelligence.request.v1",
"description": "Required request contract identifier; send this exact version string."
},
"existing_fingerprints": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"maxItems": 10000,
"description": "Receipt fingerprints already known to the caller for duplicate comparison. Supply lowercase 64-character SHA-256 hex strings, or an empty array when none are available; at most 10,000 entries."
}
},
"additionalProperties": false
}Inspect a fixed synthetic request and expected result before integrating or paying. Select service from the enum; no caller document is accepted, processed or stored. Returns service and details containing that service's example. Free; no wallet authorization. Use get_document_service_status for current readiness, prices and retention instead.
| Argument | Type | Description |
|---|---|---|
| service* | string | receipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents. |
{
"type": "object",
"required": [
"service"
],
"properties": {
"service": {
"enum": [
"receipt",
"invoice",
"reconciliation"
],
"type": "string",
"description": "receipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents."
}
},
"additionalProperties": false
}Check the selected service's current runtime readiness, input limits, pricing and retention before use. Returns service and details; ready=false means the underlying service is unavailable. Free cached runtime read; no external probe, payment, analysis or historical document retrieval. Use get_document_example for a fixed integration sample instead.
| Argument | Type | Description |
|---|---|---|
| service* | string | receipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents. |
{
"type": "object",
"required": [
"service"
],
"properties": {
"service": {
"enum": [
"receipt",
"invoice",
"reconciliation"
],
"type": "string",
"description": "receipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents."
}
},
"additionalProperties": false
}USE THIS WHEN the question is a quantity-allocation question: how much of this PO has been invoiced, whether an invoice is fully, partially, or over billed against the PO, or how much quantity remains. Aggregates split invoice lines against one PO line and returns a status per line - fully_invoiced, partially_invoiced, uninvoiced, or overbilled - plus remaining quantity. Matches by explicit PO line ID or a unique exact product code only, never by description. Inputs: one invoice plus one PO; it does not accept a receipt. DO NOT USE THIS to compare a receipt against an invoice, or for a general list of differences with no allocation question - call reconcile_purchase_documents instead; it is free and does not require calling this tool first or after. Paid: 0.50 USDC per accepted comparison, explicit buyer-authorized x402 payment. Call get_document_service_status with service='invoice' first to confirm current readiness and price. Advisory output only: human review required; no delivery verification, payment execution, prior-invoice history, or accounting writes.
| Argument | Type | Description |
|---|---|---|
| invoice* | any | |
| purchase_order* | any | |
| contract_version* | any |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contract_version",
"invoice",
"purchase_order"
],
"properties": {
"invoice": {
"oneOf": [
{
"type": "object",
"required": [
"currency",
"line_items",
"purchase_order_reference",
"reference",
"supplier_id"
],
"properties": {
"tax": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})$",
"maxLength": 26
},
"total": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})$",
"maxLength": 26
},
"currency": {
"enum": [
"JPY"
],
"type": "string"
},
"subtotal": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})$",
"maxLength": 26
},
"reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"line_id",
"quantity",
"unit",
"unit_price"
],
"properties": {
"unit": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 32,
"minLength": 1
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})$",
"maxLength": 26
},
"line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"quantity": {
"not": {
"pattern": "\\n"
},
"type": "string",
"allOf": [
{
"not": {
"pattern": "^0(?:\\.0+)?$"
}
}
],
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"po_line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"unit_price": {
"not": {
"pattern": "\\n"
},
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"description": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"product_code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"supplier_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"purchase_order_reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"currency",
"line_items",
"purchase_order_reference",
"reference",
"supplier_id"
],
"properties": {
"tax": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?$",
"maxLength": 29
},
"total": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?$",
"maxLength": 29
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"MXN"
],
"type": "string"
},
"subtotal": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?$",
"maxLength": 29
},
"reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"line_id",
"quantity",
"unit",
"unit_price"
],
"properties": {
"unit": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 32,
"minLength": 1
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?$",
"maxLength": 29
},
"line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"quantity": {
"not": {
"pattern": "\\n"
},
"type": "string",
"allOf": [
{
"not": {
"pattern": "^0(?:\\.0+)?$"
}
}
],
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"po_line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"unit_price": {
"not": {
"pattern": "\\n"
},
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"description": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"product_code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"supplier_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"purchase_order_reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"purchase_order": {
"oneOf": [
{
"type": "object",
"required": [
"currency",
"line_items",
"reference",
"supplier_id"
],
"properties": {
"currency": {
"enum": [
"JPY"
],
"type": "string"
},
"reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"line_id",
"quantity",
"unit",
"unit_price"
],
"properties": {
"unit": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 32,
"minLength": 1
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})$",
"maxLength": 26
},
"line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"quantity": {
"not": {
"pattern": "\\n"
},
"type": "string",
"allOf": [
{
"not": {
"pattern": "^0(?:\\.0+)?$"
}
}
],
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"unit_price": {
"not": {
"pattern": "\\n"
},
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"description": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"product_code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"supplier_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"currency",
"line_items",
"reference",
"supplier_id"
],
"properties": {
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"MXN"
],
"type": "string"
},
"reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"line_id",
"quantity",
"unit",
"unit_price"
],
"properties": {
"unit": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 32,
"minLength": 1
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,2})?$",
"maxLength": 29
},
"line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"quantity": {
"not": {
"pattern": "\\n"
},
"type": "string",
"allOf": [
{
"not": {
"pattern": "^0(?:\\.0+)?$"
}
}
],
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"unit_price": {
"not": {
"pattern": "\\n"
},
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"description": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"product_code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"supplier_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"contract_version": {
"const": "ardaro.agent-invoice-matching.request.v1"
}
},
"description": "One invoice and one purchase order with caller-supplied opaque supplier identifiers. Runtime validation additionally rejects duplicate line IDs, padded/control-bearing strings, sensitive card or credential data, and requests over 262144 UTF-8 JSON bytes. All numeric inputs are decimal strings; missing optional arithmetic evidence requires review.",
"additionalProperties": false
}USE THIS WHEN you have up to three documents (receipt, invoice, purchase order - any subset) and need a discrepancy list: reference, item, quantity, price, or arithmetic mismatches between them. This is the default choice for 'does this receipt match the invoice' or 'do these documents agree' questions. Links use explicit line references, exact product codes, or conservative normalized descriptions. DO NOT USE THIS if the actual question is a quantity-allocation question - how much of a PO has been invoiced, or resolving partial/split invoice lines against PO quantities. This tool does not allocate billed quantities or calculate remaining PO quantities: partial quantities are reported as plain differences, and any many-to-one (split) link is flagged ambiguous_many_to_one rather than resolved. For that, call match_invoice instead (paid, 0.50 USDC) - but you never need to call it before or after this tool; each works standalone. Free, no wallet authorization, no payment metadata accepted. Missing documents or fields are marked needs_review, never inferred. No OCR, retrieval, saved analyses, paid service calls, delivery verification, payment approval, or accounting writes. Human review required.
| Argument | Type | Description |
|---|---|---|
| invoice | object | Caller-supplied structured data. Use opaque supplier IDs and decimal strings; omit unknown fields. Receipt kind describes the source document, not verified delivery. Field names align with invoice matching; receipt extraction output must be mapped explicitly. |
| receipt | object | Caller-supplied structured data. Use opaque supplier IDs and decimal strings; omit unknown fields. Receipt kind describes the source document, not verified delivery. Field names align with invoice matching; receipt extraction output must be mapped explicitly. |
| purchase_order |
| object |
| Caller-supplied structured data. Use opaque supplier IDs and decimal strings; omit unknown fields. Receipt kind describes the source document, not verified delivery. Field names align with invoice matching; receipt extraction output must be mapped explicitly. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [],
"properties": {
"invoice": {
"type": "object",
"required": [],
"properties": {
"tax": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"total": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"subtotal": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [],
"properties": {
"unit": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 32,
"minLength": 1
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"quantity": {
"not": {
"pattern": "\\n"
},
"type": "string",
"allOf": [
{
"not": {
"pattern": "^0(?:\\.0+)?$"
}
}
],
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"po_line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"unit_price": {
"not": {
"pattern": "\\n"
},
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"description": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"product_code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100
},
"supplier_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"purchase_order_reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"description": "Caller-supplied structured data. Use opaque supplier IDs and decimal strings; omit unknown fields. Receipt kind describes the source document, not verified delivery. Field names align with invoice matching; receipt extraction output must be mapped explicitly.",
"additionalProperties": false
},
"receipt": {
"type": "object",
"required": [],
"properties": {
"tax": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"kind": {
"enum": [
"expense_receipt",
"delivery_receipt"
]
},
"total": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"subtotal": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [],
"properties": {
"unit": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 32,
"minLength": 1
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"quantity": {
"not": {
"pattern": "\\n"
},
"type": "string",
"allOf": [
{
"not": {
"pattern": "^0(?:\\.0+)?$"
}
}
],
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"unit_price": {
"not": {
"pattern": "\\n"
},
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"description": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"product_code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"invoice_line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100
},
"supplier_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"invoice_reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"purchase_order_reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"description": "Caller-supplied structured data. Use opaque supplier IDs and decimal strings; omit unknown fields. Receipt kind describes the source document, not verified delivery. Field names align with invoice matching; receipt extraction output must be mapped explicitly.",
"additionalProperties": false
},
"purchase_order": {
"type": "object",
"required": [],
"properties": {
"tax": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"total": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"subtotal": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"reference": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [],
"properties": {
"unit": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 32,
"minLength": 1
},
"amount": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,6})?$",
"maxLength": 33
},
"line_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
},
"quantity": {
"not": {
"pattern": "\\n"
},
"type": "string",
"allOf": [
{
"not": {
"pattern": "^0(?:\\.0+)?$"
}
}
],
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"unit_price": {
"not": {
"pattern": "\\n"
},
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$",
"maxLength": 19
},
"description": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"product_code": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100
},
"supplier_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]*$",
"maxLength": 80,
"minLength": 1
}
},
"description": "Caller-supplied structured data. Use opaque supplier IDs and decimal strings; omit unknown fields. Receipt kind describes the source document, not verified delivery. Field names align with invoice matching; receipt extraction output must be mapped explicitly.",
"additionalProperties": false
}
},
"description": "Free comparison of one receipt, invoice and purchase order supplied in this request. Missing documents or fields produce needs_review. Maximum 100 lines per document and 196608 UTF-8 JSON bytes. No images, URLs, credentials, account access, or paid tool calls. Money amounts must use the supported currency's minor-unit precision; runtime also rejects sensitive data, padded strings and control characters.",
"additionalProperties": false
}