# Onboarding Goods Receipt Inspection Runs

> Onboarding Goods Receipt Inspection Runs is a freemium MCP server for procurement. Local MCP server for logging goods receipts against purchase orders, with tolerance checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, self-hosted
- **Website:** https://mcp.zovo.one/s/goods-receipt
- **Repository:** https://github.com/theluckystrike/mcp-servers/tree/HEAD/servers/goods-receipt
- **MCP Registry name:** io.github.theluckystrike/onboarding-goods-receipt-inspection-runs
- **Categories:** [procurement](https://ai-powered.com/categories/procurement)
- **Listing updated:** 2026-11-19

## About

The README says it manages purchase orders and the goods receipt notes that receive against them. Each PO holds a reference, a supplier and dated lines with SKU, description and whole-unit quantities, plus over and under tolerances in whole percent. Receipts record units received and damaged per line, and shortage is calculated on each request as ordered minus received rather than stored.

The over-tolerance check runs against the cumulative total across all receipts on a line, so several partial deliveries cannot slip past the limit one by one. A receipt that breaks tolerance is refused unless the excess is declared damaged, and damaged units still count toward the check. Data is kept in local JSON files on the machine running the server, and the README states there are no network calls.

It suits warehouse or stores staff, and small businesses that want receiving logic inside an AI assistant. Free use covers up to 2,000 POs and 5,000 GRNs; the Pro licence adds CSV export.

## Features

- **Cumulative tolerance checking:** Over-receipt is measured against the running total on each line, so partial deliveries cannot exceed the tolerance.
- **Derived shortage reporting:** Shortage is calculated from PO lines and recorded receipts each time, not stored as a separate figure.
- **Damage recording:** Damaged units are typed per line and counted toward the tolerance check.
- **Local data storage:** Purchase orders and receipts are saved as JSON files on the user's machine, per the README.
- **Optional CSV export:** Pro licence unlocks exporting the receipt ledger as CSV for spreadsheets or ERP import.

## Good for

- Logging partial deliveries against an open purchase order
- Flagging short or damaged lines before a three-way invoice match
- Checking that a supplier has not over-delivered beyond agreed tolerance
- Producing a status report of outstanding quantities per PO

## Install

### Claude Code (Terminal)

```sh
claude mcp add onboarding-goods-receipt-inspection-runs --env MCP_LICENSE_KEY='<MCP_LICENSE_KEY>' -- npx -y https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/goods-receipt.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "onboarding-goods-receipt-inspection-runs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/goods-receipt.mcpb"
      ],
      "env": {
        "MCP_LICENSE_KEY": "<MCP_LICENSE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "onboarding-goods-receipt-inspection-runs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/goods-receipt.mcpb"
      ],
      "env": {
        "MCP_LICENSE_KEY": "<MCP_LICENSE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "onboarding-goods-receipt-inspection-runs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/goods-receipt.mcpb"
      ],
      "env": {
        "MCP_LICENSE_KEY": "<MCP_LICENSE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "onboarding-goods-receipt-inspection-runs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/goods-receipt.mcpb"
      ],
      "env": {
        "MCP_LICENSE_KEY": "<MCP_LICENSE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "onboarding-goods-receipt-inspection-runs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/goods-receipt.mcpb"
      ],
      "env": {
        "MCP_LICENSE_KEY": "<MCP_LICENSE_KEY>"
      }
    }
  }
}
```

## Tools

- `po_add`: Create a purchase order with reference, supplier, dated lines and tolerances
- `grn_add`: Receive goods against an open PO with received and damaged quantities per line
- `grn_line_add`: Receive one more line onto an open GRN
- `grn_list`: List GRNs newest first, filtered by PO or status
- `grn_get`: Show one GRN with every line and its shortage
- `grn_discrepancy`: Report lines short, over, damaged or closed with outstanding amounts
- `grn_close`: Close a GRN once the count is settled
- `grn_status_report`: Report every PO with open lines and cumulative received quantities
- `grn_export_csv`: Export GRNs as CSV (Pro)
- `license_status`: Show the licence tier and key source for this install
- `license_activate`: Store a Pro licence key for this server

## FAQ

### Does it send data over the network?

The README says there is no network call anywhere in the server, no API key and no account, and data stays in local files.

### What happens when a delivery exceeds tolerance?

The receipt is refused and nothing is written, unless the extra units are declared damaged, in which case they still count toward the check.

### Which features need the Pro licence?

According to the README, grn_export_csv is the only Pro-gated tool; the free tier covers the other receiving and reporting tools.

### Is Onboarding Goods Receipt Inspection Runs free?

Onboarding Goods Receipt Inspection Runs has a free plan, with paid plans for more usage or features.

### How do I add Onboarding Goods Receipt Inspection Runs to Claude Code?

Run this command in your terminal: claude mcp add onboarding-goods-receipt-inspection-runs --env MCP_LICENSE_KEY='<MCP_LICENSE_KEY>' -- npx -y https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/goods-receipt.mcpb

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [MCP CPG Human in the Loop (HITL)](https://ai-powered.com/mcp/mcp-cpg-human-in-the-loop-hitl): MCP CPG Human in the Loop (HITL) is an MCP server for procurement.

---
Source: https://ai-powered.com/mcp/onboarding-goods-receipt-inspection-runs
