Skip to main content
Glama

TracePass EPCIS 2.0

tracepass_epcis

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.

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

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. Changed17 schema fields changed
    • removedInput schema / properties / action / description
      Removed value: -"EPCIS 2.0: export a passport's events (export | export_by_serial), capture new events, poll a capture job, or query events."
    • removedInput schema / properties / args / description
      Removed value: -"Arguments for the chosen action; required fields depend on `action`."
    • removedInput schema / properties / args / properties / events / description
      Removed value: -"EPCIS 2.0 event payload (an EPCISDocument or event list). Required for capture."
    • removedInput schema / properties / args / properties / gtin / description
      Removed value: -"GTIN disambiguator for export_by_serial when the serial isn't unique (else 409)."
    • removedInput schema / properties / args / properties / id / description
      Removed value: -"Passport id. Required for export."
    • removedInput schema / properties / args / properties / jobId / description
      Removed value: -"Capture job id to poll. Required for capture_job."
    • removedInput schema / properties / args / properties / params / description
      Removed value: -"EPCIS query parameters as key→value strings (query, optional)."
    • removedInput schema / properties / args / properties / serial / description
      Removed value: -"Your serial. Required for export_by_serial."
    • 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. 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"
      +]
  3. 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"
  4. Changed6 schema fields changed
    • addedInput schema / properties / action / description
      Added value: +"EPCIS 2.0: export a passport's events (export | export_by_serial), capture new events, poll a capture job, or query events."
    • removedInput schema / properties / args / additionalProperties
      Removed value: -{}
    • changedInput schema / properties / args / description
      Previous value: -"Action-specific arguments — see the description."New value: +"Arguments for the chosen action; required fields depend on `action`."
    • addedInput schema / properties / args / properties
      Added value: +{
      +  "events": {
      +    "description": "EPCIS 2.0 event payload (an EPCISDocument or event list). Required for capture."
      +  },
      +  "gtin": {
      +    "description": "GTIN disambiguator for export_by_serial when the serial isn't unique (else 409).",
      +    "type": "string"
      +  },
      +  "id": {
      +    "description": "Passport id. Required for export.",
      +    "type": "string"
      +  },
      +  "jobId": {
      +    "description": "Capture job id to poll. Required for capture_job.",
      +    "type": "string"
      +  },
      +  "params": {
      +    "additionalProperties": {
      +      "type": "string"
      +    },
      +    "description": "EPCIS query parameters as key→value strings (query, optional).",
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  },
      +  "serial": {
      +    "description": "Your serial. Required for export_by_serial.",
      +    "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"
      +}
  5. Changed1 schema field changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "export",
      -  "capture",
      -  "capture_job",
      -  "query"
      -]New value: +[
      +  "export",
      +  "export_by_serial",
      +  "capture",
      +  "capture_job",
      +  "query"
      +]
  6. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Beyond the annotations it discloses quota behavior (10 events/month on Free, overage or hard-block on capture), the 202 + captureJobId async pattern, which actions are read-only, and the 409 ambiguous-serial recovery path. This is exactly the operational context annotations cannot carry.

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

Conciseness5/5

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

Front-loaded with scope and plan constraints, then a tight action-per-bullet list where each line carries payload shape plus any return or error detail. No redundant or filler sentences.

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?

Covers the multi-action dispatcher, the nested args, write-vs-read semantics, and error handling; with an output schema present there is no need to describe response bodies beyond the noted 202/captureJobId. Nothing an agent needs to invoke it correctly 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 coverage is 0% and the args object is nested and undocumented, yet the description maps every argument to its action: id, serial(+gtin), events, jobId, and params with concrete EPCIS names (EQ_bizStep, GE_eventTime, MATCH_epc). It fully compensates for the schema gap.

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

Purpose4/5

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

The description names the resource precisely ('GS1 EPCIS 2.0 supply-chain events') and enumerates the five actions with their payloads, so an agent knows exactly what the tool operates on. It does not explicitly distinguish itself from siblings like tracepass_passports, relying on the EPCIS domain framing instead.

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

Usage Guidelines4/5

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

It gives concrete when-to-use signals: export vs export_by_serial selection, the instruction to pass `gtin` when a 409 ambiguous_serial occurs, polling capture jobs via capture_job, and plan/allowance constraints. It lacks explicit exclusions versus sibling tools, but the action-level routing is clear.

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.