ODDWOOD Barcode Tool

io.github.oddwood-xv1.0.0Updated Oct 5, 2026

Paid MCP server for EAN, UPC, and GTIN validation, normalization, correction, and batch analysis.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Validates, normalizes, and batch-analyzes EAN, UPC, and GTIN barcodes through a paid remote MCP endpoint.

What it does
Exposes two tools: analyze_barcode, which recognizes the barcode type, checks the GTIN check digit, reports expected versus actual digits, suggests a corrected barcode, and normalizes to GTIN-14; and analyze_barcode_batch, which processes up to 100,000 barcodes per request with duplicate detection, optional deduplication, error and type statistics, and full, errors-only, or summary output. Leading zeros are preserved, and spaces or hyphens can be stripped during normalization with a warning.
When to use it
Useful when an assistant must check or clean large sets of product codes without spending model reasoning on checksum arithmetic, for example validating a catalog export, deduplicating a barcode list, or correcting invalid check digits before import.
Requirements
A remote streamable HTTP MCP endpoint; no local runtime or package is needed for the hosted service. Each tool call is paid in USDC on Base through the x402 payment protocol, so an x402-compatible client and a funded wallet are required. The README also documents a local Node.js 24+ and npm setup for running the server yourself.
Before you install
This is a paid service: analyze_barcode costs $0.001 USDC and analyze_barcode_batch $0.003 USDC per call, settled automatically by an x402 client, so spending depends on call volume. The README states the service processes barcode values and needs no personal information, and warns not to submit secrets, credentials, private keys, or access tokens as barcode input.

Installation

In SourceWeft

  1. Open ODDWOOD Barcode Tool in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "barcode-tool": {
      "type": "http",
      "url": "https://barcode-tool.fly.dev/mcp"
    }
  }
}

README

ODDWOOD Barcode Tool

A paid MCP tool for deterministic barcode validation, normalization, and batch analysis.

Built for AI agents and automated workflows that need reliable EAN, UPC, and GTIN processing without spending model reasoning on checksum calculations or large barcode datasets.

Public MCP Endpoint

text
https://barcode-tool.fly.dev/mcp

Transport: Streamable HTTP MCP
Payment: x402
Network: Base
Currency: USDC

Supported Barcode Types

  • EAN-8
  • UPC-A
  • EAN-13
  • GTIN-14

Leading zeros are preserved.

Spaces and hyphens can be safely removed during normalization, with a warning returned in the result.

Tools

analyze_barcode

Validates and analyzes a single barcode.

Price: $0.001 USDC per call

Capabilities:

  • Barcode type recognition
  • GTIN check digit validation
  • Expected vs. actual check digit reporting
  • Corrected barcode suggestion for invalid check digits
  • Detection of unambiguous missing check digits
  • GTIN-14 normalization
  • Safe formatting cleanup
  • Structured errors and warnings

Example input:

json
{  "barcode": "036000291452"}

Example result:

json
{  "input": "036000291452",  "cleanedInput": "036000291452",  "type": "UPC-A",  "valid": true,  "error": null,  "warnings": [],  "actualCheckDigit": 2,  "expectedCheckDigit": 2,  "correctedBarcode": null,  "gtin14": "00036000291452"}

analyze_barcode_batch

Validates and analyzes up to 100,000 barcodes in one request.

Price: $0.003 USDC per call

Capabilities:

  • Batch validation
  • Duplicate detection
  • Optional deduplication
  • Error statistics
  • Barcode type statistics
  • Internal chunk processing
  • Configurable result limits
  • Selective result filtering

Output modes:

  • full
  • errors_only
  • summary

Results can be filtered by:

  • Validity
  • Barcode type
  • Validation error type

Supported validation error types:

  • invalid_check_digit
  • missing_check_digit
  • invalid_length
  • invalid_characters
  • empty_input
  • other

The maximum batch size is 100,000 barcodes.

The default detailed result limit is 10,000 records, with a hard maximum of 50,000 detailed results.

x402 Payments

Tool calls use the x402 payment protocol.

Payments use USDC on Base.

ToolPrice
analyze_barcode$0.001 USDC
analyze_barcode_batch$0.003 USDC

Payment is handled automatically by x402-compatible clients.

Health Endpoint

text
https://barcode-tool.fly.dev/health

The health endpoint reports service status, configured network, payment receiver, and current tool prices.

Privacy

The service is designed to process barcode values and does not require personal information.

Do not submit secrets, credentials, private keys, access tokens, or other sensitive information as barcode input.

Development

Requirements:

  • Node.js 24+
  • npm

Install dependencies:

bash
npm install

Run the local stdio MCP server:

bash
node server.js

Run the free local HTTP MCP server:

bash
node remote-server.js

Run the x402-enabled server:

bash
node paid-server.js

Run tests:

bash
node test.jsnode filter-test.jsnode stress-test.js

License

ISC

Developer

ODDWOOD

Source: README.md at commit 5c47f71

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 5, 2026