tracepass-mcp-server — Claude Code MCP server: audit battery passports
Connects AI assistants to TracePass to manage EU Digital Product Passports, audit battery regulations, and record GS1 EPCIS 2.0 supply chain events.
MIT 7,835 installs ★ 1 updated 2026-10-23
claude mcp add --transport http tracepass-mcp-server https://tracepass-mcp-server--malinoto.run.toolsWhat tracepass-mcp-server does
This MCP server exposes tools to manage the TracePass product registry, verify compliance under the ESPR and EU Battery Regulation, and handle category-specific schemas. Assistants can create items, update economic operators such as importers, and retrieve QR codes directly from the workspace.
Supply chain traceability relies on GS1 EPCIS 2.0 event queries and ingestion. For battery passports, the tool handles regulatory condition flags like hasBMS or rechargeable. These flags determine whether additional fields become legally mandatory before market entry.
Running locally via npx requires setting the TRACEPASS_API_KEY environment variable. The local subprocess cannot handle interactive browser authorization, making OAuth strictly a hosted endpoint feature. Lookups by serial number fail with a 409 status if identical serials span multiple GTIN values without an explicit gtin argument.
What it helps with
- Audit battery passports for EU regulatory readiness before placing them on the market
- Log and export supply chain movements using GS1 EPCIS 2.0
- Assign economic operators like manufacturers and importers to product passports
- Set conditional compliance flags that dictate mandatory product fields
Example prompts for the agent
- Check the EU compliance status for battery passport with serial SN-88412 under GTIN 04012345678901.
- Assign the importer party details to product passport
pass_1049. - Export all GS1 EPCIS supply chain events recorded for component
BAT-9921.
How to install tracepass-mcp-server
Platform CLI: remote server
claude mcp add --transport http tracepass-mcp-server https://tracepass-mcp-server--malinoto.run.toolsPlatform CLI: remote server
codex mcp add tracepass-mcp-server --url https://tracepass-mcp-server--malinoto.run.toolsConfig file
{
"mcpServers": {
"tracepass-mcp-server": {
"url": "https://tracepass-mcp-server--malinoto.run.tools"
}
}
}Config file
{
"servers": {
"tracepass-mcp-server": {
"type": "http",
"url": "https://tracepass-mcp-server--malinoto.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http tracepass-mcp-server https://tracepass-mcp-server--malinoto.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about tracepass-mcp-server
How to install tracepass-mcp-server in Claude Code?
Run claude mcp add --transport http tracepass-mcp-server https://tracepass-mcp-server--malinoto.run.tools.
What does tracepass-mcp-server do?
It links coding assistants to TracePass to create and check Digital Product Passports, inspect legal schemas, and handle GS1 EPCIS supply chain telemetry.
Why does a query by serial number return a 409 error?
Serial numbers are unique only within a given GTIN. If an identical serial appears under two GTINs, the API returns ambiguous_serial unless the gtin parameter is passed.