TradeCheck MCP server
Commit Nov 15, 2026Compares purchase orders, supplier invoices, and history to identify discrepancies and draft supplier clarifications.
Also known as f-tiger/agi-site, tradecheck
- Stars
- 0
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Nov 15, 2026
- License
- —
What is TradeCheck MCP?
TradeCheck compares purchase orders, supplier invoices, and history to identify discrepancies and draft supplier clarifications. It exposes 4 tools, such as tradecheck_import_tables, tradecheck_example, tradecheck_reconcile.
Summary generated from the project's README
About TradeCheck MCP server
Purchasing teams and importers can use this local tool to reconcile purchase orders against supplier invoices and historical data. It functions as a deterministic review engine that identifies discrepancies in unit prices, cumulative quantities, and arithmetic totals. By running locally via stdio, it connects to desktop assistants like Claude Code or Cursor to provide structured data analysis without making network requests or storing documents.
The system uses specific tools such as tradecheck_import_tables for processing CSV or TSV text and tradecheck_reconcile to generate findings. It can also produce an unsent supplier clarification using tradecheck_supplier_draft. Users must provide the data, as the server does not perform OCR or integrate directly with ERP systems. It supports various currencies including USD, EUR, and JPY, but does not handle foreign exchange conversions or tax validation.
What you can do with it
- 1Identify price and quantity discrepanciesAsk the assistant to find differences between a purchase order and a supplier invoice regarding unit prices or total quantities.
- 2Draft supplier communicationsGenerate a professional, unsent draft to send to a supplier explaining specific gaps or exceptions found during the review.
- 3Import structured spreadsheet dataProvide CSV or tab-separated text from spreadsheets to be converted into unreviewed structured data for reconciliation.
Written from the project's README. Every use case is checked against a quote from it.
TradeCheck MCP tools 4
Detected from the READMEtradecheck_import_tablestradecheck_exampletradecheck_reconciletradecheck_supplier_draft
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablef-tiger/agi-site is public and reachablegithub.com/f-tiger/agi-site ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-14github.com/f-tiger/agi-site ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubTradeCheck MCP · 0.2.0 beta
A local tool for importer and purchasing-team invoice review. It compares one purchase order, one supplier invoice and supplied prior invoice history, then prepares an unsent supplier clarification. It is a deterministic review engine exposed through MCP plus a guided agent prompt. It is not a hosted model, OCR service, ERP integration or autonomous payment agent.
Try the browser workbench: https://rfqdesk.agiscorecard.com/agent
Start here
- Install Node.js 22 or newer. Download and extract the beta archive from the site.
- Open a terminal in the extracted
tradecheck-mcpdirectory. Install the pinned dependencies and test the bundled build:
npm ci --ignore-scripts --no-audit --no-fund
npm test
npm run demo
The demo connects a real MCP client over stdio, loads a fictional order and finds a signed price difference of EUR 44.00 and a cumulative quantity of 320 against 300 ordered. These are fictional discrepancies, not recovered money.
- Register the server with your MCP-compatible desktop assistant. For Claude Code, substitute your actual absolute path:
claude mcp add tradecheck -- node /absolute/path/tradecheck-mcp/dist/server.js
Run /mcp in Claude Code and check that four TradeCheck tools appear. For Cursor, add this entry to its MCP configuration:
{"mcpServers":{"tradecheck":{"command":"node","args":["/absolute/path/tradecheck-mcp/dist/server.js"]}}}
On Windows use an absolute path such as C:/Users/you/tradecheck-mcp/dist/server.js. If node is not found by your desktop app, use its absolute executable path. The server is local stdio, not a remote URL.
- Ask the assistant: “Use TradeCheck's review_supplier_invoice prompt. First show the fictional example. Then help me prepare my PO and invoice, confirm the extracted fields with me, and produce a two-way review plus an unsent supplier clarification.”
If your host does not surface prompts, paste AGENT-WORKFLOW.md. Its ability to read PDF or image attachments depends on that host; this package does not perform OCR. No model evaluation of extraction quality has been completed. A real SDK client round trip is tested; the listed desktop hosts have not each been tested in this release.
Available tools
| Tool | Input | Output |
|---|---|---|
tradecheck_import_tables |
PO/invoice header metadata, CSV/TSV text and explicit zero-based column mappings | Unreviewed structured data, unknown prior history |
tradecheck_example |
{} |
Stable fictional input and contract |
tradecheck_reconcile |
{data, offset?:0, limit?:20} |
Summary, a page of findings, total finding count, next offset |
tradecheck_supplier_draft |
{data, language?:"en"} |
Unsent subject/body with up to 20 exception/gap items |
Read tradecheck://contract for scope. Use the example JSON instead of inventing fields. Decimal numbers must be strings. Unknown required amounts must be resolved; blank is not zero. Keep history_status:"unknown" when earlier invoices may be missing. Set extraction_reviewed:true only after a person reviews the fields against the original documents.
What is checked
Exact PO/supplier identifiers, currency consistency, explicit PO line mapping, SKU and unit, unit-price changes, cumulative supplied quantities, repeated supplied IDs, line/subtotal/header arithmetic. Legitimate partial billing is informational. All calculations use integer decimal scales and half-up rounding per line. Monetary totals use two decimals, or whole yen for JPY. Quantity supports three decimals and unit price four.
Supported currencies: USD, EUR, GBP, CAD, AUD, CNY, SGD, CHF, JPY. No FX or unit conversion. A matching SKU is not enough to infer a PO line. The input supports at most 100 PO/current lines, 20 earlier invoices and 1,000 earlier lines. Reports paginate at 25 findings maximum; each finding includes up to six source locators and an explicit refs_omitted count. The browser/full JSON report retains all supplied references.
Limits that affect the result
- Two-way matching cannot verify delivery, receipt, quality, contract acceptance, customs, sanctions, bank details or payment eligibility.
- Source references and completeness are caller assertions. They are not cryptographic evidence or independent document verification.
- No negative values, credit notes, deposits, discounts, tax validation or alternate rounding conventions. Such documents require a different workflow.
- Price variance is a signed total across comparable matched lines, not an overpayment, saving or recovered amount.
- An empty exception list means only no exceptions in the supported supplied data.
payment_authorizedis always false. - Chinese drafts use a Chinese introduction and preserve English diagnostic lines; the assistant may translate them while preserving values and references.
Privacy and operation
The MCP makes no network requests, reads no document paths, stores no documents and has no telemetry. It only processes values the caller supplies. Your AI assistant may send attachments and tool data to its model provider; its fees and data terms still apply. The public browser demo runs locally. Optional site events contain no document data.
No paid service is enabled. The proposed €29/month team workspace is research only; saved histories, supplier mapping and batch management are not available. Beta use is governed by LICENSE.txt; dependency licenses are in THIRD-PARTY-NOTICES.txt.
Development and verification
npm run build
npm test
npm run demo
npm run package
The package command stages an explicit allowlist, including the tested build, fixtures, documentation, sources and pinned dependencies manifest. It excludes repository contents, credentials, node_modules and buyer documents. Verify the download against SHA256SUMS.
The protocol and decimal contract tests are not a measurement of LLM, OCR or commercial accuracy. See EVALUATION.md for independent read-only protocol scenarios when included.
Spreadsheet input in v0.2
Paste CSV or tab-separated cells including headers. The browser previews five rows and all mappings; up to 100 data rows are imported. Columns must be explicitly mapped with no reuse. Filenames and physical row locators are preserved. Every header amount, currency, supplier and order ID is required. Localized decimals and numeric formulas are rejected; unknown charges are never zero-filled. Prior history begins unknown and extraction_reviewed begins false. Confirm against original documents before reconciliation. The MCP accepts the same text and zero-based mappings through tradecheck_import_tables.
Release archives use a fixed timestamp and explicit source allowlist. Bump the package/download version when release contents change. The audit report schema remains version 0.1.0; package version 0.2.0 adds input preparation without changing report semantics.
TradeCheck MCP questions
What tools does TradeCheck MCP provide?
It exposes 4 tools, including tradecheck_import_tables, tradecheck_example, tradecheck_reconcile, tradecheck_supplier_draft.
Does this tool perform OCR?
No, the package does not perform OCR; its ability to read PDF or image attachments depends on the host AI assistant.
Is my data sent to a remote server?
No, the MCP server is local, makes no network requests, stores no documents, and has no telemetry.
Can it handle currency conversion?
No, while it supports various currencies like USD, EUR, and GBP, it does not perform FX or unit conversion.
What kind of discrepancies does it find?
It checks for unit-price changes, cumulative quantity mismatches, currency consistency, and arithmetic errors in line items and subtotals.