Agent Services (x402): compliance, company, procurement

Customs Tariff Lookup (UK Trade Tariff + US HTS) ($0.004)

hs_tariff

Read-onlyIdempotent

[Procurement] Find the HS/commodity code and import duty for goods shipped into the UK or the US. Use when quoting landed cost or preparing a UK or US customs entry. Price: $0.004 per call (USDC on Base, x402). Returns the x402 payment requirements unless payment_signature is given. Sample: /samples/hs-tariff

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "hs_tariff"
  }
}

Input Schema

Name	Required	Description
`code`	No	HS / commodity code (6-10 digits)
`query`	No	Keyword search instead of a code, e.g. laptop
`origin`	No	Optional ISO2 origin country for UK preferential rates
`markets`	No	uk, us or uk,us (default both)
`payment_signature`	No	Optional x402 v2 PAYMENT-SIGNATURE value, relayed unchanged to the endpoint. Omit to receive the payment requirements.

Schema Changelog

Changes observed during successful MCP inspections.

First observedOct 17, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations declare readOnlyHint, openWorldHint, and idempotentHint, so safety profile is covered. The description adds critical x402 payment behavior: returns payment requirements unless payment_signature is given, and notes the price ($0.004 USDC on Base). This dual-mode behavior (challenge vs. paid response) is not evident from annotations or schema. Does not describe rate limits or error modes, but adds substantial value.

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 sentences, each earning its place: purpose, usage scenarios, and payment/return behavior plus sample link. Front-loaded with the core function. No waste.

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?

Complete enough for an agent: purpose, usage context, payment mechanics, and sample path are covered. No output schema exists, so description needn't explain return values beyond the payment-requirements behavior, which it does. Missing only minor details like rate limits or error handling.

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 documents all five parameters thoroughly. The description mentions payment_signature behavior and implies query/code usage, but adds little beyond what schema already provides. Baseline 3 is appropriate.

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?

States a specific verb (find) and resource (HS/commodity code and import duty) with clear scope (goods shipped into UK or US). Distinguishes itself from siblings like screen_export_control and check_eori by focusing on tariff lookups rather than compliance screening.

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

Usage Guidelines5/5

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

Explicitly names when to use it: 'when quoting landed cost or preparing a UK or US customs entry'. This gives concrete scenarios that differentiate it from other trade tools. No exclusions listed, but the scenarios are specific enough.

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

All Agent Services (x402): compliance, company, procurement tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?