Skip to main content
Glama

TracePass passports

tracepass_passports
Destructive

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 xml on 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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "<action>"
    },
    "name": "tracepass_passports"
  }
}

Input Schema

NameRequiredDescriptionDefault
argsNo
actionYes

Output Schema

NameRequiredDescriptionDefault
idNo
pageNo
errorNo
itemsNo
limitNo
totalNo
resultNo
messageNo
totalPagesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed36 schema fields changed
    • removedInput schema / properties / action / description
      Removed value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed) | prepare_registry_upi | prepare_registry_upload_file | record_acceptance_test (EU DPP Registry: prepare what the operator submits on the Registry website, record an acceptance test; TracePass never submits). (archive, suspend, place_on_market, record_registration, undo_registration are in tracepass_passport_lifecycle.)"
    • removedInput schema / properties / args / description
      Removed value: -"Arguments for the chosen action; required fields depend on `action` (see each action above)."
    • removedInput schema / properties / args / properties / at / description
      Removed value: -"list_snapshots: ISO 8601 instant — return the snapshot valid then instead of the list."
    • removedInput schema / properties / args / properties / cursor / description
      Removed value: -"list_measurements(_by_serial): nextCursor from the previous page."
    • removedInput schema / properties / args / properties / errorCode / description
      Removed value: -"record_acceptance_test: the error code the Registry showed for a failed test (≤100 chars)."
    • removedInput schema / properties / args / properties / fieldKey / description
      Removed value: -"list_measurements(_by_serial): only this field key."
    • changedInput schema / properties / args / properties / flags / description
      Previous value: -"For set_condition_flags / set_condition_flags_by_serial: Record<flagKey, boolean|null>. null clears the flag."New value: +"flagKey → boolean; null clears."
    • changedInput schema / properties / args / properties / format / description
      Previous value: -"get/get_by_serial: summary|full. get_qr/get_qr_by_serial: svg|png."New value: +"summary|full (get); svg|png (get_qr)."
    • removedInput schema / properties / args / properties / from / description
      Removed value: -"list_measurements(_by_serial): measuredAt from (ISO 8601)."
    • changedInput schema / properties / args / properties / gtin / description
      Previous value: -"For create (legacy): GS1 GTIN. Also used as a disambiguator for *_by_serial actions when a serial isn't unique (else 409 ambiguous_serial)."New value: +"Legacy GS1 GTIN (create), or the disambiguator for *_by_serial."
    • removedInput schema / properties / args / properties / id / description
      Removed value: -"Passport id. Required for get/compliance/registry_readiness/prepare_registry_upi/record_acceptance_test/get_qr (the by-id actions)."
    • changedInput schema / properties / args / properties / identifier / description
      Previous value: -"EN 18219 scheme-tagged identifier for create. Must have `scheme` plus scheme-specific fields. Schemes: gs1 {gtin, serialNumber} | iso15459 {issuingAgencyCode, primaryId, serial?} | iec61406 {uri} | did {did, method} | doi {doi, granularity} (granularity: \"model\"|\"batch\"|\"item\" REQUIRED per EN 18219 §5.6.2(b)). Battery passports: gs1 and iso15459 only."New value: +"{ scheme: gs1|iso15459|iec61406|did|doi, … }. Shapes: tracepass://reference/passports."
    • changedInput schema / properties / args / properties / lang / description
      Previous value: -"Resolve field values to one of the 24 EU locales server-side (get/get_by_serial)."New value: +"One of the 24 EU locales (get)."
    • removedInput schema / properties / args / properties / limit / description
      Removed value: -"Page size for list, max 100."
    • removedInput schema / properties / args / properties / lineage / description
      Removed value: -"create, battery only: link a second-life battery's new passport to the original passport(s) (Art. 77(7)). See the create action."
    • removedInput schema / properties / args / properties / measurements / description
      Removed value: -"capture_measurements(_by_serial): [{ fieldKey, value, measuredAt, externalId?, unit? }], max 500."
    • removedInput schema / properties / args / properties / page / description
      Removed value: -"Page number for list (1-based)."
    • removedInput schema / properties / args / properties / passportIds / description
      Removed value: -"prepare_registry_upload_file: the battery passport ids to put in the EU DPP Registry upload file (1–100)."
    • removedInput schema / properties / args / properties / productId / description
      Removed value: -"Parent product id. Required for create."
    • removedInput schema / properties / args / properties / result / description
      Removed value: -"record_acceptance_test: the outcome the operator saw in the Registry's acceptance environment."
    • removedInput schema / properties / args / properties / search / description
      Removed value: -"Filter list by a search term."
    • removedInput schema / properties / args / properties / serial / description
      Removed value: -"Your own serial number. Required for the *_by_serial actions."
    • removedInput schema / properties / args / properties / serialNumber / description
      Removed value: -"Serial for the new passport (create, legacy gs1 path)."
    • removedInput schema / properties / args / properties / snapshotId / description
      Removed value: -"Snapshot id. Required for get_snapshot."
    • removedInput schema / properties / args / properties / status / description
      Removed value: -"Filter list by status: draft|in_review|approved|published|suspended|expired|archived."
    • changedInput schema / properties / args / properties / symbology / description
      Previous value: -"get_qr/get_qr_by_serial: qr (default) | datamatrix."New value: +"qr (default) | datamatrix."
    • removedInput schema / properties / args / properties / to / description
      Removed value: -"list_measurements(_by_serial): measuredAt to (ISO 8601)."
    • removedOutput schema / properties / error / description
      Removed value: -"Machine-readable error code, when the API rejected the request."
    • removedOutput schema / properties / id / description
      Removed value: -"The resource's TracePass id, when the response is a single entity."
    • removedOutput schema / properties / items / description
      Removed value: -"The page of results, when the action is a list."
    • removedOutput schema / properties / limit / description
      Removed value: -"Page size (list actions)."
    • removedOutput schema / properties / message / description
      Removed value: -"Human-readable error or status detail, when present."
    • removedOutput schema / properties / page / description
      Removed value: -"Current page number (list actions)."
    • removedOutput schema / properties / result / description
      Removed value: -"Wraps a non-object response body (e.g. a QR code string)."
    • removedOutput schema / properties / total / description
      Removed value: -"Total matching records across all pages (list actions)."
    • removedOutput schema / properties / totalPages / description
      Removed value: -"Total number of pages (list actions)."
  2. Changed6 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed). (archive, suspend, place_on_market are in tracepass_passport_lifecycle.)"New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed) | prepare_registry_upi | prepare_registry_upload_file | record_acceptance_test (EU DPP Registry: prepare what the operator submits on the Registry website, record an acceptance test; TracePass never submits). (archive, suspend, place_on_market, record_registration, undo_registration are in tracepass_passport_lifecycle.)"
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "registry_readiness",
      -  "get_condition_flags",
      -  "get_condition_flags_by_serial",
      -  "set_condition_flags",
      -  "set_condition_flags_by_serial",
      -  "capture_measurements",
      -  "capture_measurements_by_serial",
      -  "list_measurements",
      -  "list_measurements_by_serial",
      -  "latest_measurements",
      -  "latest_measurements_by_serial",
      -  "create",
      -  "get_qr",
      -  "get_qr_by_serial",
      -  "list_snapshots",
      -  "get_snapshot"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "prepare_registry_upi",
      +  "prepare_registry_upload_file",
      +  "record_acceptance_test",
      +  "get_condition_flags",
      +  "get_condition_flags_by_serial",
      +  "set_condition_flags",
      +  "set_condition_flags_by_serial",
      +  "capture_measurements",
      +  "capture_measurements_by_serial",
      +  "list_measurements",
      +  "list_measurements_by_serial",
      +  "latest_measurements",
      +  "latest_measurements_by_serial",
      +  "create",
      +  "get_qr",
      +  "get_qr_by_serial",
      +  "list_snapshots",
      +  "get_snapshot"
      +]
    • addedInput schema / properties / args / properties / errorCode
      Added value: +{
      +  "description": "record_acceptance_test: the error code the Registry showed for a failed test (≤100 chars).",
      +  "type": "string"
      +}
    • changedInput schema / properties / args / properties / id / description
      Previous value: -"Passport id. Required for get/compliance/registry_readiness/get_qr (the by-id actions)."New value: +"Passport id. Required for get/compliance/registry_readiness/prepare_registry_upi/record_acceptance_test/get_qr (the by-id actions)."
    • addedInput schema / properties / args / properties / passportIds
      Added value: +{
      +  "description": "prepare_registry_upload_file: the battery passport ids to put in the EU DPP Registry upload file (1–100).",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / args / properties / result
      Added value: +{
      +  "description": "record_acceptance_test: the outcome the operator saw in the Registry's acceptance environment.",
      +  "enum": [
      +    "passed",
      +    "failed"
      +  ],
      +  "type": "string"
      +}
  3. Changed4 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed). Lifecycle: place_on_market (battery, published; async EU registry entry — confirm first) | suspend (reversible) | archive (IRREVERSIBLE; battery passports need `reason`), the last two each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed). (archive, suspend, place_on_market are in tracepass_passport_lifecycle.)"
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "registry_readiness",
      -  "place_on_market",
      -  "get_condition_flags",
      -  "get_condition_flags_by_serial",
      -  "set_condition_flags",
      -  "set_condition_flags_by_serial",
      -  "capture_measurements",
      -  "capture_measurements_by_serial",
      -  "list_measurements",
      -  "list_measurements_by_serial",
      -  "latest_measurements",
      -  "latest_measurements_by_serial",
      -  "create",
      -  "suspend",
      -  "suspend_by_serial",
      -  "archive",
      -  "archive_by_serial",
      -  "get_qr",
      -  "get_qr_by_serial",
      -  "list_snapshots",
      -  "get_snapshot"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "get_condition_flags",
      +  "get_condition_flags_by_serial",
      +  "set_condition_flags",
      +  "set_condition_flags_by_serial",
      +  "capture_measurements",
      +  "capture_measurements_by_serial",
      +  "list_measurements",
      +  "list_measurements_by_serial",
      +  "latest_measurements",
      +  "latest_measurements_by_serial",
      +  "create",
      +  "get_qr",
      +  "get_qr_by_serial",
      +  "list_snapshots",
      +  "get_snapshot"
      +]
    • changedInput schema / properties / args / properties / id / description
      Previous value: -"Passport id. Required for get/compliance/place_on_market/suspend/archive/get_qr (the by-id actions)."New value: +"Passport id. Required for get/compliance/registry_readiness/get_qr (the by-id actions)."
    • removedInput schema / properties / args / properties / reason
      Removed value: -{
      -  "description": "archive / archive_by_serial: Required for battery passports: why the passport ends. A battery passport ends only when the battery has been recycled, so the choices are recycled, never placed on the market or put into service, or a duplicate or erroneous record.",
      -  "enum": [
      -    "recycled",
      -    "never_placed",
      -    "duplicate_or_error"
      -  ],
      -  "type": "string"
      -}
  4. Changed6 schema fields changed
    • removedInput schema / properties / args / properties / flags / additionalProperties / anyOf
      Removed value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / args / properties / flags / additionalProperties / type
      Added value: +[
      +  "boolean",
      +  "null"
      +]
    • removedOutput schema / properties / error / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / error / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / message / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / message / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  5. Changed4 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed). Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed). Lifecycle: place_on_market (battery, published; async EU registry entry — confirm first) | suspend (reversible) | archive (IRREVERSIBLE; battery passports need `reason`), the last two each with a _by_serial variant."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "registry_readiness",
      -  "get_condition_flags",
      -  "get_condition_flags_by_serial",
      -  "set_condition_flags",
      -  "set_condition_flags_by_serial",
      -  "capture_measurements",
      -  "capture_measurements_by_serial",
      -  "list_measurements",
      -  "list_measurements_by_serial",
      -  "latest_measurements",
      -  "latest_measurements_by_serial",
      -  "create",
      -  "suspend",
      -  "suspend_by_serial",
      -  "archive",
      -  "archive_by_serial",
      -  "get_qr",
      -  "get_qr_by_serial",
      -  "list_snapshots",
      -  "get_snapshot"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "place_on_market",
      +  "get_condition_flags",
      +  "get_condition_flags_by_serial",
      +  "set_condition_flags",
      +  "set_condition_flags_by_serial",
      +  "capture_measurements",
      +  "capture_measurements_by_serial",
      +  "list_measurements",
      +  "list_measurements_by_serial",
      +  "latest_measurements",
      +  "latest_measurements_by_serial",
      +  "create",
      +  "suspend",
      +  "suspend_by_serial",
      +  "archive",
      +  "archive_by_serial",
      +  "get_qr",
      +  "get_qr_by_serial",
      +  "list_snapshots",
      +  "get_snapshot"
      +]
    • changedInput schema / properties / args / properties / id / description
      Previous value: -"Passport id. Required for get/compliance/suspend/archive/get_qr (the by-id actions)."New value: +"Passport id. Required for get/compliance/place_on_market/suspend/archive/get_qr (the by-id actions)."
    • addedInput schema / properties / args / properties / reason
      Added value: +{
      +  "description": "archive / archive_by_serial: Required for battery passports: why the passport ends. A battery passport ends only when the battery has been recycled, so the choices are recycled, never placed on the market or put into service, or a duplicate or erroneous record.",
      +  "enum": [
      +    "recycled",
      +    "never_placed",
      +    "duplicate_or_error"
      +  ],
      +  "type": "string"
      +}
  6. Changed2 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (BILLABLE). Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (a draft, not billed). Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • removedInput schema / properties / args / properties / confirmOverage
      Removed value: -{
      -  "description": "Set true to accept per-passport overage charges when over the plan quota (402). Applies to create.",
      -  "type": "boolean"
      -}
  7. Changed4 schema fields changed
    • addedOutput schema / properties / error / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / error / type
      Removed value: -"string"
    • addedOutput schema / properties / message / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / message / type
      Removed value: -"string"
  8. Changed7 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot. Writes: set_condition_flags | set_condition_flags_by_serial | create (BILLABLE). Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot | list_measurements(_by_serial) | latest_measurements(_by_serial). Writes: set_condition_flags | set_condition_flags_by_serial | capture_measurements(_by_serial) | create (BILLABLE). Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "registry_readiness",
      -  "get_condition_flags",
      -  "get_condition_flags_by_serial",
      -  "set_condition_flags",
      -  "set_condition_flags_by_serial",
      -  "create",
      -  "suspend",
      -  "suspend_by_serial",
      -  "archive",
      -  "archive_by_serial",
      -  "get_qr",
      -  "get_qr_by_serial",
      -  "list_snapshots",
      -  "get_snapshot"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "get_condition_flags",
      +  "get_condition_flags_by_serial",
      +  "set_condition_flags",
      +  "set_condition_flags_by_serial",
      +  "capture_measurements",
      +  "capture_measurements_by_serial",
      +  "list_measurements",
      +  "list_measurements_by_serial",
      +  "latest_measurements",
      +  "latest_measurements_by_serial",
      +  "create",
      +  "suspend",
      +  "suspend_by_serial",
      +  "archive",
      +  "archive_by_serial",
      +  "get_qr",
      +  "get_qr_by_serial",
      +  "list_snapshots",
      +  "get_snapshot"
      +]
    • addedInput schema / properties / args / properties / cursor
      Added value: +{
      +  "description": "list_measurements(_by_serial): nextCursor from the previous page.",
      +  "type": "string"
      +}
    • addedInput schema / properties / args / properties / fieldKey
      Added value: +{
      +  "description": "list_measurements(_by_serial): only this field key.",
      +  "type": "string"
      +}
    • addedInput schema / properties / args / properties / from
      Added value: +{
      +  "description": "list_measurements(_by_serial): measuredAt from (ISO 8601).",
      +  "type": "string"
      +}
    • addedInput schema / properties / args / properties / measurements
      Added value: +{
      +  "description": "capture_measurements(_by_serial): [{ fieldKey, value, measuredAt, externalId?, unit? }], max 500.",
      +  "items": {
      +    "properties": {
      +      "externalId": {
      +        "type": "string"
      +      },
      +      "fieldKey": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "measuredAt": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "unit": {
      +        "type": "string"
      +      },
      +      "value": {}
      +    },
      +    "required": [
      +      "fieldKey",
      +      "value",
      +      "measuredAt"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / args / properties / to
      Added value: +{
      +  "description": "list_measurements(_by_serial): measuredAt to (ISO 8601).",
      +  "type": "string"
      +}
  9. Changed1 schema field changed
    • addedInput schema / properties / args / properties / lineage
      Added value: +{
      +  "description": "create, battery only: link a second-life battery's new passport to the original passport(s) (Art. 77(7)). See the create action.",
      +  "properties": {
      +    "noPredecessorReason": {
      +      "maxLength": 500,
      +      "type": "string"
      +    },
      +    "predecessors": {
      +      "items": {
      +        "properties": {
      +          "identifier": {
      +            "maxLength": 2000,
      +            "type": "string"
      +          },
      +          "internalPassportId": {
      +            "type": "string"
      +          },
      +          "trigger": {
      +            "enum": [
      +              "preparation_for_reuse",
      +              "preparation_for_repurposing",
      +              "repurposing",
      +              "remanufacturing"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "trigger"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 10,
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "predecessors"
      +  ],
      +  "type": "object"
      +}
  10. Changed2 schema fields changed
    • addedInput schema / properties / args / properties / at
      Added value: +{
      +  "description": "list_snapshots: ISO 8601 instant — return the snapshot valid then instead of the list.",
      +  "type": "string"
      +}
    • addedInput schema / properties / args / properties / symbology
      Added value: +{
      +  "description": "get_qr/get_qr_by_serial: qr (default) | datamatrix.",
      +  "type": "string"
      +}
  11. Changed3 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr | get_qr_by_serial | list_snapshots | get_snapshot. Writes (BILLABLE): create. Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_condition_flags | get_condition_flags_by_serial | get_qr | get_qr_by_serial | list_snapshots | get_snapshot. Writes: set_condition_flags | set_condition_flags_by_serial | create (BILLABLE). Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "registry_readiness",
      -  "create",
      -  "suspend",
      -  "suspend_by_serial",
      -  "archive",
      -  "archive_by_serial",
      -  "get_qr",
      -  "get_qr_by_serial",
      -  "list_snapshots",
      -  "get_snapshot"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "get_condition_flags",
      +  "get_condition_flags_by_serial",
      +  "set_condition_flags",
      +  "set_condition_flags_by_serial",
      +  "create",
      +  "suspend",
      +  "suspend_by_serial",
      +  "archive",
      +  "archive_by_serial",
      +  "get_qr",
      +  "get_qr_by_serial",
      +  "list_snapshots",
      +  "get_snapshot"
      +]
    • addedInput schema / properties / args / properties / flags
      Added value: +{
      +  "additionalProperties": {
      +    "anyOf": [
      +      {
      +        "type": "boolean"
      +      },
      +      {
      +        "type": "null"
      +      }
      +    ]
      +  },
      +  "description": "For set_condition_flags / set_condition_flags_by_serial: Record<flagKey, boolean|null>. null clears the flag.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
  12. Changed3 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr | get_qr_by_serial. Writes (BILLABLE): create. Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr | get_qr_by_serial | list_snapshots | get_snapshot. Writes (BILLABLE): create. Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "registry_readiness",
      -  "create",
      -  "suspend",
      -  "suspend_by_serial",
      -  "archive",
      -  "archive_by_serial",
      -  "get_qr",
      -  "get_qr_by_serial"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "create",
      +  "suspend",
      +  "suspend_by_serial",
      +  "archive",
      +  "archive_by_serial",
      +  "get_qr",
      +  "get_qr_by_serial",
      +  "list_snapshots",
      +  "get_snapshot"
      +]
    • addedInput schema / properties / args / properties / snapshotId
      Added value: +{
      +  "description": "Snapshot id. Required for get_snapshot.",
      +  "type": "string"
      +}
  13. Changed1 schema field changed
    • changedInput schema / properties / args / properties / identifier / description
      Previous value: -"EN 18219 scheme-tagged identifier for create. Must have `scheme` plus scheme-specific fields. Schemes: gs1 {gtin, serialNumber} | iso15459 {issuingAgencyCode, primaryId, serial?} | iec61406 {uri} | did {did, method} | doi {doi}. Battery passports: gs1 and iso15459 only."New value: +"EN 18219 scheme-tagged identifier for create. Must have `scheme` plus scheme-specific fields. Schemes: gs1 {gtin, serialNumber} | iso15459 {issuingAgencyCode, primaryId, serial?} | iec61406 {uri} | did {did, method} | doi {doi, granularity} (granularity: \"model\"|\"batch\"|\"item\" REQUIRED per EN 18219 §5.6.2(b)). Battery passports: gs1 and iso15459 only."
  14. Changed6 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr | get_qr_by_serial. Lifecycle: create (BILLABLE) | suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr | get_qr_by_serial. Writes (BILLABLE): create. Lifecycle: suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • changedInput schema / properties / args / properties / confirmOverage / description
      Previous value: -"Set true to accept a per-passport overage charge when create is over the plan quota (402)."New value: +"Set true to accept per-passport overage charges when over the plan quota (402). Applies to create."
    • changedInput schema / properties / args / properties / gtin / description
      Previous value: -"GTIN disambiguator for *_by_serial actions when a serial isn't unique across GTINs (else 409 ambiguous_serial)."New value: +"For create (legacy): GS1 GTIN. Also used as a disambiguator for *_by_serial actions when a serial isn't unique (else 409 ambiguous_serial)."
    • changedInput schema / properties / args / properties / id / description
      Previous value: -"Passport id. Required for get/compliance/create-result/suspend/archive/get_qr (the by-id actions)."New value: +"Passport id. Required for get/compliance/suspend/archive/get_qr (the by-id actions)."
    • addedInput schema / properties / args / properties / identifier
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "EN 18219 scheme-tagged identifier for create. Must have `scheme` plus scheme-specific fields. Schemes: gs1 {gtin, serialNumber} | iso15459 {issuingAgencyCode, primaryId, serial?} | iec61406 {uri} | did {did, method} | doi {doi}. Battery passports: gs1 and iso15459 only.",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedInput schema / properties / args / properties / serialNumber / description
      Previous value: -"Serial for the new passport. Required for create."New value: +"Serial for the new passport (create, legacy gs1 path)."
  15. Changed3 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr. Lifecycle: create (BILLABLE) | suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr | get_qr_by_serial. Lifecycle: create (BILLABLE) | suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "registry_readiness",
      -  "create",
      -  "suspend",
      -  "suspend_by_serial",
      -  "archive",
      -  "archive_by_serial",
      -  "get_qr"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "create",
      +  "suspend",
      +  "suspend_by_serial",
      +  "archive",
      +  "archive_by_serial",
      +  "get_qr",
      +  "get_qr_by_serial"
      +]
    • changedInput schema / properties / args / properties / format / description
      Previous value: -"get/get_by_serial: summary|full. get_qr: svg|png."New value: +"get/get_by_serial: summary|full. get_qr/get_qr_by_serial: svg|png."
  16. Changed2 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which passport operation to run. Reads: list | get | get_by_serial | compliance | get_qr. Lifecycle: create (BILLABLE) | suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."New value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | registry_readiness | get_qr. Lifecycle: create (BILLABLE) | suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "create",
      -  "suspend",
      -  "suspend_by_serial",
      -  "archive",
      -  "archive_by_serial",
      -  "get_qr"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "registry_readiness",
      +  "create",
      +  "suspend",
      +  "suspend_by_serial",
      +  "archive",
      +  "archive_by_serial",
      +  "get_qr"
      +]
  17. Changed6 schema fields changed
    • addedInput schema / properties / action / description
      Added value: +"Which passport operation to run. Reads: list | get | get_by_serial | compliance | get_qr. Lifecycle: create (BILLABLE) | suspend (reversible) | archive (IRREVERSIBLE), each with a _by_serial variant."
    • removedInput schema / properties / args / additionalProperties
      Removed value: -{}
    • changedInput schema / properties / args / description
      Previous value: -"Action-specific arguments — see the description for each action's shape."New value: +"Arguments for the chosen action; required fields depend on `action` (see each action above)."
    • addedInput schema / properties / args / properties
      Added value: +{
      +  "confirmOverage": {
      +    "description": "Set true to accept a per-passport overage charge when create is over the plan quota (402).",
      +    "type": "boolean"
      +  },
      +  "format": {
      +    "description": "get/get_by_serial: summary|full. get_qr: svg|png.",
      +    "type": "string"
      +  },
      +  "gtin": {
      +    "description": "GTIN disambiguator for *_by_serial actions when a serial isn't unique across GTINs (else 409 ambiguous_serial).",
      +    "type": "string"
      +  },
      +  "id": {
      +    "description": "Passport id. Required for get/compliance/create-result/suspend/archive/get_qr (the by-id actions).",
      +    "type": "string"
      +  },
      +  "lang": {
      +    "description": "Resolve field values to one of the 24 EU locales server-side (get/get_by_serial).",
      +    "type": "string"
      +  },
      +  "limit": {
      +    "description": "Page size for list, max 100.",
      +    "type": "number"
      +  },
      +  "page": {
      +    "description": "Page number for list (1-based).",
      +    "type": "number"
      +  },
      +  "productId": {
      +    "description": "Parent product id. Required for create.",
      +    "type": "string"
      +  },
      +  "search": {
      +    "description": "Filter list by a search term.",
      +    "type": "string"
      +  },
      +  "serial": {
      +    "description": "Your own serial number. Required for the *_by_serial actions.",
      +    "type": "string"
      +  },
      +  "serialNumber": {
      +    "description": "Serial for the new passport. Required for create.",
      +    "type": "string"
      +  },
      +  "status": {
      +    "description": "Filter list by status: draft|in_review|approved|published|suspended|expired|archived.",
      +    "type": "string"
      +  }
      +}
    • removedInput schema / properties / args / propertyNames
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "error": {
      +      "description": "Machine-readable error code, when the API rejected the request.",
      +      "type": "string"
      +    },
      +    "id": {
      +      "description": "The resource's TracePass id, when the response is a single entity.",
      +      "type": "string"
      +    },
      +    "items": {
      +      "description": "The page of results, when the action is a list.",
      +      "items": {},
      +      "type": "array"
      +    },
      +    "limit": {
      +      "description": "Page size (list actions).",
      +      "type": "number"
      +    },
      +    "message": {
      +      "description": "Human-readable error or status detail, when present.",
      +      "type": "string"
      +    },
      +    "page": {
      +      "description": "Current page number (list actions).",
      +      "type": "number"
      +    },
      +    "result": {
      +      "description": "Wraps a non-object response body (e.g. a QR code string)."
      +    },
      +    "total": {
      +      "description": "Total matching records across all pages (list actions).",
      +      "type": "number"
      +    },
      +    "totalPages": {
      +      "description": "Total number of pages (list actions).",
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  18. Changed1 schema field changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "compliance",
      -  "create",
      -  "suspend",
      -  "archive",
      -  "get_qr"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "create",
      +  "suspend",
      +  "suspend_by_serial",
      +  "archive",
      +  "archive_by_serial",
      +  "get_qr"
      +]
  19. Changed1 schema field changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "get_by_serial",
      -  "create",
      -  "suspend",
      -  "archive",
      -  "get_qr"
      -]New value: +[
      +  "list",
      +  "get",
      +  "get_by_serial",
      +  "compliance",
      +  "create",
      +  "suspend",
      +  "archive",
      +  "get_qr"
      +]
  20. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnlyHint=false and destructiveHint=true; the description goes far beyond that with billing semantics (create is a draft, never billed; the slot is taken on publish in the dashboard), the daily write budget, metering of measurements against a separate allowance, and per-action write cost ("1 write per included passport", "1 read each"). It also flags irreversible/hazardous effects (lineage immutable after create; null clears flags; approving a flag can block publishing) and the legal no-effect status of the acceptance environment.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Density is very high with little waste, but the operational action list — the part an agent needs first — is buried after a long EU DPP Registry and identifier-scheme preamble, and the registry paragraph repeats the never-submits point already implied by "prepares what it submits". Given 23 actions, the length is defensible, but front-loading the action block would improve it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 23-action dispatcher with nested args, a rich output schema and destructive annotations, the definition covers what an agent needs: per-action args, preconditions, write/read cost, failure modes (409 duplicate, 400 on wrong battery scheme), undo path, and a pointer to tracepass://reference/passports for shapes. Nothing material is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the schema is a flat union of all args across 23 actions, so the description carries the full burden — and it does, mapping each arg set to its action (e.g. `list` takes page/limit ≤100/productId/status/search with the full status enum; `list_snapshots` takes `at` as the snapshot valid then). It adds meaning the schema cannot express, such as batteries accepting only gs1/iso15459 identifiers and `at` being ISO 8601.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening line names the resource, the verbs (create, read, run compliance checks) and explicitly hands off archive/suspend/place-on-market/record_registration to tracepass_passport_lifecycle. The 23-action list then gives each action a one-line verb+scope, so an agent can distinguish `compliance` from `registry_readiness` ("the Registry's FORMAL pre-submission check, not the compliance verdict") without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It states when to use this tool versus the sibling, gives per-action preconditions ("battery, published only", "paid plan; an OAuth app must act for an admin or owner"), and explicitly bounds scope ("it never submits to the Registry and never verifies the outcome"). It even explains the alternative channel for publishing (the TracePass dashboard) and the *_by_serial substitution rule with the 409 ambiguous_serial disambiguation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.