HimiTrace

What is HimiTrace?

HimiTrace is a Model Context Protocol (MCP) server that connects AI agents to the Polygon Mainnet blockchain to check product authenticity, verify origins, and inspect supply chain event lineages. Developed by HimiTek, it bridges immutable on-chain trust data with natural language queries for AI agents.

How to use HimiTrace?

Install Node.js 20+ and npm, clone the repository, run npm install and npm run build, then test the connection with npm run test:local. Configure your MCP-compatible client (Claude Desktop, Cursor, Windsurf) by adding a command entry pointing to the compiled dist/index.js file. The server exposes tools that AI agents can call in plain language.

Key features of HimiTrace

• On-chain product and batch ID verification (tamper-proof on Polygon)
• Full supply chain event timeline (GS1 EPCIS compatible)
• Certificate verification with IPFS-stored documents
• Bill of Materials (BOM) lineage with merge/split relations
• Zero gas cost for all read operations

Use cases of HimiTrace

• Verify the authenticity of a physical product by its batch ID
• Trace the complete supply chain history of an item from origin to delivery
• Retrieve quality certificates (e.g., USDA Organic, Fair Trade) for a product
• Audit the bill of materials to see raw material splits and merges

FAQ from HimiTrace

What blockchain network does HimiTrace use?

HimiTrace operates on Polygon Mainnet (Chain ID 137) and reads from the smart contract at address 0xFF7A3429427aFda56b2994B2F3eeF4464b851EE0.

Do I need cryptocurrency (POL) to use HimiTrace?

No. All read operations from the smart contract are gas-free and do not require any tokens to be spent by the AI agent.

How do I connect HimiTrace to Claude Desktop?

Add a himitrace-mcp entry to the mcpServers object in your Claude Desktop configuration file (claude_desktop_config.json) with the command node and the absolute path to dist/index.js.

What tools are available in HimiTrace?

The server provides six tools: verify_product, get_trace_history, get_certificates, get_batch_lineage, check_product_exists, and get_system_stats. Each accepts a product or batch ID and returns structured JSON results.

What are the runtime dependencies for HimiTrace?

HimiTrace requires Node.js v20 or higher and npm. The project is built with TypeScript and the ethers.js v6 library.