Goods receipt notes vs purchase orders: tolerances, damaged/short units, CSV export.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <Pro license key or anonymous token from GET https://mcp.zovo.one/mcp/token>
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.
Create a goods-receipt note (GRN) against an open purchase order. Give one cell per PO line: the whole units received and/or damaged. received is checked against the line's ordered quantity and the PO's over tolerance; receiving past the over tolerance is refused unless declared damaged. Shortage is recorded automatically (ordered minus received, floored at zero) and shown as a discrepancy. Partial deliveries are fine: raise several GRNs against the same PO. Free tier, full CRUD.
Purchase-order id or reference, e.g. PO-0001
Which PO lines you are receiving now
Memo for the whole GRN
Delivered by
ISO date of physical receipt (default today)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Create a goods-receipt note (GRN) against an open purchase order. Give one cell per PO line: the whole units received and/or damaged. received is checked against the line's ordered quantity and the PO's over tolerance; receiving past the over tolerance is refused unless declared damaged. Shortage is recorded automatically (ordered minus received, floored at zero) and shown as a discrepancy. Partial deliveries are fine: raise several GRNs against the same PO. Free tier, full CRUD.
| Argument | Type | Description |
|---|---|---|
| po* | string | Purchase-order id or reference, e.g. PO-0001 |
| note | string | Memo for the whole GRN |
| lines* | array | Which PO lines you are receiving now |
| carrier | string | Delivered by |
| receivedAt | string | ISO date of physical receipt (default today) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"po",
"lines"
],
"properties": {
"po": {
"type": "string",
"maxLength": 40,
"description": "Purchase-order id or reference, e.g. PO-0001"
},
"note": {
"type": "string",
"maxLength": 400,
"description": "Memo for the whole GRN"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"line",
"received"
],
"properties": {
"line": {
"type": "string",
"maxLength": 40,
"description": "PO line to receive, e.g. L01"
},
"damaged": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Whole units received but damaged"
},
"received": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Whole units of good stock"
},
"shortage": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Whole units short; when you know the count"
},
"damageNote": {
"type": "string",
"maxLength": 400,
"description": "What was damaged"
},
"shortageNote": {
"type": "string",
"maxLength": 400,
"description": "Why it is short"
}
},
"additionalProperties": false
},
"maxItems": 200,
"minItems": 1,
"description": "Which PO lines you are receiving now"
},
"carrier": {
"type": "string",
"maxLength": 60,
"description": "Delivered by"
},
"receivedAt": {
"type": "string",
"maxLength": 10,
"description": "ISO date of physical receipt (default today)"
}
},
"additionalProperties": false
}Close an open GRN. A closed GRN can no longer take lines, and its discrepancies are treated as resolved. Closing is free-tier and never mutates the PO.
| Argument | Type | Description |
|---|---|---|
| grn* | string | Open GRN id, e.g. GRN-0001 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grn"
],
"properties": {
"grn": {
"type": "string",
"maxLength": 40,
"description": "Open GRN id, e.g. GRN-0001"
}
},
"additionalProperties": false
}List lines that are not as ordered: damaged units, a declared shortage, or received below the PO line's under tolerance. Optionally filter to one PO.
| Argument | Type | Description |
|---|---|---|
| po | string | Only discrepancies on this purchase order |
| includeResolved | boolean | Include GRNs that are closed (resolved) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"po": {
"type": "string",
"maxLength": 40,
"description": "Only discrepancies on this purchase order"
},
"includeResolved": {
"type": "boolean",
"default": false,
"description": "Include GRNs that are closed (resolved)"
}
},
"additionalProperties": false
}Pro. Export every GRN (or just one PO's GRNs) as CSV with a header row: grn,po,po_reference,received_at,carrier,status,line,sku,received,damaged,shortage,damage_note,shortage_note. Watermark-free and not truncated.
| Argument | Type | Description |
|---|---|---|
| po | string | Export GRNs for one purchase order only |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"po": {
"type": "string",
"maxLength": 40,
"description": "Export GRNs for one purchase order only"
}
},
"additionalProperties": false
}Get a single goods-receipt note by id, with its lines, damage and shortage per line.
| Argument | Type | Description |
|---|---|---|
| grn* | string | GRN id, e.g. GRN-0001 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grn"
],
"properties": {
"grn": {
"type": "string",
"maxLength": 40,
"description": "GRN id, e.g. GRN-0001"
}
},
"additionalProperties": false
}Add another PO line (or more units on a line already open on this GRN) to an existing open goods-receipt note. Useful when one delivery arrives in batches. The over-tolerance gate still applies to the PO line's cumulative received count across every GRN. Free tier, full CRUD.
| Argument | Type | Description |
|---|---|---|
| grn* | string | Open GRN id, e.g. GRN-0001 |
| line* | string | PO line to receive, e.g. L01 |
| damaged | integer | Whole units received but damaged |
| received* | integer | Whole units of good stock |
| damageNote | string | What was damaged |
| shortageNote | string | Why it is short |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grn",
"line",
"received"
],
"properties": {
"grn": {
"type": "string",
"maxLength": 40,
"description": "Open GRN id, e.g. GRN-0001"
},
"line": {
"type": "string",
"maxLength": 40,
"description": "PO line to receive, e.g. L01"
},
"damaged": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Whole units received but damaged"
},
"received": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Whole units of good stock"
},
"damageNote": {
"type": "string",
"maxLength": 400,
"description": "What was damaged"
},
"shortageNote": {
"type": "string",
"maxLength": 400,
"description": "Why it is short"
}
},
"additionalProperties": false
}List goods-receipt notes, newest first, optionally filtered to one purchase order.
| Argument | Type | Description |
|---|---|---|
| po | string | Only GRNs against this purchase order |
| includeLines | boolean | Include line detail |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"po": {
"type": "string",
"maxLength": 40,
"description": "Only GRNs against this purchase order"
},
"includeLines": {
"type": "boolean",
"default": false,
"description": "Include line detail"
}
},
"additionalProperties": false
}Reconcile every purchase order against every GRN: open POs (not yet fully received), POs fully received within tolerance, POs with at least one discrepancy, and per-line open/short/damaged counts. Nothing is written.
| Argument | Type | Description |
|---|---|---|
| includeOnlyDiscrepancies | boolean | Only list POs with at least one discrepancy |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"includeOnlyDiscrepancies": {
"type": "boolean",
"default": false,
"description": "Only list POs with at least one discrepancy"
}
},
"additionalProperties": false
}Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
| Argument | Type | Description |
|---|---|---|
| key* | string | License key from checkout, MCPL1.<payload>.<signature> |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "License key from checkout, MCPL1.<payload>.<signature>"
}
},
"additionalProperties": false
}Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Create a purchase order to receive goods against. Lines carry a sku, a description and an ordered whole-unit quantity. Over/under tolerances are whole percentages allowed above/below ordered before a GRN is flagged. Ids look like PO-0001. Free tier, full CRUD.
| Argument | Type | Description |
|---|---|---|
| lines* | array | Lines on this purchase order |
| supplier* | string | Who you ordered from |
| reference* | string | Your own purchase-order number |
| overTolerancePct | integer | Whole % extra allowed above ordered (default 10) |
| underTolerancePct | integer | Whole % short allowed below ordered (default 10) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference",
"supplier",
"lines"
],
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"sku",
"description",
"ordered"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 40,
"description": "Stock-keeping unit / model code"
},
"ordered": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "Whole units ordered"
},
"description": {
"type": "string",
"maxLength": 160,
"description": "What it is"
}
},
"additionalProperties": false
},
"maxItems": 200,
"minItems": 1,
"description": "Lines on this purchase order"
},
"supplier": {
"type": "string",
"maxLength": 60,
"description": "Who you ordered from"
},
"reference": {
"type": "string",
"maxLength": 60,
"description": "Your own purchase-order number"
},
"overTolerancePct": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 0,
"description": "Whole % extra allowed above ordered (default 10)"
},
"underTolerancePct": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 0,
"description": "Whole % short allowed below ordered (default 10)"
}
},
"additionalProperties": false
}