TracePass
Server Details
Manage products, EU Digital Product Passports, operator parties, and GS1 EPCIS supply-chain events.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- malinoto/tracepass-mcp-server
- GitHub Stars
- 1
- Server Listing
- tracepass-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 9 tools
The nine tools are split by resource and each description explicitly cross-references where overlapping operations live (e.g. passport creation/reads vs. lifecycle vs. field updates vs. parties), so an agent can route most calls confidently. Residual ambiguity exists inside `tracepass_passports`, which bundles compliance, QR, snapshots, condition flags and measurements, and between `tracepass_passport_fields` update and `capture_measurements` (both write values onto a passport).
All tools follow a uniform `tracepass_<entity>` snake_case prefix, and actions are consistently dispatched via an `action` argument rather than baked into the tool name. Minor friction comes from mixing plural parent resources (`tracepass_passports`, `tracepass_products`) with singular sub-resource prefixes (`tracepass_passport_fields`, `tracepass_passport_lifecycle`, `tracepass_passport_parties`).
Nine tools is a sensible, well-scoped count for a DPP platform and each grouping maps to a coherent domain area. The trade-off is that individual tools are very heavy (tracepass_passports exposes roughly 18 actions, several with `_by_serial` variants), which pushes a lot of routing burden into the `action` parameter.
Coverage is broad: product catalogue CRUD plus batch/archive, passport create/read/compliance/QR/snapshots/flags/measurements, life cycle transitions, parties, access grants, EPCIS, scope and templates. The notable gap is publishing a passport, which is dashboard-only, so an agent can create a draft but cannot make it public end to end; passport 'delete' is likewise replaced by destructive archive.
Available Tools
9 toolstracepass_access_grantsTracePass access grantsADestructiveInspect
Share restricted passport data with a partner (repairer, recycler, purchaser...) through an access grant, and see or end the grants already issued. A grant names a role, a scope (company, chosen products or chosen passports), a purpose, optional evidence and an expiry (default 12 months). Needs an OAuth connection approved for access grants or an API key with "May manage access grants" switched on (403 access_grants_not_enabled); writing needs an admin. Authority roles (e.g. market surveillance) are dashboard-only end to end: create, update and revoke of such a grant are refused (400 role_dashboard_only).
IMPORTANT: create returns the secret pa_ token ONCE. Hand it to the recipient and do not repeat it, store it or put it in a log. It cannot be shown again; if lost, revoke the grant and create a new one. A confirmed grant gives a third party access to restricted data: confirm the recipient, role, scope and purpose with the user first.
Actions (pass via action; {…} is the args object). Reads never return a token.
list — { limit? (≤100), cursor?, role?, status? (active|expired|revoked), passportId?, productId? }.
get — { id }.
create — { role, label, purpose?, scope? ({ kind: company } with no ids, or { kind: products|passports, ids[] } with at least one id), evidence? ({ type: register_entry|invoice|authority_letter|contract|other, reference, note? }), expiresInDays? (1-1825; null = no expiry) }. WRITE.
update — { id, label?, purpose?, scope?, evidence?, expiresInDays? }; at least one. WRITE.
revoke — { id }. WRITE, ends the grant at once; repeating it is safe.
activity — { id, limit? (≤100), cursor? }. The grant's access log.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_epcisTracePass EPCIS 2.0AInspect
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 action; {…} is the args object):
export, export_by_serial — { id } or { serial, gtin? } (on 409 ambiguous_serial pass
gtin). A passport's events as an EPCIS 2.0 JSON-LD document. Read-only.capture — { events }. An EPCISDocument, a single event, or an array of events (JSON-LD). Returns 202 with a captureJobId.
capture_job — { jobId }. Poll a capture job. Read-only.
query — { params? }. Standard EPCIS query parameters as key/value (EQ_bizStep, GE_eventTime, MATCH_epc, …). Read-only.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_passport_fieldsTracePass passport fieldsADestructiveIdempotentInspect
Update field values on a Digital Product Passport. Every change is audit-logged with the credential (API key or connected app) and this MCP channel.
source (optional): omit it or pass "manual" when the user gave you the value or it comes from their own records — written with the user's rights (approved for an API key or an admin; sent to review for a connected app acting for an editor). Pass "ai_suggested" when you found or inferred it yourself: it goes to the dashboard review queue for a human, and is refused on fields only the operator may state or that must be measured (e.g. stateOfHealth).
Actions (pass via action; {…} is the args object):
update — { id, fieldKey, value, source? }.
valuetype matches the field's dataType.update_by_serial — { serial, fieldKey, value, gtin?, source? }. On 409 ambiguous_serial (a serial is unique only WITHIN a GTIN) pass
gtin.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_passport_lifecycleTracePass passport lifecycle (irreversible actions)ADestructiveInspect
WARNING: Every action here changes what the public sees or is a legal act, some irreversible. archive permanently takes the passport off public view (its URL shows an archive notice; only an authority access grant still reads it). record_registration records the economic operator's registration in the production EU DPP Registry and locks the passport's operator and facility identifiers. place_on_market submits a registration to an EN 18222 registry API. The assistant MUST confirm with the user before each call. Use suspend (reversible — public QR shows 'suspended') as the safe alternative to archive when a change might need to be undone; a passport placed on the market cannot be suspended, because it must stay public.
EU DPP REGISTRY: the operator registers a battery passport itself, on the Registry website under its own EU Login; TracePass never submits to the Registry and never verifies the outcome. The acceptance environment has no legal effect; only a production registration counts. Paid plan; a connected app (OAuth) must act for an admin or owner. Refusal codes: resource tracepass://reference/lifecycle.
Actions (pass via action; {…} is the args object). All are WRITEs (1 write each). A *_by_serial action takes { serial, gtin? } instead of id (on 409 ambiguous_serial pass gtin).
record_registration — { id, placedOnMarketAt? (YYYY-MM-DD), registrationId? }. Battery, published only. Records that the operator has registered this passport in the PRODUCTION EU DPP Registry, as the operator states it; TracePass does not check it. Confirm with the user first, and only after the operator has registered on the Registry website. Effects: marked placed on the market; operator and facility identifiers locked (409 operator_locked); webhook fires.
undo_registration — { id, environment: production|acceptance }. Undoes a mistaken record; production unlocks the operator identifiers (a delivered webhook is not recalled). Changes nothing in the Registry. Confirm with the user first.
place_on_market — { id }. Battery, published only. Submits to the EN 18222 registry API in the account's registry settings. NOT the way into the EU DPP Registry, which does not accept it: use prepare_registry_upi / prepare_registry_upload_file, then record_registration. A legal act for the economic operator — confirm with the user first. ASYNCHRONOUS: answers 202 "placing"; follow placeOnMarketStatus (placing → placed | rejected) by reading the passport. 409 codes include registry_host_not_allowed (the configured registry address is not allowed; check the URL) and registry_not_ready (run registry_readiness).
suspend, suspend_by_serial — { id }. Reversible — public QR shows 'suspended'. Refused with 409 passport_placed_on_market once the passport is placed on the market or its registration is under way.
archive, archive_by_serial — { id, reason? }. IRREVERSIBLE and destructive — confirm with the user first. Its URL then shows an archive notice (machine formats 404); only an authority grant still reads it. reason is REQUIRED for battery passports (400 reason_required): recycled, never_placed (never placed on the market or put into service) or duplicate_or_error; never_placed is refused (409 reason_contradicts_placement) once placed on the market.
archive_product — { id }. Archives a PRODUCT (not a passport). Reversible — soft-archives it from the catalogue. 409 while any non-archived passport references it; archive those first.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_passport_partiesTracePass passport partiesADestructiveIdempotentInspect
Manage the economic-operator parties on a passport (manufacturer, importer, authorisedRepresentative, distributor, recycler, producerResponsibilityOrg). Each carries a legal name and an identifier.
A party needs at least one of gln, legacyOperatorId or operatorIdentifier (EN 18219 §6.2–6.5; they must agree if both gln forms are given, else 400). Identifier shapes: resource tracepass://reference/parties.
Actions (pass via action; {…} is the args object):
set — { id, role, legalName, gln?, country?, url?, tradeName?, postalAddress?, email?, legacyOperatorId?, operatorIdentifier?, facilityIdentifier? }. tradeName, postalAddress and email are public; for a battery importer they are its Battery Regulation Art. 41(3) details.
remove — { id, role }.
After a battery passport is placed on the market, changing a stored operatorIdentifier or facilityIdentifier returns 409 operator_locked; other edits stay allowed.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_passportsTracePass passportsADestructiveInspect
Manage Digital Product Passports — create, read, run compliance checks. Archive, suspend, place on market and record_registration are in tracepass_passport_lifecycle.
IMPORTANT: create makes a DRAFT passport: no plan DPP slot, never billed. The slot, and any overage past the plan cap, is taken when it is published in the TracePass dashboard, not through this tool. Each create counts against the daily write budget.
EU DPP REGISTRY (battery): the operator registers a passport itself, on the Registry website under its own EU Login. TracePass prepares what it submits and records what it reports; it never submits to the Registry and never verifies the outcome. The acceptance environment has no legal effect; production is recorded with record_registration (tracepass_passport_lifecycle). Paid plan; an OAuth app must act for an admin or owner.
Identifier schemes (EN 18219): gs1 | iso15459 | iec61406 | did | doi; batteries accept ONLY gs1 and iso15459. Shapes, lineage, snapshots, measurements, refusal codes: resource tracepass://reference/passports.
Actions (pass via action; {…} is the args object). Read-only unless marked WRITE. A *_by_serial action takes { serial, gtin? } instead of id (on 409 ambiguous_serial pass gtin).
list — { page?, limit? (≤100), productId?, status?, search? }. status ∈ draft|in_review|approved|published|suspended|expired|archived.
get, get_by_serial — { id, format? (summary|full), lang? }.
compliance — { id }. compliant | compliant_with_warnings | incomplete, with regulation-cited findings and byRegulation[]. A regulation absent from byRegulation raised no finding, which is not the same as passed.
registry_readiness — { id }. Battery only. { ready, findings[] }: the Registry's FORMAL pre-submission check, not the compliance verdict.
prepare_registry_upi — { id }. WRITE, battery, published only. { upi, preparedAt } for the operator to paste into the Registry form. Submits nothing.
prepare_registry_upload_file — { passportIds (1–100) }. WRITE, battery. { xml, filename, included, excluded }: the operator uploads
xmlon the Registry website; TracePass does not. 1 write per included passport.record_acceptance_test — { id, result: passed|failed, errorCode? }. WRITE, battery, published only. Records what the operator reports from the ACCEPTANCE environment: no legal effect, not verified. Undo: undo_registration (acceptance).
create — { productId, identifier?, gtin?, serialNumber?, lineage? }. Draft, not billed. identifier preferred, or legacy gtin + serialNumber. Battery: only gs1/iso15459, else 400. Duplicate: 409. lineage (battery): a repurposed, remanufactured or reused battery needs a NEW passport linked to the original(s) (Art. 77(7)); immutable after create.
get_qr, get_qr_by_serial — { id, format? (svg|png), symbology? (qr|datamatrix) }. One passport's QR; the bare GTIN URL is the product's model page (see products get_links).
list_snapshots — { id, page?, limit?, at? (ISO 8601) }; get_snapshot — { id, snapshotId }. EN 18221 change archive (
at= the snapshot valid then). Entries carry contentHash, hashMethod (jcs-sha256 = RFC 8785 + SHA-256; older: sorted-json-sha256), previousHash and, in the list, chainLink plus a chain verdict. 1 read each.get_condition_flags, _by_serial — { id }. Approved yes/no facts that gate conditional duties; an approved flag can make fields required and block publish. 1 read.
set_condition_flags, _by_serial — { id, flags: Record<flagKey, boolean|null> }. WRITE; null clears. WARNING: approving a flag can make fields required and block publishing if empty — fix them before or right after.
capture_measurements, _by_serial — { id, measurements: [ { fieldKey, value, measuredAt (ISO 8601), externalId?, unit? } ] (≤500) }. WRITE, battery, published only. Over-life data from the customer's equipment; metered against the monthly measurement allowance, not the write budget.
list_measurements, _by_serial — { id, fieldKey?, from?, to?, limit? (≤200), cursor? }; latest_measurements, _by_serial — { id }. Read-only.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_productsTracePass productsADestructiveInspect
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. Archive is in tracepass_passport_lifecycle.
Actions (pass via action; {…} is the args object):
list — { page?, limit? (≤100), category?, status?, search? }. Read-only.
get — { id }. Read-only.
create — { name, model, category, description? }.
categoryis one of the 13 DPP categories (tracepass_templates list).update — { id, name?, model?, description? }; at least one field.
get_links — { id, format? (json|csv), limit? (≤5000), cursor? (json: prior nextCursor) }. Every PUBLISHED passport's serial, passportUrl, status (json adds qrApiUrl, needs your API credentials) plus the model page URL, for a dealer asking for passport links.
get_model_qr — { id, format? (svg|png), gtin? (14 digits) }. QR of the model page. 404 model_not_found; 400 gtin_required (several GTINs) or invalid_gtin.
create_batch — { products: [ { name, model, category, description? }, … ] }, up to 100. Partial-success: per-item status, so some can be created while others error. The batch consumes N writes upfront; if that would exceed the daily cap NOTHING is created (429).
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_scopeTracePass DPP scope checkerAInspect
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 reads the catalogue-wide scope report and triggers a refresh run.
HARD RULES — always apply to scope answers:
State what the law says for product types matching the given facts. Not legal advice; never write 'you must' — use product-type phrasing ('LMT batteries need a passport from 18 February 2027, Battery Regulation Art. 77(1)').
Cite the article given for every verdict and duty; a regulation without an article is not a citation.
not_coveredrests on no article: say our rules do not cover the product, name the nearest act given, never cite it as the basis.A date with precision 'quarter', 'month' or 'year' is a plan, NEVER a deadline: write 'planned for Q2 2027 (planned, not law yet)', never 'from', 'by' or 'deadline'.
Relay
not_coveredandneeds_inputas results, never errors.needs_input= blocking questions remain — relayask[]to the user before giving a verdict.Items in an act's
plannedlist are not law yet: label them 'Planned, not law yet' (labelText), with theirwording.data.inScope: yes = passport required; no = none required AND none planned (incl. ESPR-framework-only products, packaging): never say 'not yet' or 'yet'; pending = none today, a passport act is planned: name it fromplanned[]; depends = unanswered facts.ruleStatus: 'needs_recheck': the law behind the act changed and our rules are being re-checked (sincerecheckSince); say so.
Actions (pass via action; {…} is the args object); values, caps and response shapes: resource tracepass://reference/scope.
check — { category?, facts?, role?, placedOnMarket?, lifecycleEvent?, contains?, productId?, passportId?, locale? }. Every plan; counts against the scope-answer cap (~100/day), not the v1 budget (429
scope_answer_cap). Unknownfactskeys: 400. Omitrolefor all roles' duties.catalogue_report — { classification?, category?, act?, changed?, q?, cursor?, limit? (≤500) }. One row per product. Growth plan or above; 403
plan_upgrade_requiredbelow it — tell the user this needs a plan upgrade, do not retry.catalogue_run — {}. Start a refresh run (also nightly); poll with catalogue_run_status. Growth plan. 409 run_in_progress; 429 run_cooldown.
catalogue_run_status — { runId }. Growth plan.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
tracepass_templatesTracePass DPP templates (regulatory schemas)ARead-onlyIdempotentInspect
What a COMPLIANT passport must contain per category, per the governing EU regulation. Read-only reference data; use it to advise on requirements before creating products/passports and to gap-check a draft.
Actions (pass via action; {…} is the args object):
list — {}. All 13 categories with counts and governing regulation.
get — { category }. Every field: key, label, dataType, REQUIRED flag, access level, options, bounds and, where known, the mandating article.
BATTERY — required alone is the wrong answer. SCOPE FIRST: only EV, LMT and industrial_gt_2kwh batteries owe a passport (Art. 77(1), Reg (EU) 2023/1542); for portable, SLI or industrial_lte_2kwh NO field is required — say it is out of scope and list no mandatory fields. Then use requiredBy[batteryCategory] (required | conditional | notApplicable), and required only as a fallback; skipping the scope step invents an obligation the Regulation does not impose. conditional fields, use data and the EV/LMT state-of-health split: resource tracepass://reference/templates.
Inputs: action (required), args. Returns: id, page, error, items, +5 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Create & manage EU Digital Product Passports with PassportCraft: textiles, batteries, general goods.
Free EU DPP engine and garment tech packs: DPP drafts, GS1 Digital Link, textile footprint.
Prove a physical item is genuine (NFC chip); read its EU Digital Product Passport, recalls, custody.
Carbon accounting platform. Query emission factors and create or edit draft emissions.
Related MCP Servers
- AlicenseBqualityCmaintenanceManages trust chains and attestations with built-in EU AI Act compliance.55 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables read-only preflight checks of supplier-declared EPREL records, including product search, record and energy-label lookup, metric comparison, and signed receipts of checked lookups.316 npmMIT
- FlicenseNot gradedqualityDmaintenanceExposes CRUD operations for products via MCP tools and a resource, sharing a common business logic layer with a GraphQL API.-
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to manage projects, cases, and file uploads while maintaining an immutable audit trail for all write operations.-
Glama MCP Gateway
Add one secure layer between your agents and this server.