TracePass

malinoto/tracepass-mcp-server

Connects Claude to the TracePass platform for managing EU Digital Product Passports and GS1 EPCIS 2.0 supply chain events. Exposes five tools covering products, passports, parties, and EPCIS operations. The passports tool handles creation (billable), suspension, archiving (irreversible), and QR code generation. EPCIS actions let you capture events, run queries, and export data. Ships as both a hosted endpoint at ai.tracepass.eu/mcp and a local npx package. Includes prompt templates for workflows like passport audits and product onboarding. Requires a TracePass API key from the developer dashboard. Useful if you're building or maintaining product traceability systems that need to comply with EU digital passport regulations.

GitHub stars: 1
tools: 8
auth: Secret needed
transport: STDIO, HTTP
last updated: Nov 9, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://ai.tracepass.eu/mcp --name tracepass --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http tracepass https://ai.tracepass.eu/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 8 tools

Verified live against the running server on Nov 6, 2026.

tracepass_productsManage the TracePass product catalogue. A product is the catalogue layer — one product can have many passports (one per serialised unit). Products are not billable on their own. Actions (pass via `action`, with `args`): - list — args: { page?, limit? (≤100), category?, status?...2 params

Manage the TracePass product catalogue. A product is the catalogue layer — one product can have many passports (one per serialised unit). Products are not billable on their own. Actions (pass via `action`, with `args`): - list — args: { page?, limit? (≤100), category?, status?...

Parameters* required

action*string

Which product operation to run: list | get | create | create_batch | update. (archive is in tracepass_passport_lifecycle.)one of list · get · create · create_batch · update

argsobject

Arguments for the chosen action; required fields depend on `action` (see each action above).

tracepass_passportsManage Digital Product Passports — create, read, and run compliance checks. IMPORTANT: `create` makes a DRAFT passport. A draft takes no plan DPP slot and is never billed; the slot, and any per-DPP overage past the plan cap, is taken when the passport is published, which happe...2 params

Manage Digital Product Passports — create, read, and run compliance checks. IMPORTANT: `create` makes a DRAFT passport. A draft takes no plan DPP slot and is never billed; the slot, and any per-DPP overage past the plan cap, is taken when the passport is published, which happe...

Parameters* required

action*string

argsobject

Arguments for the chosen action; required fields depend on `action` (see each action above).

tracepass_passport_fieldsUpdate field values on a Digital Product Passport. Every change is recorded in the passport's audit trail with the credential that made it (API key or connected app) and this MCP channel. `source` (optional) says where the value came from. Omit it, or pass "manual", when the u...2 params

Update field values on a Digital Product Passport. Every change is recorded in the passport's audit trail with the credential that made it (API key or connected app) and this MCP channel. `source` (optional) says where the value came from. Omit it, or pass "manual", when the u...

Parameters* required

action*string

Update one passport field, addressed by passport id (update) or by your serial (update_by_serial).one of update · update_by_serial

argsobject

Arguments for the chosen action; required fields depend on `action`.

tracepass_passport_partiesManage the economic-operator parties on a passport — manufacturer, importer, authorisedRepresentative, distributor, recycler, producerResponsibilityOrg. Each party carries a legal name and at least one identifier. Identifier rules (EN 18219 §6.2–6.5): a party needs at least on...2 params

Manage the economic-operator parties on a passport — manufacturer, importer, authorisedRepresentative, distributor, recycler, producerResponsibilityOrg. Each party carries a legal name and at least one identifier. Identifier rules (EN 18219 §6.2–6.5): a party needs at least on...

Parameters* required

action*string

Set (add/replace) or remove an economic-operator party on a passport by its role.one of set · remove

argsobject

Arguments for the chosen action; required fields depend on `action`.

tracepass_epcisGS1 EPCIS 2.0 supply-chain events. `export`, `capture`, `capture_job` and `query` are on every plan, Free included. Captured events count against the plan's event allowance (10 a month on Free); over it, `capture` returns an overage or hard-block message. Actions (pass via `ac...2 params

GS1 EPCIS 2.0 supply-chain events. `export`, `capture`, `capture_job` and `query` are on every plan, Free included. Captured events count against the plan's event allowance (10 a month on Free); over it, `capture` returns an overage or hard-block message. Actions (pass via `ac...

Parameters* required

action*string

EPCIS 2.0: export a passport's events (export | export_by_serial), capture new events, poll a capture job, or query events.one of export · export_by_serial · capture · capture_job · query

argsobject

Arguments for the chosen action; required fields depend on `action`.

tracepass_templatesDiscover the regulatory field schema for each DPP category — what a COMPLIANT passport must contain, per the governing EU regulation. Read-only reference data. Use this to advise on requirements before creating products/passports, and to gap-check a draft against the rules. Ac...2 params

Discover the regulatory field schema for each DPP category — what a COMPLIANT passport must contain, per the governing EU regulation. Read-only reference data. Use this to advise on requirements before creating products/passports, and to gap-check a draft against the rules. Ac...

Parameters* required

action*string

List all DPP category templates, or get one template by category.one of list · get

argsobject

Arguments for the chosen action; `category` is required for get, ignored for list.

tracepass_scopeCheck what EU law says for a product type matching the facts given: whether it needs a Digital Product Passport, from when, at which level, under which act and article, and the duties of each role. Also read the company's catalogue-wide scope report and trigger a catalogue ref...2 params

Check what EU law says for a product type matching the facts given: whether it needs a Digital Product Passport, from when, at which level, under which act and article, and the duties of each role. Also read the company's catalogue-wide scope report and trigger a catalogue ref...

Parameters* required

action*string

Which scope operation to run: check | catalogue_report | catalogue_run | catalogue_run_status.one of check · catalogue_report · catalogue_run · catalogue_run_status

argsobject

Arguments for the chosen action; required fields depend on `action` (see above).

tracepass_passport_lifecycleWARNING: Every action here changes what the public sees or is a legal act, some irreversible. `archive` permanently removes the public QR code (it 404s forever). `place_on_market` registers the passport in the EU DPP Registry — a legal act for the economic operator. The assist...2 params

WARNING: Every action here changes what the public sees or is a legal act, some irreversible. `archive` permanently removes the public QR code (it 404s forever). `place_on_market` registers the passport in the EU DPP Registry — a legal act for the economic operator. The assist...

Parameters* required

action*string

Which lifecycle action to run. All require user confirmation. place_on_market (battery, published; legal EU registry entry) | suspend (reversible) | suspend_by_serial | archive (IRREVERSIBLE; QR 40...one of place_on_market · suspend · suspend_by_serial · archive · archive_by_serial · archive_product

argsobject

Arguments for the chosen action; required fields depend on `action` (see each action above).

Readme

TracePass MCP Server

A Model Context Protocol server for TracePass — the EU Digital Product Passport platform. It lets AI assistants (Claude, Cursor, IDE agents) manage products, Digital Product Passports, economic-operator parties, and GS1 EPCIS 2.0 supply-chain events.

It speaks the full MCP protocol — tools, resources, resource templates, and prompts.

Two ways to use it

The same server core ships two ways:

Hosted — point your MCP client at https://ai.tracepass.eu/mcp. Nothing to install; always current.
Local (npm) — run tracepass-mcp-server via npx. The MCP client launches it as a subprocess and speaks MCP over stdio.

Authentication

View the full README on GitHub

Details

Repository: github.com/malinoto/tracepass-mcp-server
Website: www.tracepass.eu
Package: tracepass-mcp-server
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Resources: 2
Prompts: 5
Tools verified: Nov 6, 2026

TracePass

Install

Tools

Readme

TracePass MCP Server

Two ways to use it

Authentication

Details

More from malinoto