Skip to main content
Glama

Duties, taxes and NTMs

exim__trade__lookup
Read-onlyIdempotent

Searches duties, taxes, trade remedies and non-tariff measures for an exporter, importer and product or HS code. Use it for the full regulatory picture of a corridor.

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": {
      "exporterCountry": "<exporterCountry>",
      "importerCountry": "<importerCountry>"
    },
    "name": "exim__trade__lookup"
  }
}

Input Schema

NameRequiredDescriptionDefault
asOfNoDuty effective on YYYY-MM-DD; omitted means today in UTC
typeNoFilter to one data type
limitNoMax results (1-50, default 10)
hsCodeNoHS code (2-10 digits, no separators)
productNoProduct keyword (resolves to HS codes)
webFallbackNoAllow additional verified tariff evidence when no indexed row is present; unverified search summaries never establish a duty rate.
exporterCountryYesExporting country: name, ISO2 or ISO3 (e.g. Viet Nam, VN, VNM).
importerCountryYesImporting country: name, ISO2 or ISO3 (e.g. Germany, DE, DEU).

Output Schema

NameRequiredDescriptionDefault
dataYes
statsNo
_debugNo
summaryYes
warningsNo
nextActionsYes
correlationIdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedOutput schema / properties / data / properties / context / anyOf
      Added value: +[
      +  {
      +    "type": [
      +      "null",
      +      "boolean",
      +      "number",
      +      "string",
      +      "array",
      +      "object"
      +    ]
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "referenced": {
      +        "type": "boolean"
      +      },
      +      "rowCount": {
      +        "type": "integer"
      +      },
      +      "url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "referenced",
      +      "rowCount",
      +      "url"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties / data / properties / context / type
      Removed value: -[
      -  "null",
      -  "boolean",
      -  "number",
      -  "string",
      -  "array",
      -  "object"
      -]
    • changedOutput schema / properties / data / properties / items / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "$ref": "#/$defs/value0"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "anyOf": [
      +        {
      +          "$ref": "#/$defs/value0"
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "exportUrl": {
      +              "type": "string"
      +            },
      +            "payloadBytes": {
      +              "type": "integer"
      +            },
      +            "rowCount": {
      +              "type": "integer"
      +            },
      +            "token": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "exportUrl",
      +            "payloadBytes",
      +            "rowCount",
      +            "token",
      +            "url"
      +          ],
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Changed5 schema fields changed
    • removedInput schema / properties / exporter
      Removed value: -{
      -  "description": "Sending country — accepts country name, ISO2, ISO3 (e.g. \"Viet Nam\", \"VN\", \"VNM\")",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / exporterCountry
      Added value: +{
      +  "description": "Exporting country: name, ISO2 or ISO3 (e.g. Viet Nam, VN, VNM).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • removedInput schema / properties / importer
      Removed value: -{
      -  "description": "Receiving country — accepts country name, ISO2, ISO3 (e.g. \"Germany\", \"DE\", \"DEU\")",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / importerCountry
      Added value: +{
      +  "description": "Importing country: name, ISO2 or ISO3 (e.g. Germany, DE, DEU).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "exporter",
      -  "importer"
      -]New value: +[
      +  "exporterCountry",
      +  "importerCountry"
      +]
  3. Changed5 schema fields changed
    • addedInput schema / properties / exporter
      Added value: +{
      +  "description": "Sending country — accepts country name, ISO2, ISO3 (e.g. \"Viet Nam\", \"VN\", \"VNM\")",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • removedInput schema / properties / exporterCountry
      Removed value: -{
      -  "description": "Exporting country: name, ISO2 or ISO3 (e.g. Viet Nam, VN, VNM).",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / importer
      Added value: +{
      +  "description": "Receiving country — accepts country name, ISO2, ISO3 (e.g. \"Germany\", \"DE\", \"DEU\")",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • removedInput schema / properties / importerCountry
      Removed value: -{
      -  "description": "Importing country: name, ISO2 or ISO3 (e.g. Germany, DE, DEU).",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • changedInput schema / required
      Previous value: -[
      -  "exporterCountry",
      -  "importerCountry"
      -]New value: +[
      +  "exporter",
      +  "importer"
      +]
  4. Changed5 schema fields changed
    • removedInput schema / properties / exporter
      Removed value: -{
      -  "description": "Sending country — accepts country name, ISO2, ISO3 (e.g. \"Viet Nam\", \"VN\", \"VNM\")",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / exporterCountry
      Added value: +{
      +  "description": "Exporting country: name, ISO2 or ISO3 (e.g. Viet Nam, VN, VNM).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • removedInput schema / properties / importer
      Removed value: -{
      -  "description": "Receiving country — accepts country name, ISO2, ISO3 (e.g. \"Germany\", \"DE\", \"DEU\")",
      -  "maxLength": 8000,
      -  "type": "string"
      -}
    • addedInput schema / properties / importerCountry
      Added value: +{
      +  "description": "Importing country: name, ISO2 or ISO3 (e.g. Germany, DE, DEU).",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "exporter",
      -  "importer"
      -]New value: +[
      +  "exporterCountry",
      +  "importerCountry"
      +]
  5. Changed18 schema fields changed
    • addedInput schema / not
      Added value: +{
      +  "anyOf": [
      +    {
      +      "not": {
      +        "not": {
      +          "properties": {
      +            "hsCode": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "product": {
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hsCode",
      +            "product"
      +          ]
      +        }
      +      }
      +    }
      +  ]
      +}
    • removedInput schema / properties / --exporter
      Removed value: -{
      -  "description": "Sending country — accepts country name, ISO2, ISO3 (e.g. \"Viet Nam\", \"VN\", \"VNM\")",
      -  "type": "string"
      -}
    • removedInput schema / properties / --hsCode
      Removed value: -{
      -  "description": "HS code (2-10 digits, no separators)",
      -  "pattern": "^[0-9]*[1-9][0-9]*$",
      -  "type": "string"
      -}
    • removedInput schema / properties / --importer
      Removed value: -{
      -  "description": "Receiving country — accepts country name, ISO2, ISO3 (e.g. \"Germany\", \"DE\", \"DEU\")",
      -  "type": "string"
      -}
    • removedInput schema / properties / --limit
      Removed value: -{
      -  "description": "Max results (1-50, default 10)",
      -  "type": "integer"
      -}
    • removedInput schema / properties / --product
      Removed value: -{
      -  "description": "Product keyword (resolves to HS codes)",
      -  "type": "string"
      -}
    • removedInput schema / properties / --type
      Removed value: -{
      -  "description": "Filter to one data type",
      -  "enum": [
      -    "all",
      -    "duties",
      -    "taxes",
      -    "remedies",
      -    "ntm"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / --webFallback
      Removed value: -{
      -  "description": "Summarise a web search when the trade dataset has no row (default true); set false to get only dataset rows. Public credentials never use the web fallback.",
      -  "type": "boolean"
      -}
    • addedInput schema / properties / asOf
      Added value: +{
      +  "description": "Duty effective on YYYY-MM-DD; omitted means today in UTC",
      +  "format": "date",
      +  "maxLength": 8000,
      +  "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$",
      +  "type": "string"
      +}
    • addedInput schema / properties / exporter
      Added value: +{
      +  "description": "Sending country — accepts country name, ISO2, ISO3 (e.g. \"Viet Nam\", \"VN\", \"VNM\")",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / hsCode
      Added value: +{
      +  "description": "HS code (2-10 digits, no separators)",
      +  "maxLength": 10,
      +  "minLength": 2,
      +  "pattern": "^[0-9]*[1-9][0-9]*$",
      +  "type": "string"
      +}
    • addedInput schema / properties / importer
      Added value: +{
      +  "description": "Receiving country — accepts country name, ISO2, ISO3 (e.g. \"Germany\", \"DE\", \"DEU\")",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "Max results (1-50, default 10)",
      +  "maximum": 50,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / product
      Added value: +{
      +  "description": "Product keyword (resolves to HS codes)",
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / type
      Added value: +{
      +  "description": "Filter to one data type",
      +  "enum": [
      +    "all",
      +    "duties",
      +    "taxes",
      +    "remedies",
      +    "ntm"
      +  ],
      +  "maxLength": 8000,
      +  "type": "string"
      +}
    • addedInput schema / properties / webFallback
      Added value: +{
      +  "description": "Allow additional verified tariff evidence when no indexed row is present; unverified search summaries never establish a duty rate.",
      +  "format": "boolean",
      +  "type": "boolean"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "--exporter",
      -  "--importer"
      -]New value: +[
      +  "exporter",
      +  "importer"
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "value0": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "applied_tariff": {
      +          "type": "string"
      +        },
      +        "ave_tariff": {
      +          "type": "string"
      +        },
      +        "custom_duties": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "exporter": {
      +          "type": "string"
      +        },
      +        "exporter_iso2": {
      +          "type": "string"
      +        },
      +        "exporter_iso3": {
      +          "type": "string"
      +        },
      +        "has_taxes": {
      +          "type": "boolean"
      +        },
      +        "importer": {
      +          "type": "string"
      +        },
      +        "importer_iso2": {
      +          "type": "string"
      +        },
      +        "importer_iso3": {
      +          "type": "string"
      +        },
      +        "ntm_measure_count": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "ntm_measure_titles": {
      +          "$ref": "#/$defs/value1"
      +        },
      +        "ntm_measures": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "observation": {
      +          "anyOf": [
      +            {
      +              "$ref": "#/$defs/value2"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "product_code": {
      +          "type": "string"
      +        },
      +        "product_description": {
      +          "type": "string"
      +        },
      +        "summary": {
      +          "type": "string"
      +        },
      +        "tariff_regime": {
      +          "type": "string"
      +        },
      +        "taxes": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "trade_remedies": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "trade_remedy_types": {
      +          "$ref": "#/$defs/value3"
      +        },
      +        "year": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "exporter",
      +        "has_taxes",
      +        "importer",
      +        "product_code",
      +        "product_description",
      +        "year"
      +      ],
      +      "type": "object"
      +    },
      +    "value1": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value10": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {
      +            "type": [
      +              "null",
      +              "boolean",
      +              "number",
      +              "string",
      +              "array",
      +              "object"
      +            ]
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value2": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "basis": {
      +          "type": "string"
      +        },
      +        "code": {
      +          "type": "string"
      +        },
      +        "effectiveFrom": {
      +          "type": "string"
      +        },
      +        "effectiveTo": {
      +          "type": "string"
      +        },
      +        "exporter": {
      +          "type": "string"
      +        },
      +        "importer": {
      +          "type": "string"
      +        },
      +        "observedAt": {
      +          "type": "string"
      +        },
      +        "rate": {
      +          "type": "string"
      +        },
      +        "sourceUrl": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "basis",
      +        "code",
      +        "effectiveFrom",
      +        "exporter",
      +        "importer",
      +        "observedAt",
      +        "rate",
      +        "sourceUrl"
      +      ],
      +      "type": "object"
      +    },
      +    "value3": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value4": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "type": [
      +              "null",
      +              "boolean",
      +              "number",
      +              "string",
      +              "array",
      +              "object"
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value5": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "$ref": "#/$defs/value6"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value6": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "command": {
      +          "type": "string"
      +        },
      +        "cost": {
      +          "type": "string"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "rationale": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "command",
      +        "cost",
      +        "label",
      +        "rationale"
      +      ],
      +      "type": "object"
      +    },
      +    "value7": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {
      +            "type": "number"
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value8": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "$ref": "#/$defs/value9"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "value9": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "code": {
      +          "type": "string"
      +        },
      +        "message": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "code",
      +        "message"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "additionalProperties": false,
      +  "properties": {
      +    "_debug": {
      +      "$ref": "#/$defs/value10"
      +    },
      +    "correlationId": {
      +      "type": "string"
      +    },
      +    "data": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "context": {
      +          "type": [
      +            "null",
      +            "boolean",
      +            "number",
      +            "string",
      +            "array",
      +            "object"
      +          ]
      +        },
      +        "cursor": {
      +          "type": "string"
      +        },
      +        "has_more": {
      +          "type": "boolean"
      +        },
      +        "items": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "$ref": "#/$defs/value0"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "context",
      +        "has_more",
      +        "items"
      +      ],
      +      "type": "object"
      +    },
      +    "nextActions": {
      +      "$ref": "#/$defs/value5"
      +    },
      +    "stats": {
      +      "$ref": "#/$defs/value7"
      +    },
      +    "summary": {
      +      "type": "string"
      +    },
      +    "warnings": {
      +      "$ref": "#/$defs/value8"
      +    }
      +  },
      +  "required": [
      +    "data",
      +    "nextActions",
      +    "summary"
      +  ],
      +  "type": "object"
      +}
  6. First observed

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds nothing about evidence provenance, coverage gaps, or the meaning of open-world fallback behavior — that nuance lives only in the webFallback parameter description, not in the tool description itself.

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?

Two sentences, front-loaded with the resource list before the usage hint, with no filler. The phrase "full regulatory picture of a corridor" leans on unexplained domain jargon that costs a little precision.

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 a rich output schema and 100% parameter documentation, the description only needs to establish what is retrieved and roughly when to reach for it, which it does. The one real gap is sibling disambiguation in a namespace crowded with duty, tariff and HS-code tools.

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 100%, so the schema already documents asOf, type, limit, hsCode, product, webFallback and the country fields in detail. The description only restates that a product OR HS code is accepted, which mildly clarifies the otherwise opaque anyOf/not constraint but adds no formatting or precedence guidance beyond the schema.

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 gives a specific verb ("searches") plus a concrete resource set (duties, taxes, trade remedies, non-tariff measures) and the scoping keys (exporter, importer, product or HS code). It does not distinguish this tool from close siblings such as exim__tariff, exim__duty__fta or exim__hscode__search, so an agent still has to guess which of the several duty-related tools is canonical.

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

Usage Guidelines3/5

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

"Use it for the full regulatory picture of a corridor" implies a broad-lookup use case but names no exclusions and no alternatives. Given siblings like exim__duty__fta (preferential rates) and exim__duty__exposure, an explicit routing rule (e.g. "use tariff/FTA tools for a single rate, this one for the aggregate picture") is missing.

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.