Skip to main content
Glama

TracePass products

tracepass_products
Destructive

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? }. category is 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).

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_products"
  }
}

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. Changed4 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "create",
      -  "create_batch",
      -  "update"
      -]New value: +[
      +  "list",
      +  "get",
      +  "create",
      +  "create_batch",
      +  "update",
      +  "get_links",
      +  "get_model_qr"
      +]
    • addedInput schema / properties / args / properties / cursor
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / args / properties / format
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / args / properties / gtin
      Added value: +{
      +  "type": "string"
      +}
  2. Changed21 schema fields changed
    • removedInput schema / properties / action / description
      Removed value: -"Which product operation to run: list | get | create | create_batch | update. (archive is 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)."
    • changedInput schema / properties / args / properties / category / description
      Previous value: -"DPP category for create: battery | textile | electronics | construction | steel | detergents | paints-coatings | packaging | furniture | tyres | jewelry | toys | fmcg."New value: +"One of the 13 DPP categories."
    • removedInput schema / properties / args / properties / description / description
      Removed value: -"Free-text product description (create/update)."
    • removedInput schema / properties / args / properties / id / description
      Removed value: -"Product id. Required for get and update."
    • removedInput schema / properties / args / properties / limit / description
      Removed value: -"Page size for list, max 100."
    • removedInput schema / properties / args / properties / model / description
      Removed value: -"Manufacturer model / SKU. Required for create; optional on update."
    • removedInput schema / properties / args / properties / name / description
      Removed value: -"Product name. Required for create; optional on update."
    • removedInput schema / properties / args / properties / page / description
      Removed value: -"Page number for list (1-based)."
    • removedInput schema / properties / args / properties / products / description
      Removed value: -"Products to create for create_batch: [{ name, model, category, description? }], max 100."
    • removedInput schema / properties / args / properties / search / description
      Removed value: -"Filter list by a search term."
    • removedInput schema / properties / args / properties / status / description
      Removed value: -"Filter list by product status."
    • 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)."
  3. Changed2 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which product operation to run: list | get | create | create_batch | update | archive."New value: +"Which product operation to run: list | get | create | create_batch | update. (archive is in tracepass_passport_lifecycle.)"
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "create",
      -  "create_batch",
      -  "update",
      -  "archive"
      -]New value: +[
      +  "list",
      +  "get",
      +  "create",
      +  "create_batch",
      +  "update"
      +]
  4. Changed4 schema fields changed
    • 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
    • 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"
  6. Changed1 schema field changed
    • changedInput schema / properties / args / properties / category / description
      Previous value: -"DPP category for create: battery | textile | electronics | construction | steel | chemicals | packaging | furniture | tyres | jewelry | toys | fmcg."New value: +"DPP category for create: battery | textile | electronics | construction | steel | detergents | paints-coatings | packaging | furniture | tyres | jewelry | toys | fmcg."
  7. Changed3 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which product operation to run: list | get | create | update."New value: +"Which product operation to run: list | get | create | create_batch | update | archive."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "get",
      -  "create",
      -  "update"
      -]New value: +[
      +  "list",
      +  "get",
      +  "create",
      +  "create_batch",
      +  "update",
      +  "archive"
      +]
    • addedInput schema / properties / args / properties / products
      Added value: +{
      +  "description": "Products to create for create_batch: [{ name, model, category, description? }], max 100.",
      +  "items": {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  8. Changed6 schema fields changed
    • addedInput schema / properties / action / description
      Added value: +"Which product operation to run: list | get | create | update."
    • 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: +{
      +  "category": {
      +    "description": "DPP category for create: battery | textile | electronics | construction | steel | chemicals | packaging | furniture | tyres | jewelry | toys | fmcg.",
      +    "type": "string"
      +  },
      +  "description": {
      +    "description": "Free-text product description (create/update).",
      +    "type": "string"
      +  },
      +  "id": {
      +    "description": "Product id. Required for get and update.",
      +    "type": "string"
      +  },
      +  "limit": {
      +    "description": "Page size for list, max 100.",
      +    "type": "number"
      +  },
      +  "model": {
      +    "description": "Manufacturer model / SKU. Required for create; optional on update.",
      +    "type": "string"
      +  },
      +  "name": {
      +    "description": "Product name. Required for create; optional on update.",
      +    "type": "string"
      +  },
      +  "page": {
      +    "description": "Page number for list (1-based).",
      +    "type": "number"
      +  },
      +  "search": {
      +    "description": "Filter list by a search term.",
      +    "type": "string"
      +  },
      +  "status": {
      +    "description": "Filter list by product status.",
      +    "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"
      +}
  9. First observed

TDQS

A4.9/5.0
Behavior5/5

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

Goes well past the annotations: it marks list/get as read-only, discloses partial-success semantics for create_batch, explains that the batch consumes N writes upfront and creates nothing if the daily cap would be exceeded (429), and documents 404/400 error codes plus the credential requirement for qrApiUrl. These are exactly the operational facts annotations cannot convey.

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?

Front-loads the domain mental model, then uses a scannable per-action bullet list with no filler sentences. Some entries, notably get_links, pack parameters, return fields, and credential caveats into a single dense line, which costs a little readability.

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 complex multi-action mutation tool with a nested args schema and an output schema, nothing material is missing: the action set, per-action args, write-cap accounting, partial failure, and error codes are all covered, and return shapes are left to the output schema as appropriate.

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%, so the description must carry the load, and it does: per-action argument lists with constraints (limit ≤100 and ≤5000, gtin 14 digits, format json|csv or svg|png, cursor semantics, at-least-one-field rule for update). This fully compensates for the unannotated nested args object.

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?

Names the specific resource ("TracePass product catalogue") and a precise verb ("Manage"), then defines the concept: "one product can have many passports (one per serialised unit)" and "Products are not billable on their own." Enumerating the seven actions with their argument shapes lets an agent distinguish this from tracepass_passports and tracepass_passport_lifecycle without inspecting 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?

Routes the agent away where appropriate — archival lives in tracepass_passport_lifecycle — and gives a concrete use case for get_links ("for a dealer asking for passport links"). It also states the selection condition between create and create_batch (up to 100 items, partial success).

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.