Skip to main content
Glama

Johto Data US HTS Tariff Lookup | 美国海关税则查询

us_hts_tariff_lookup
Read-only

Find USITC HTS codes, general/special rates and footnotes. Chinese field labels. Not total China-origin duties or customs advice. Costs $0.002 USDC per call via x402. Without payment, the call returns the x402 payment requirements; retry with an X-PAYMENT or PAYMENT-SIGNATURE header, or params._meta["x402/payment"].

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": {
      "query": "<query>"
    },
    "name": "us_hts_tariff_lookup"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoMaximum records / 最大记录数
queryYesEnglish product/regulatory keyword or HTS code / 英文关键词

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered structurally. The description adds genuinely useful behavior not in annotations: the $0.002 USDC x402 cost, the unauthenticated first-call response, and the retry mechanism with specific header names or the params._meta payment path. It does not describe result shape or paging behavior, so it adds context but not full coverage.

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?

Four short sentences, front-loaded with what the tool returns and its exclusions before the payment mechanics. The 'Chinese field labels' fragment sits awkwardly mid-block and would read better next to the return-value sentence, but there is no filler.

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 no output schema, the description does duty on returns by naming the fields (codes, general/special rates, footnotes) and their language. It also covers the auth/payment prerequisite that would otherwise block a correct call. Minor gap: no indication of result ordering, truncation, or what an empty match looks like.

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%, and both parameters carry bilingual descriptions including the English-keyword-or-HTS-code constraint and the limit bounds. The description adds no syntax or format detail beyond that, so the baseline of 3 applies. The 'Chinese field labels' note concerns output, not parameter meaning.

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 and resource: 'Find USITC HTS codes, general/special rates and footnotes,' which is concrete and actionable. It implicitly separates itself from the china_us_duty_layers sibling with 'Not total China-origin duties,' though it never names that alternative outright.

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?

Provides an explicit exclusion ('Not total China-origin duties or customs advice') plus a concrete operational sequence for the payment flow: call, receive x402 requirements, retry with X-PAYMENT or PAYMENT-SIGNATURE header. It stops short of naming a sibling tool to use instead for full duty stacks or legal guidance.

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