Skip to main content
Glama

usitc-tariffs-mcp-server

Look up published base duty columns

usitc_lookup_duty_rate
Read-onlyIdempotent

Retrieve an eight-digit rate line or exact ten-digit statistical number with all published General, Special and Column 2 cells. An explicit eight-digit row takes precedence; an absent one resolves only through a unique ten-digit source row, retaining its identity. Multiple suffixes stay unresolved. Blank statistical cells inherit only from the matching eight-digit legal ancestor. With countryCode, report edition-matched General Note 3(b) listing; Special-program membership stays unknown. Neither comparison establishes qualification or selects a column. Follow usitc_check_additional_duties for partial Chapter 99 research.

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": {
      "code": "<code>"
    },
    "name": "usitc_lookup_duty_rate"
  }
}

Input Schema

NameRequiredDescriptionDefault
codeYesExact eight- or ten-digit HTS identifier, bare or conventionally dotted.
countryCodeNoAssigned ISO 3166-1 alpha-2 country; comparison only, never sent upstream.

Output Schema

NameRequiredDescriptionDefault
rowNoOriginal published source row with all resolved duty columns in resolvedRates, including a unique combined row when resolving an absent eight-digit number.
codeNoCanonical requested exact identifier.
errorNoPresent when the call failed. Absent on success.
foundNoWhether an exact source row or unique combined eight-digit relationship resolves.
sourceNoSource provenance.
noticesNoPersistent source and coverage limitations.
releaseNoEdition checked for this result.
guidanceNoExact research follow-up for a successful miss.
specialProgramsNoDecoded nonblank Special cell, preserving unmatched text.
chapter99PointersNoResearch pointer with no fabricated candidate count.
countryAssessmentNoEdition-pinned Column 2 listing with unresolved Special-program membership, qualification and column choice.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed22 schema fields changed
    • addedInput schema / properties / code / pattern
      Added value: +"^\\s*(?:\\d{4}(?:\\d{2}){0,3}|\\d{4}\\.\\d{2}(?:\\.\\d{2}){0,2}|\\d{4}\\.\\d{2}\\.\\d{4})\\s*$"
    • addedInput schema / properties / countryCode / pattern
      Added value: +"^\\s*(?:[A-Za-z]{2}\\s*)?$"
    • changedOutput schema / properties / countryAssessment / properties / column2Listing / properties / status / description
      Previous value: -"Membership in the complete reviewed GN3(b) list; unknown on edition mismatch."New value: +"Membership in the complete reviewed GN3(b) list; unknown unless editionMatches is true."
    • changedOutput schema / properties / countryAssessment / properties / editionMatches / description
      Previous value: -"Whether the decoder edition equals the checked schedule edition."New value: +"Whether the checked schedule edition is the reviewed decoder edition or one whose General Note 3 text was verified identical to it."
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_code`: Identifier is not exactly eight or ten digits in a supported form. `invalid_country`: Country is not an assigned ISO alpha-2 value. `release_changed`: Edition changed twice during source assembly. `invalid_hierarchy`: Complete heading rows cannot establish safe ancestry. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_code`: Identifier is a four- or six-digit code rather than an eight- or ten-digit number. `invalid_country`: Two-letter country is not an assigned ISO 3166-1 alpha-2 code. `release_changed`: Edition changed twice during source assembly. `invalid_hierarchy`: Complete heading rows cannot establish safe ancestry. Other values are possible when a failure originates below the handler."
    • removedOutput schema / properties / notice
      Removed value: -{
      -  "description": "Actionable next call for this particular empty result.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / resolvedRates
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "All resolved duty columns when the exact number exists.",
      -  "properties": {
      -    "column2": {
      -      "additionalProperties": false,
      -      "description": "Resolved Column 2 cell.",
      -      "properties": {
      -        "sourceFollowUp": {
      -          "additionalProperties": false,
      -          "description": "Retrieve the complete rate source and its own parent.",
      -          "properties": {
      -            "arguments": {
      -              "additionalProperties": false,
      -              "description": "Executable node lookup arguments.",
      -              "properties": {
      -                "code": {
      -                  "description": "Containing four-digit heading.",
      -                  "type": "string"
      -                },
      -                "nodeId": {
      -                  "description": "Exact source node identifier.",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "nodeId"
      -              ],
      -              "type": "object"
      -            },
      -            "tool": {
      -              "const": "usitc_get_heading",
      -              "description": "Tool resolving the exact node.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "tool",
      -            "arguments"
      -          ],
      -          "type": "object"
      -        },
      -        "sourceHtsno": {
      -          "description": "Number on which this rate was published.",
      -          "type": "string"
      -        },
      -        "sourceNodeId": {
      -          "description": "Node on which this rate was published.",
      -          "type": "string"
      -        },
      -        "state": {
      -          "description": "Whether a nonblank value is published here, inherited from the exact eight-digit ancestor, or absent.",
      -          "enum": [
      -            "published",
      -            "inherited",
      -            "not_published"
      -          ],
      -          "type": "string"
      -        },
      -        "text": {
      -          "description": "Unevaluated published rate text.",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "state"
      -      ],
      -      "type": "object"
      -    },
      -    "general": {
      -      "additionalProperties": false,
      -      "description": "Resolved General cell.",
      -      "properties": {
      -        "sourceFollowUp": {
      -          "additionalProperties": false,
      -          "description": "Retrieve the complete rate source and its own parent.",
      -          "properties": {
      -            "arguments": {
      -              "additionalProperties": false,
      -              "description": "Executable node lookup arguments.",
      -              "properties": {
      -                "code": {
      -                  "description": "Containing four-digit heading.",
      -                  "type": "string"
      -                },
      -                "nodeId": {
      -                  "description": "Exact source node identifier.",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "nodeId"
      -              ],
      -              "type": "object"
      -            },
      -            "tool": {
      -              "const": "usitc_get_heading",
      -              "description": "Tool resolving the exact node.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "tool",
      -            "arguments"
      -          ],
      -          "type": "object"
      -        },
      -        "sourceHtsno": {
      -          "description": "Number on which this rate was published.",
      -          "type": "string"
      -        },
      -        "sourceNodeId": {
      -          "description": "Node on which this rate was published.",
      -          "type": "string"
      -        },
      -        "state": {
      -          "description": "Whether a nonblank value is published here, inherited from the exact eight-digit ancestor, or absent.",
      -          "enum": [
      -            "published",
      -            "inherited",
      -            "not_published"
      -          ],
      -          "type": "string"
      -        },
      -        "text": {
      -          "description": "Unevaluated published rate text.",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "state"
      -      ],
      -      "type": "object"
      -    },
      -    "special": {
      -      "additionalProperties": false,
      -      "description": "Resolved Special cell.",
      -      "properties": {
      -        "sourceFollowUp": {
      -          "additionalProperties": false,
      -          "description": "Retrieve the complete rate source and its own parent.",
      -          "properties": {
      -            "arguments": {
      -              "additionalProperties": false,
      -              "description": "Executable node lookup arguments.",
      -              "properties": {
      -                "code": {
      -                  "description": "Containing four-digit heading.",
      -                  "type": "string"
      -                },
      -                "nodeId": {
      -                  "description": "Exact source node identifier.",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "code",
      -                "nodeId"
      -              ],
      -              "type": "object"
      -            },
      -            "tool": {
      -              "const": "usitc_get_heading",
      -              "description": "Tool resolving the exact node.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "tool",
      -            "arguments"
      -          ],
      -          "type": "object"
      -        },
      -        "sourceHtsno": {
      -          "description": "Number on which this rate was published.",
      -          "type": "string"
      -        },
      -        "sourceNodeId": {
      -          "description": "Node on which this rate was published.",
      -          "type": "string"
      -        },
      -        "state": {
      -          "description": "Whether a nonblank value is published here, inherited from the exact eight-digit ancestor, or absent.",
      -          "enum": [
      -            "published",
      -            "inherited",
      -            "not_published"
      -          ],
      -          "type": "string"
      -        },
      -        "text": {
      -          "description": "Unevaluated published rate text.",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "state"
      -      ],
      -      "type": "object"
      -    }
      -  },
      -  "required": [
      -    "general",
      -    "special",
      -    "column2"
      -  ],
      -  "type": "object"
      -}
    • changedOutput schema / properties / row / description
      Previous value: -"Original published source row, including a unique combined row when resolving an absent eight-digit number."New value: +"Original published source row with all resolved duty columns in resolvedRates, including a unique combined row when resolving an absent eight-digit number."
    • changedOutput schema / properties / row / properties / nodeId / description
      Previous value: -"Release and source-digest-local node identifier."New value: +"Exact node identifier for usitc_get_heading, local to this edition and source export."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / column2 / properties / sourceFollowUp / description
      Previous value: -"Retrieve the complete rate source and its own parent."New value: +"Inherited only: retrieve the complete rate source and its own parent."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / column2 / properties / sourceHtsno / description
      Previous value: -"Number on which this rate was published."New value: +"Inherited only: ancestor number on which this rate was published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / column2 / properties / sourceNodeId / description
      Previous value: -"Node on which this rate was published."New value: +"Inherited only: ancestor node on which this rate was published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / column2 / properties / text / description
      Previous value: -"Unevaluated published rate text."New value: +"Unevaluated rate text; absent when not_published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / general / properties / sourceFollowUp / description
      Previous value: -"Retrieve the complete rate source and its own parent."New value: +"Inherited only: retrieve the complete rate source and its own parent."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / general / properties / sourceHtsno / description
      Previous value: -"Number on which this rate was published."New value: +"Inherited only: ancestor number on which this rate was published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / general / properties / sourceNodeId / description
      Previous value: -"Node on which this rate was published."New value: +"Inherited only: ancestor node on which this rate was published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / general / properties / text / description
      Previous value: -"Unevaluated published rate text."New value: +"Unevaluated rate text; absent when not_published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / special / properties / sourceFollowUp / description
      Previous value: -"Retrieve the complete rate source and its own parent."New value: +"Inherited only: retrieve the complete rate source and its own parent."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / special / properties / sourceHtsno / description
      Previous value: -"Number on which this rate was published."New value: +"Inherited only: ancestor number on which this rate was published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / special / properties / sourceNodeId / description
      Previous value: -"Node on which this rate was published."New value: +"Inherited only: ancestor node on which this rate was published."
    • changedOutput schema / properties / row / properties / resolvedRates / properties / special / properties / text / description
      Previous value: -"Unevaluated published rate text."New value: +"Unevaluated rate text; absent when not_published."
    • removedOutput schema / properties / totalCount
      Removed value: -{
      -  "description": "Complete locally filtered item count.",
      -  "maximum": 9007199254740991,
      -  "minimum": -9007199254740991,
      -  "type": "integer"
      -}
  2. First observed

TDQS

A4/5.0
Behavior5/5

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

Beyond the readOnly/idempotent/openWorld annotations, the description discloses real resolution behavior: an explicit eight-digit row takes precedence, an absent one resolves only through a unique ten-digit source row, multiple suffixes stay unresolved, and blank statistical cells inherit from the matching eight-digit ancestor. It also states that the countryCode comparison is an edition-matched General Note 3(b) listing and that Special-program membership stays unknown, plus that the comparison never establishes qualification.

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?

Six tight sentences with the resolution precedence front-loaded ahead of the countryCode caveat and the sibling pointer. Nothing is redundant, though a few clauses ("retaining its identity", "Multiple suffixes stay unresolved") are compressed enough to risk ambiguity on first read.

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 high-complexity resolution tool with an output schema covering return values, the description covers precedence, inheritance, unresolved cases, and the scope limits of the countryCode comparison. The only gap is what happens on total failure (no matching row at either level), which the agent must infer.

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

Parameters4/5

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

Schema coverage is 100% with both parameters documented, so a 3 is the baseline; the description earns above that by explaining the precedence and fallback semantics attached to the code argument and by characterizing what the countryCode comparison actually yields (General Note 3(b) listing, membership unknown) rather than just repeating the schema's "comparison only" note.

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 a specific verb and resource: retrieve an eight- or ten-digit rate line with the published General, Special and Column 2 cells. It is clearly narrower than browse/search siblings and explicitly hands Chapter 99 work to usitc_check_additional_duties, though the jargon ("rate line", "statistical number") assumes domain familiarity.

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?

It gives one explicit routing rule (follow usitc_check_additional_duties for partial Chapter 99 research) and warns that neither comparison establishes qualification or selects a column, which is useful when-not guidance. However, there is no guidance on when to prefer this over usitc_get_heading or usitc_search_hts for a plain lookup, leaving the main sibling choice implicit.

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.