Skip to main content
Glama

order_status

State of an order YOU paid (in the database and on chain: no deposit, in escrow, released, refunded, disputed), with the next step. Without orderId it lists your active ones; the ones your owner pays on the web are not listed here and you cannot move them. The purchase is your owner's: the download and the receipt are theirs, and the download is enabled as soon as the deposit is confirmed.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
txHashNoOptional: hash of your fundPurchase transaction, to verify it.
orderIdNoThe orderId (uuid) from prepare_payment. Without it, it lists your active orders.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
txNoOnly if you sent txHash: the verdict on that transaction. null if you did not send it.
noteNoOnly in the inventory: a text clarification of what the list contains.
amountNoOnly in the detail: the amount of the order in both units.
ordersNoOnly in the inventory (call WITHOUT orderId): your active orders, from the newest to the oldest (max. 20).
syncedNotrue if this call moved the state in the database to align it with the chain.
walletNoThe buyer wallet of the order.
anomalyNoOnly if the database and the chain cannot be reconciled; the team has already been notified.
orderIdNoOnly in the detail: the uuid of the order queried.
nextStepNoOnly in the detail: what to do now, in one sentence.
finalizedNoIs the deposit in finalized blocks? null if it could not be determined.
stateInDbNoState according to Bernuvia's database.
fundTxHashNoHash of the deposit transaction, or null if it is not on record (it can be null even when the order is funded).
purchaseIdNoOnly in the detail: the on-chain identifier (bytes32).
depositSeenNoDoes the chain already show the deposit? If true, do NOT deposit again.
onChainNoteNoOnly if the read was skipped: why, and when to come back.
templateSlugNoSlug of the template, or null if it no longer exists.
anomalyDetailNoOnly with `anomaly`: what the discrepancy consists of.
autoReleaseAtNoWhen the payment is released to the seller on expiry (ISO 8601), or null if there is no deposit yet.
onChainStatusNoState according to the contract, or null if the read was skipped or failed. "none" = no deposit.
fundTxHashNoteNoOnly when fundTxHash is null: how to record it by passing txHash.
onChainSkippedNotrue if the on-chain read was skipped for budget reasons: do not poll in a loop.
quoteExpiresAtNoExpiry of the quote (ISO 8601), or null if it has none.
downloadAvailableNoIs the download access already granted for this buyer?
suggestedPollSecondsNoHow many seconds to wait before polling again. 0 = there is nothing to wait for.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed54 schema fields changed
    • removedInput schema / properties / ordenId
      Removed value: -{
      -  "deprecated": true,
      -  "description": "DEPRECATED alias of `orderId`: it still works, but use `orderId` (it will be removed in a future round, no date yet). The ordenId (uuid) from prepare_payment. Without it, it lists your active orders.",
      -  "type": "string"
      -}
    • changedInput schema / properties / orderId / description
      Previous value: -"The ordenId (uuid) from prepare_payment. Without it, it lists your active orders."New value: +"The orderId (uuid) from prepare_payment. Without it, it lists your active orders."
    • removedInput schema / x-bernuvia-aliases
      Removed value: -{
      -  "orderId": "ordenId"
      -}
    • addedOutput schema / properties / amount
      Added value: +{
      +  "additionalProperties": true,
      +  "description": "Only in the detail: the amount of the order in both units.",
      +  "properties": {
      +    "units": {
      +      "description": "Minimal units of USDC, as a decimal string.",
      +      "type": "string"
      +    },
      +    "usdc": {
      +      "description": "The same amount in human USDC, as a decimal string.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "units",
      +    "usdc"
      +  ],
      +  "type": "object"
      +}
    • removedOutput schema / properties / anomalia
      Removed value: -{
      -  "description": "Only if the database and the chain cannot be reconciled; the team has already been notified.",
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / anomaliaDetalle
      Removed value: -{
      -  "description": "Only with `anomalia`: what the discrepancy consists of.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / anomaly
      Added value: +{
      +  "description": "Only if the database and the chain cannot be reconciled; the team has already been notified.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / anomalyDetail
      Added value: +{
      +  "description": "Only with `anomaly`: what the discrepancy consists of.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / autoLiberacionEn
      Removed value: -{
      -  "description": "When the payment is released to the seller on expiry (ISO 8601), or null if there is no deposit yet.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • addedOutput schema / properties / autoReleaseAt
      Added value: +{
      +  "description": "When the payment is released to the seller on expiry (ISO 8601), or null if there is no deposit yet.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / compraId
      Removed value: -{
      -  "description": "Only in the detail: the on-chain identifier (bytes32).",
      -  "type": "string"
      -}
    • removedOutput schema / properties / cotizacionCaducaEn
      Removed value: -{
      -  "description": "Expiry of the quote (ISO 8601), or null if it has none.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • addedOutput schema / properties / depositSeen
      Added value: +{
      +  "description": "Does the chain already show the deposit? If true, do NOT deposit again.",
      +  "type": "boolean"
      +}
    • removedOutput schema / properties / depositoVisto
      Removed value: -{
      -  "description": "Does the chain already show the deposit? If true, do NOT deposit again.",
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / descargaDisponible
      Removed value: -{
      -  "description": "Is the download access already granted for this buyer?",
      -  "type": "boolean"
      -}
    • addedOutput schema / properties / downloadAvailable
      Added value: +{
      +  "description": "Is the download access already granted for this buyer?",
      +  "type": "boolean"
      +}
    • removedOutput schema / properties / estadoBd
      Removed value: -{
      -  "description": "State according to Bernuvia's database.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / estadoOnChain
      Removed value: -{
      -  "description": "State according to the contract, or null if the read was skipped or failed. \"none\" = no deposit.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / finalizado
      Removed value: -{
      -  "description": "Is the deposit in finalized blocks? null if it could not be determined.",
      -  "type": [
      -    "boolean",
      -    "null"
      -  ]
      -}
    • addedOutput schema / properties / finalized
      Added value: +{
      +  "description": "Is the deposit in finalized blocks? null if it could not be determined.",
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / fundTxHashNote
      Added value: +{
      +  "description": "Only when fundTxHash is null: how to record it by passing txHash.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / importe
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "Only in the detail: the amount of the order in both units.",
      -  "properties": {
      -    "unidades": {
      -      "description": "Minimal units of USDC, as a decimal string.",
      -      "type": "string"
      -    },
      -    "usdc": {
      -      "description": "The same amount in human USDC, as a decimal string.",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "unidades",
      -    "usdc"
      -  ],
      -  "type": "object"
      -}
    • addedOutput schema / properties / nextStep
      Added value: +{
      +  "description": "Only in the detail: what to do now, in one sentence.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / nota
      Removed value: -{
      -  "description": "Only in the inventory: a text clarification of what the list contains.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / notaFundTxHash
      Removed value: -{
      -  "description": "Only when fundTxHash is null: how to record it by passing txHash.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / notaOnChain
      Removed value: -{
      -  "description": "Only if the read was skipped: why, and when to come back.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / note
      Added value: +{
      +  "description": "Only in the inventory: a text clarification of what the list contains.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / onChainNote
      Added value: +{
      +  "description": "Only if the read was skipped: why, and when to come back.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / onChainOmitido
      Removed value: -{
      -  "description": "true if the on-chain read was skipped for budget reasons: do not poll in a loop.",
      -  "type": "boolean"
      -}
    • addedOutput schema / properties / onChainSkipped
      Added value: +{
      +  "description": "true if the on-chain read was skipped for budget reasons: do not poll in a loop.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / onChainStatus
      Added value: +{
      +  "description": "State according to the contract, or null if the read was skipped or failed. \"none\" = no deposit.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / ordenId
      Removed value: -{
      -  "description": "Only in the detail: the uuid of the order queried.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / ordenes
      Removed value: -{
      -  "description": "Only in the inventory (call WITHOUT ordenId): your active orders, from the newest to the oldest (max. 20).",
      -  "items": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "compraId": {
      -        "description": "The on-chain identifier (bytes32) of the purchase.",
      -        "type": "string"
      -      },
      -      "cotizacionCaducaEn": {
      -        "description": "Expiry of its quote (ISO 8601), or null if it has none.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "creadaEn": {
      -        "description": "When the order was created (ISO 8601).",
      -        "type": "string"
      -      },
      -      "estado": {
      -        "description": "State in the database: created, quoted, funded, delivered or disputed.",
      -        "type": "string"
      -      },
      -      "importeUsdc": {
      -        "description": "Amount in human USDC, as a decimal string.",
      -        "type": "string"
      -      },
      -      "ordenId": {
      -        "description": "The uuid of the order: the one you pass to the other tools.",
      -        "type": "string"
      -      },
      -      "plantillaSlug": {
      -        "description": "Slug of the purchased template, or null if it no longer exists.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "ordenId",
      -      "compraId",
      -      "plantillaSlug",
      -      "estado",
      -      "importeUsdc",
      -      "creadaEn",
      -      "cotizacionCaducaEn"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • addedOutput schema / properties / orderId
      Added value: +{
      +  "description": "Only in the detail: the uuid of the order queried.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / orders
      Added value: +{
      +  "description": "Only in the inventory (call WITHOUT orderId): your active orders, from the newest to the oldest (max. 20).",
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "amountUsdc": {
      +        "description": "Amount in human USDC, as a decimal string.",
      +        "type": "string"
      +      },
      +      "createdAt": {
      +        "description": "When the order was created (ISO 8601).",
      +        "type": "string"
      +      },
      +      "orderId": {
      +        "description": "The uuid of the order: the one you pass to the other tools.",
      +        "type": "string"
      +      },
      +      "purchaseId": {
      +        "description": "The on-chain identifier (bytes32) of the purchase.",
      +        "type": "string"
      +      },
      +      "quoteExpiresAt": {
      +        "description": "Expiry of its quote (ISO 8601), or null if it has none.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "status": {
      +        "description": "State in the database: created, quoted, funded, delivered or disputed.",
      +        "type": "string"
      +      },
      +      "templateSlug": {
      +        "description": "Slug of the purchased template, or null if it no longer exists.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "orderId",
      +      "purchaseId",
      +      "templateSlug",
      +      "status",
      +      "amountUsdc",
      +      "createdAt",
      +      "quoteExpiresAt"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / plantillaSlug
      Removed value: -{
      -  "description": "Slug of the template, or null if it no longer exists.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • addedOutput schema / properties / purchaseId
      Added value: +{
      +  "description": "Only in the detail: the on-chain identifier (bytes32).",
      +  "type": "string"
      +}
    • addedOutput schema / properties / quoteExpiresAt
      Added value: +{
      +  "description": "Expiry of the quote (ISO 8601), or null if it has none.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / siguientePaso
      Removed value: -{
      -  "description": "Only in the detail: what to do now, in one sentence.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / sincronizado
      Removed value: -{
      -  "description": "true if this call moved the state in the database to align it with the chain.",
      -  "type": "boolean"
      -}
    • addedOutput schema / properties / stateInDb
      Added value: +{
      +  "description": "State according to Bernuvia's database.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / sugerenciaSondeoSegundos
      Removed value: -{
      -  "description": "How many seconds to wait before polling again. 0 = there is nothing to wait for.",
      -  "type": "number"
      -}
    • addedOutput schema / properties / suggestedPollSeconds
      Added value: +{
      +  "description": "How many seconds to wait before polling again. 0 = there is nothing to wait for.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / synced
      Added value: +{
      +  "description": "true if this call moved the state in the database to align it with the chain.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / templateSlug
      Added value: +{
      +  "description": "Slug of the template, or null if it no longer exists.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / tx / properties / correspondeAOrden
      Removed value: -{
      -  "description": "Was it sent by your wallet against the escrow contract? null if it could not be checked.",
      -  "type": [
      -    "boolean",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / tx / properties / fondeaEstaOrden
      Removed value: -{
      -  "description": "Is its Funded event the one of THIS order? null if it could not be checked.",
      -  "type": [
      -    "boolean",
      -    "null"
      -  ]
      -}
    • addedOutput schema / properties / tx / properties / fundsThisOrder
      Added value: +{
      +  "description": "Is its Funded event the one of THIS order? null if it could not be checked.",
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / tx / properties / matchesOrder
      Added value: +{
      +  "description": "Was it sent by your wallet against the escrow contract? null if it could not be checked.",
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / tx / properties / nota
      Removed value: -{
      -  "description": "What the result means and what to do.",
      -  "type": "string"
      -}
    • addedOutput schema / properties / tx / properties / note
      Added value: +{
      +  "description": "What the result means and what to do.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / tx / properties / result
      Added value: +{
      +  "description": "success, reverted, pending, absent, unknown, \"mismatch\" (not yours against the escrow) or \"deferred\" (deferred for budget reasons).",
      +  "type": "string"
      +}
    • removedOutput schema / properties / tx / properties / resultado
      Removed value: -{
      -  "description": "success, reverted, pending, absent, unknown, \"no-corresponde\" (not yours against the escrow) or \"omitida\" (deferred for budget reasons).",
      -  "type": "string"
      -}
    • changedOutput schema / properties / tx / required
      Previous value: -[
      -  "hash",
      -  "resultado"
      -]New value: +[
      +  "hash",
      +  "result"
      +]
  2. Changed41 schema fields changed
    • changedInput schema / properties / ordenId / description
      Previous value: -"ALIAS RETIRADO de `orderId`: sigue funcionando, pero usa `orderId` (se quitará en una tanda futura, aún sin fecha). / DEPRECATED alias of `orderId`. El ordenId (uuid) de prepare_payment. Sin él, lista tus órdenes activas."New value: +"DEPRECATED alias of `orderId`: it still works, but use `orderId` (it will be removed in a future round, no date yet). The ordenId (uuid) from prepare_payment. Without it, it lists your active orders."
    • changedInput schema / properties / orderId / description
      Previous value: -"El ordenId (uuid) de prepare_payment. Sin él, lista tus órdenes activas."New value: +"The ordenId (uuid) from prepare_payment. Without it, it lists your active orders."
    • changedInput schema / properties / txHash / description
      Previous value: -"Opcional: hash de tu transacción fundPurchase para verificarla."New value: +"Optional: hash of your fundPurchase transaction, to verify it."
    • changedOutput schema / properties / anomalia / description
      Previous value: -"Solo si base y cadena no se pueden reconciliar; el equipo ya fue avisado."New value: +"Only if the database and the chain cannot be reconciled; the team has already been notified."
    • changedOutput schema / properties / anomaliaDetalle / description
      Previous value: -"Solo con `anomalia`: en qué consiste la discrepancia."New value: +"Only with `anomalia`: what the discrepancy consists of."
    • changedOutput schema / properties / autoLiberacionEn / description
      Previous value: -"Cuándo se libera el pago al vendedor por vencimiento (ISO 8601), o null si aún no hay depósito."New value: +"When the payment is released to the seller on expiry (ISO 8601), or null if there is no deposit yet."
    • changedOutput schema / properties / compraId / description
      Previous value: -"Solo en el detalle: el identificador on-chain (bytes32)."New value: +"Only in the detail: the on-chain identifier (bytes32)."
    • changedOutput schema / properties / cotizacionCaducaEn / description
      Previous value: -"Vencimiento de la cotización (ISO 8601), o null si no tiene."New value: +"Expiry of the quote (ISO 8601), or null if it has none."
    • changedOutput schema / properties / depositoVisto / description
      Previous value: -"¿La cadena ya muestra el depósito? Si es true, NO vuelvas a depositar."New value: +"Does the chain already show the deposit? If true, do NOT deposit again."
    • changedOutput schema / properties / descargaDisponible / description
      Previous value: -"¿El acceso de descarga ya está concedido para este comprador?"New value: +"Is the download access already granted for this buyer?"
    • changedOutput schema / properties / estadoBd / description
      Previous value: -"Estado según la base de datos de Bernuvia."New value: +"State according to Bernuvia's database."
    • changedOutput schema / properties / estadoOnChain / description
      Previous value: -"Estado según el contrato, o null si la lectura se omitió o falló. \"none\" = sin depósito."New value: +"State according to the contract, or null if the read was skipped or failed. \"none\" = no deposit."
    • changedOutput schema / properties / finalizado / description
      Previous value: -"¿El depósito está en bloques finalizados? null si no se pudo determinar."New value: +"Is the deposit in finalized blocks? null if it could not be determined."
    • changedOutput schema / properties / fundTxHash / description
      Previous value: -"Hash de la transacción de depósito, o null si no consta (puede ser null aunque esté fondeada)."New value: +"Hash of the deposit transaction, or null if it is not on record (it can be null even when the order is funded)."
    • changedOutput schema / properties / importe / description
      Previous value: -"Solo en el detalle: el importe de la orden en las dos unidades."New value: +"Only in the detail: the amount of the order in both units."
    • changedOutput schema / properties / importe / properties / unidades / description
      Previous value: -"Unidades mínimas de USDC, como cadena decimal."New value: +"Minimal units of USDC, as a decimal string."
    • changedOutput schema / properties / importe / properties / usdc / description
      Previous value: -"El mismo importe en USDC humano, como cadena decimal."New value: +"The same amount in human USDC, as a decimal string."
    • changedOutput schema / properties / nota / description
      Previous value: -"Solo en el inventario: aclaración en texto de qué contiene la lista."New value: +"Only in the inventory: a text clarification of what the list contains."
    • changedOutput schema / properties / notaFundTxHash / description
      Previous value: -"Solo cuando fundTxHash es null: cómo registrarlo pasando txHash."New value: +"Only when fundTxHash is null: how to record it by passing txHash."
    • changedOutput schema / properties / notaOnChain / description
      Previous value: -"Solo si se omitió la lectura: por qué y cuándo volver."New value: +"Only if the read was skipped: why, and when to come back."
    • changedOutput schema / properties / onChainOmitido / description
      Previous value: -"true si la lectura on-chain se saltó por presupuesto: no sondees en bucle."New value: +"true if the on-chain read was skipped for budget reasons: do not poll in a loop."
    • changedOutput schema / properties / ordenId / description
      Previous value: -"Solo en el detalle: el uuid de la orden consultada."New value: +"Only in the detail: the uuid of the order queried."
    • changedOutput schema / properties / ordenes / description
      Previous value: -"Solo en el inventario (llamada SIN ordenId): tus órdenes activas, de la más nueva a la más vieja (máx. 20)."New value: +"Only in the inventory (call WITHOUT ordenId): your active orders, from the newest to the oldest (max. 20)."
    • changedOutput schema / properties / ordenes / items / properties / compraId / description
      Previous value: -"El identificador on-chain (bytes32) de la compra."New value: +"The on-chain identifier (bytes32) of the purchase."
    • changedOutput schema / properties / ordenes / items / properties / cotizacionCaducaEn / description
      Previous value: -"Vencimiento de su cotización (ISO 8601), o null si no tiene."New value: +"Expiry of its quote (ISO 8601), or null if it has none."
    • changedOutput schema / properties / ordenes / items / properties / creadaEn / description
      Previous value: -"Cuándo se creó la orden (ISO 8601)."New value: +"When the order was created (ISO 8601)."
    • changedOutput schema / properties / ordenes / items / properties / estado / description
      Previous value: -"Estado en la base: created, quoted, funded, delivered o disputed."New value: +"State in the database: created, quoted, funded, delivered or disputed."
    • changedOutput schema / properties / ordenes / items / properties / importeUsdc / description
      Previous value: -"Importe en USDC humano, como cadena decimal."New value: +"Amount in human USDC, as a decimal string."
    • changedOutput schema / properties / ordenes / items / properties / ordenId / description
      Previous value: -"El uuid de la orden: el que se pasa a las demás herramientas."New value: +"The uuid of the order: the one you pass to the other tools."
    • changedOutput schema / properties / ordenes / items / properties / plantillaSlug / description
      Previous value: -"Slug de la plantilla comprada, o null si ya no existe."New value: +"Slug of the purchased template, or null if it no longer exists."
    • changedOutput schema / properties / plantillaSlug / description
      Previous value: -"Slug de la plantilla, o null si ya no existe."New value: +"Slug of the template, or null if it no longer exists."
    • changedOutput schema / properties / siguientePaso / description
      Previous value: -"Solo en el detalle: qué hacer ahora, en una frase."New value: +"Only in the detail: what to do now, in one sentence."
    • changedOutput schema / properties / sincronizado / description
      Previous value: -"true si esta llamada movió el estado de la base para alinearlo con la cadena."New value: +"true if this call moved the state in the database to align it with the chain."
    • changedOutput schema / properties / sugerenciaSondeoSegundos / description
      Previous value: -"Cada cuántos segundos volver a sondear. 0 = no hay nada que esperar."New value: +"How many seconds to wait before polling again. 0 = there is nothing to wait for."
    • changedOutput schema / properties / tx / description
      Previous value: -"Solo si mandaste txHash: el veredicto sobre esa transacción. null si no lo mandaste."New value: +"Only if you sent txHash: the verdict on that transaction. null if you did not send it."
    • changedOutput schema / properties / tx / properties / correspondeAOrden / description
      Previous value: -"¿La envió tu wallet contra el contrato de custodia? null si no se pudo comprobar."New value: +"Was it sent by your wallet against the escrow contract? null if it could not be checked."
    • changedOutput schema / properties / tx / properties / fondeaEstaOrden / description
      Previous value: -"¿Su evento Funded es el de ESTA orden? null si no se pudo comprobar."New value: +"Is its Funded event the one of THIS order? null if it could not be checked."
    • changedOutput schema / properties / tx / properties / hash / description
      Previous value: -"El txHash consultado."New value: +"The txHash that was checked."
    • changedOutput schema / properties / tx / properties / nota / description
      Previous value: -"Qué significa el resultado y qué hacer."New value: +"What the result means and what to do."
    • changedOutput schema / properties / tx / properties / resultado / description
      Previous value: -"success, reverted, pending, absent, unknown, \"no-corresponde\" (no es tuya contra el escrow) u \"omitida\" (diferida por presupuesto)."New value: +"success, reverted, pending, absent, unknown, \"no-corresponde\" (not yours against the escrow) or \"omitida\" (deferred for budget reasons)."
    • changedOutput schema / properties / wallet / description
      Previous value: -"La wallet compradora de la orden."New value: +"The buyer wallet of the order."
  3. First observed

TDQS

A3.9/5.0
Behavior4/5

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

With no annotations, the description carries the burden and does disclose meaningful traits: it surfaces both database and on-chain state, states that owner-paid orders are excluded and immovable, and notes download is enabled once the deposit is confirmed. Auth/rate-limit behavior and the exact 'next step' semantics remain implicit, preventing a 5.

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 resource and its states, then parameter behavior, then ownership caveats. Dense but each sentence carries distinct information; only the ownership/download clause is slightly extended.

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

Completeness4/5

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

With an output schema present, return values need no explanation, and the description adds the scoping and ownership constraints an agent needs. It is complete for this read tool, with only auth/permission details left unstated.

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

Parameters3/5

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

Schema coverage is 100%, so the schema already documents both txHash and orderId. The description restates the orderId no-argument behavior ('Without orderId it lists your active ones'), which adds little beyond the schema entry, so the baseline of 3 applies.

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?

States a specific verb+resource ('State of an order YOU paid') and enumerates the possible states (no deposit, in escrow, released, refunded, disputed), which lets an agent distinguish it from dispute_status and my_purchases. It does not name a sibling explicitly, keeping it just below the top tier.

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?

Explains the calling modes: with orderId to inspect one order, without it to list active ones, and it clearly excludes owner-paid web orders and notes the agent 'cannot move them.' This gives clear context for when each mode applies, though it does not route to an alternative tool by name.

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.

Resources