Agent Decision & Evidence Tools (MCP + x402)

US Import Readiness Guard

us_import_readiness_guard

Read-only

Signed pre-purchase evidence dossier for ordinary goods dispatched from Germany or Austria to the United States. Validates a buyer-declared HTS code or returns non-binding current USITC candidates, calculates only a simple ordinary-duty component, checks CPSC recall candidates and routes declared regulated attributes. Returns PROCEED_TO_CARRIER_QUOTE, REVIEW_REQUIRED or DO_NOT_FORWARD. It never fetches a product URL, orders, creates an address, books shipping or claims exact landed cost, carrier acceptance or customs clearance. Free input check first; source/input failures are not settled.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`gtin`	No	Optional GTIN/UPC/EAN
`brand`	No
`model`	No
`job_id`	Yes	Opaque job ID returned by the free prepare call
`hts_code`	No	Optional buyer-declared 6, 8 or 10 digit HTS code
`quantity`	Yes
`importer_use`	Yes
`intended_use`	Yes
`product_name`	Yes
`risk_answers`	Yes
`recovery_secret`	Yes	Secret returned by the free prepare call
`dispatch_country`	Yes
`country_of_origin`	Yes	Valid ISO-3166 manufacturing origin, not dispatch country
`customs_value_usd`	Yes
`destination_country`	No		US
`product_description`	Yes
`material_or_composition`	Yes
`merchant_forwarding_policy`	Yes

Output Schema

TableJSON Schema

Name	Required	Description
`tool`	No
`error`	No
`route`	No
`tariff`	No
`charged`	No	When present on an error, false means the failed result is uncharged.
`message`	No
`missing`	No
`pricing`	No
`privacy`	No
`product`	No
`recalls`	No
`receipt`	No
`settled`	No	When present on an error, false means no settlement occurred.
`unknown`	No
`accepted`	No
`contract`	No
`decision`	No
`validity`	No
`cost_view`	No
`retryable`	No
`error_code`	No
`extensions`	No
`forwarding`	No
`limitations`	No
`status_code`	No
`did_you_mean`	No
`entry_policy`	No
`next_actions`	No
`missing_checks`	No
`policy_version`	No
`partial_evidence`	No
`source_snapshots`	No
`input_fingerprint`	No
`regulatory_routing`	No
`ordinary_duty_component`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed50 schema fields changedSep 6, 2026

removedInput schema / $defs

Removed value: -{
-  "_USImportRiskAnswers": {
-    "additionalProperties": false,
-    "description": "Same nested, strict shape used by the public HTTP contract.",
-    "properties": {
-      "alcohol_or_tobacco": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Alcohol Or Tobacco",
-        "type": "string"
-      },
-      "battery": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Battery",
-        "type": "string"
-      },
-      "chemical_or_hazmat": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Chemical Or Hazmat",
-        "type": "string"
-      },
-      "childrens_product": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Childrens Product",
-        "type": "string"
-      },
-      "cosmetic": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Cosmetic",
-        "type": "string"
-      },
-      "counterfeit_or_unlicensed_replica": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Counterfeit Or Unlicensed Replica",
-        "type": "string"
-      },
-      "drug_or_medical_device": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Drug Or Medical Device",
-        "type": "string"
-      },
-      "food_or_supplement": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Food Or Supplement",
-        "type": "string"
-      },
-      "plant_seed_or_animal_product": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Plant Seed Or Animal Product",
-        "type": "string"
-      },
-      "radio_transmitter": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Radio Transmitter",
-        "type": "string"
-      },
-      "weapon_or_weapon_part": {
-        "enum": [
-          "yes",
-          "no",
-          "unknown"
-        ],
-        "title": "Weapon Or Weapon Part",
-        "type": "string"
-      }
-    },
-    "required": [
-      "battery",
-      "food_or_supplement",
-      "drug_or_medical_device",
-      "cosmetic",
-      "plant_seed_or_animal_product",
-      "chemical_or_hazmat",
-      "alcohol_or_tobacco",
-      "weapon_or_weapon_part",
-      "counterfeit_or_unlicensed_replica",
-      "radio_transmitter",
-      "childrens_product"
-    ],
-    "title": "_USImportRiskAnswers",
-    "type": "object"
-  }
-}

addedInput schema / additionalProperties
```
Added value: +false
```
addedInput schema / properties / brand / maxLength
```
Added value: +120
```
removedInput schema / properties / brand / title
```
Removed value: -"Brand"
```

addedInput schema / properties / country_of_origin / description

Added value: +"Valid ISO-3166 manufacturing origin, not dispatch country"

addedInput schema / properties / country_of_origin / pattern
```
Added value: +"^[A-Z]{2}$"
```
removedInput schema / properties / country_of_origin / title
```
Removed value: -"Country Of Origin"
```
addedInput schema / properties / customs_value_usd / pattern
```
Added value: +"^[0-9]+(?:\\.[0-9]{1,2})?$"
```
removedInput schema / properties / customs_value_usd / title
```
Removed value: -"Customs Value Usd"
```
addedInput schema / properties / destination_country / const
```
Added value: +"US"
```
removedInput schema / properties / destination_country / title
```
Removed value: -"Destination Country"
```
addedInput schema / properties / dispatch_country / enum
```
Added value: +[
+  "DE",
+  "AT"
+]
```
removedInput schema / properties / dispatch_country / title
```
Removed value: -"Dispatch Country"
```
addedInput schema / properties / gtin / description
```
Added value: +"Optional GTIN/UPC/EAN"
```
removedInput schema / properties / gtin / title
```
Removed value: -"Gtin"
```

addedInput schema / properties / hts_code / description

Added value: +"Optional buyer-declared 6, 8 or 10 digit HTS code"

removedInput schema / properties / hts_code / title
```
Removed value: -"Hts Code"
```

addedInput schema / properties / importer_use / enum

Added value: +[
+  "personal",
+  "commercial_resale",
+  "business_use",
+  "gift",
+  "sample"
+]

removedInput schema / properties / importer_use / title
```
Removed value: -"Importer Use"
```
addedInput schema / properties / intended_use / maxLength
```
Added value: +500
```
addedInput schema / properties / intended_use / minLength
```
Added value: +3
```
removedInput schema / properties / intended_use / title
```
Removed value: -"Intended Use"
```

addedInput schema / properties / job_id / description

Added value: +"Opaque job ID returned by the free prepare call"

addedInput schema / properties / job_id / pattern
```
Added value: +"^[A-Za-z0-9_-]{20,64}$"
```
removedInput schema / properties / job_id / title
```
Removed value: -"Job Id"
```
addedInput schema / properties / material_or_composition / maxLength
```
Added value: +1000
```
addedInput schema / properties / material_or_composition / minLength
```
Added value: +3
```
removedInput schema / properties / material_or_composition / title
```
Removed value: -"Material Or Composition"
```
addedInput schema / properties / merchant_forwarding_policy / enum
```
Added value: +[
+  "allowed",
+  "prohibited",
+  "unknown"
+]
```
removedInput schema / properties / merchant_forwarding_policy / title
```
Removed value: -"Merchant Forwarding Policy"
```
addedInput schema / properties / model / maxLength
```
Added value: +120
```
removedInput schema / properties / model / title
```
Removed value: -"Model"
```
addedInput schema / properties / product_description / maxLength
```
Added value: +2000
```
addedInput schema / properties / product_description / minLength
```
Added value: +20
```
removedInput schema / properties / product_description / title
```
Removed value: -"Product Description"
```
addedInput schema / properties / product_name / maxLength
```
Added value: +160
```
addedInput schema / properties / product_name / minLength
```
Added value: +3
```
removedInput schema / properties / product_name / title
```
Removed value: -"Product Name"
```
addedInput schema / properties / quantity / maximum
```
Added value: +10000
```
addedInput schema / properties / quantity / minimum
```
Added value: +1
```
removedInput schema / properties / quantity / title
```
Removed value: -"Quantity"
```
addedInput schema / properties / recovery_secret / description
```
Added value: +"Secret returned by the free prepare call"
```
removedInput schema / properties / recovery_secret / title
```
Removed value: -"Recovery Secret"
```
removedInput schema / properties / risk_answers / $ref
```
Removed value: -"#/$defs/_USImportRiskAnswers"
```
addedInput schema / properties / risk_answers / additionalProperties
```
Added value: +false
```

addedInput schema / properties / risk_answers / properties

Added value: +{
+  "alcohol_or_tobacco": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "battery": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "chemical_or_hazmat": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "childrens_product": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "cosmetic": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "counterfeit_or_unlicensed_replica": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "drug_or_medical_device": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "food_or_supplement": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "plant_seed_or_animal_product": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "radio_transmitter": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  },
+  "weapon_or_weapon_part": {
+    "enum": [
+      "yes",
+      "no",
+      "unknown"
+    ],
+    "type": "string"
+  }
+}

addedInput schema / properties / risk_answers / required

Added value: +[
+  "battery",
+  "food_or_supplement",
+  "drug_or_medical_device",
+  "cosmetic",
+  "plant_seed_or_animal_product",
+  "chemical_or_hazmat",
+  "alcohol_or_tobacco",
+  "weapon_or_weapon_part",
+  "counterfeit_or_unlicensed_replica",
+  "radio_transmitter",
+  "childrens_product"
+]

addedInput schema / properties / risk_answers / type
```
Added value: +"object"
```

removedInput schema / title

Removed value: -"us_import_readiness_guard_toolArguments"

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "anyOf": [
+    {
+      "required": [
+        "contract",
+        "policy_version",
+        "decision",
+        "input_fingerprint",
+        "route",
+        "product",
+        "tariff",
+        "ordinary_duty_component",
+        "entry_policy",
+        "recalls",
+        "regulatory_routing",
+        "forwarding",
+        "cost_view",
+        "source_snapshots",
+        "next_actions",
+        "validity",
+        "limitations",
+        "pricing",
+        "privacy",
+        "receipt",
+        "extensions"
+      ]
+    },
+    {
+      "required": [
+        "error"
+      ]
+    }
+  ],
+  "description": "Structured result contract for us_import_readiness_guard. A success satisfies the documented success branch. A domain or tool error includes error and is not a successful settlement; unpaid x402 requirements are carried by the transport wrapper.",
+  "properties": {
+    "accepted": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "charged": {
+      "description": "When present on an error, false means the failed result is uncharged.",
+      "type": "boolean"
+    },
+    "contract": {
+      "type": "string"
+    },
+    "cost_view": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "decision": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "did_you_mean": {
+      "additionalProperties": true,
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "entry_policy": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "error": {
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "additionalProperties": true,
+          "properties": {
+            "code": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "message": {
+              "type": "string"
+            },
+            "param": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "message"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "error_code": {
+      "type": "string"
+    },
+    "extensions": {
+      "additionalProperties": true,
+      "properties": {
+        "delivery-receipt": {
+          "additionalProperties": true,
+          "properties": {
+            "how_to_verify": {
+              "type": "string"
+            },
+            "issued_at": {
+              "format": "date-time",
+              "type": "string"
+            },
+            "issuer": {
+              "type": "string"
+            },
+            "issuer_key": {
+              "type": "string"
+            },
+            "key_id": {
+              "type": "string"
+            },
+            "result_hash": {
+              "type": "string"
+            },
+            "service": {
+              "type": "string"
+            },
+            "signature": {
+              "type": "string"
+            },
+            "signed_message": {
+              "type": "string"
+            },
+            "standard": {
+              "const": "eucompliance-receipt/2",
+              "type": "string"
+            },
+            "subject": {
+              "type": "string"
+            },
+            "valid_until": {
+              "format": "date-time",
+              "type": "string"
+            },
+            "verify_url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "standard",
+            "service",
+            "subject",
+            "result_hash",
+            "issued_at",
+            "valid_until",
+            "issuer",
+            "issuer_key",
+            "key_id",
+            "verify_url",
+            "how_to_verify",
+            "signature",
+            "signed_message"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "delivery-receipt"
+      ],
+      "type": "object"
+    },
+    "forwarding": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "input_fingerprint": {
+      "type": "string"
+    },
+    "limitations": {
+      "items": {},
+      "type": "array"
+    },
+    "message": {
+      "type": "string"
+    },
+    "missing": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "missing_checks": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "next_actions": {
+      "items": {},
+      "type": "array"
+    },
+    "ordinary_duty_component": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "partial_evidence": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "policy_version": {
+      "type": "string"
+    },
+    "pricing": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "privacy": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "product": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "recalls": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "receipt": {
+      "additionalProperties": true,
+      "properties": {
+        "how_to_verify": {
+          "type": "string"
+        },
+        "issued_at": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "issuer": {
+          "type": "string"
+        },
+        "issuer_key": {
+          "type": "string"
+        },
+        "key_id": {
+          "type": "string"
+        },
+        "result_hash": {
+          "type": "string"
+        },
+        "service": {
+          "type": "string"
+        },
+        "signature": {
+          "type": "string"
+        },
+        "signed_message": {
+          "type": "string"
+        },
+        "standard": {
+          "const": "eucompliance-receipt/2",
+          "type": "string"
+        },
+        "subject": {
+          "type": "string"
+        },
+        "valid_until": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "verify_url": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "standard",
+        "service",
+        "subject",
+        "result_hash",
+        "issued_at",
+        "valid_until",
+        "issuer",
+        "issuer_key",
+        "key_id",
+        "verify_url",
+        "how_to_verify",
+        "signature",
+        "signed_message"
+      ],
+      "type": "object"
+    },
+    "regulatory_routing": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "retryable": {
+      "type": "boolean"
+    },
+    "route": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "settled": {
+      "description": "When present on an error, false means no settlement occurred.",
+      "type": "boolean"
+    },
+    "source_snapshots": {
+      "items": {},
+      "type": "array"
+    },
+    "status_code": {
+      "type": "integer"
+    },
+    "tariff": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "tool": {
+      "type": "string"
+    },
+    "unknown": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "validity": {
+      "additionalProperties": true,
+      "type": "object"
+    }
+  },
+  "type": "object"
+}

AddedAug 22, 2026

TDQS

A4.4/5.0

Behavior5/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, so the safety profile is covered. The description adds substantial behavioral context: the HTS validation is non-binding, only a simple ordinary-duty component is calculated, CPSC candidates are checked rather than confirmed, and source/input failures are not settled. The explicit exclusions (no product URL fetch, no ordering, no address creation, no shipping booking) go beyond what annotations reveal and prevent misuse.

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?

Three dense sentences, each earning its place. The first establishes scope, the second describes the core computation and outputs, and the third explicitly bounds the tool's capabilities. Information is front-loaded and there is no filler or repetition of schema fields.

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?

For a complex 18-parameter tool with low schema coverage and an output schema, the description covers the essential workflow, scope, safety, and limitations well. It tells the agent what the tool produces, what inputs matter most, and what is explicitly out of scope. It is slightly incomplete because it never explicitly directs the agent to the prepare_us_import_readiness sibling for the free input check, despite implying that workflow.

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 description coverage is only 28%, so the description must compensate for many undocumented parameters. It does add meaning for key fields such as hts_code (buyer-declared, validated), risk_answers (declared regulated attributes routed), dispatch_country (DE/AT), and destination_country (US). However, it does not explain many other required parameters like product_description, material_or_composition, intended_use, customs_value_usd, quantity, importer_use, or merchant_forwarding_policy beyond what their names imply.

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 description clearly identifies a specific resource: a signed pre-purchase evidence dossier for US-bound ordinary goods from Germany or Austria. It enumerates concrete actions—validates HTS codes, returns USITC candidates, calculates ordinary duty, checks CPSC recalls, routes regulated attributes—and names the three decision outputs. The explicit 'never' list disambiguates it from purchasing, order, and shipping tools even without naming siblings.

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?

The description gives clear contextual boundaries: ordinary goods dispatched from DE/AT to US, buyer-declared HTS code, and what the tool does not cover such as exact landed cost, carrier acceptance, or customs clearance. It also instructs that a free input check should happen first. However, it does not explicitly state when to choose this tool over the related prepare_us_import_readiness or recover_us_import_readiness tools.

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

All Agent Decision & Evidence Tools (MCP + x402) tools Inspect

Try in Browser

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.