# tracepass-mcp-server

Connects AI assistants to TracePass to manage EU Digital Product Passports, audit battery regulations, and record GS1 EPCIS 2.0 supply chain events.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 7835 installs · ★ 1 repo stars
- Author: malinoto
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/malinoto/tracepass-mcp-server
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tracepass-mcp-server

## What it 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.

## Requirements
- Remote server: `https://tracepass-mcp-server--malinoto.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http tracepass-mcp-server https://tracepass-mcp-server--malinoto.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add tracepass-mcp-server --url https://tracepass-mcp-server--malinoto.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tracepass-mcp-server": {
            "url": "https://tracepass-mcp-server--malinoto.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tracepass-mcp-server": {
            "type": "http",
            "url": "https://tracepass-mcp-server--malinoto.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http tracepass-mcp-server https://tracepass-mcp-server--malinoto.run.tools
```

## When to use it
- 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
- 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`.

## Similar
- [nis2-directive-specialist](https://affpapa.org/en/nevibecode/skills/nis2-directive-specialist.md) — skill · 105 installs
- [logistics-expert](https://affpapa.org/en/nevibecode/skills/logistics-expert.md) — skill · 576 installs
- [skill-scanner](https://affpapa.org/en/nevibecode/skills/skill-scanner.md) — skill · 4200 installs
- [check-npm](https://affpapa.org/en/nevibecode/skills/check-npm.md) — skill · 3200 installs
- [owasp-security](https://affpapa.org/en/nevibecode/skills/agamm-owasp-security.md) — skill · 2800 installs
- [IBANforge](https://affpapa.org/en/nevibecode/mcp/ibanforge.md) — MCP server · 4179 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
