Skip to main content
Glama

Free Agent Tools

by io.github.sean0007
OverviewDiscussionsAdmin

Japan customs duty-free allowance on arrival: within/over, duty estimate in yen, cash declaration

japan_customs_allowance_check
Read-onlyIdempotent

Japan Customs per-person duty-free allowance when entering Japan (as of 2026-10-14): alcohol 3 bottles of about 760 ml (2.28 L); cigarettes 200 OR cigars 50 OR heat-not-burn 10 packages (200 IQOS/glo sticks, 50 Ploom TECH capsules) OR other tobacco 250 g, more than one kind 250 g total; perfume 2 oz (about 56 ml); other goods ¥200,000 total overseas value, an item kind worth ¥10,000 or less in total is free and not counted, an article over ¥200,000 is fully dutiable. Under 20: no alcohol/tobacco allowance; under 6: only items for the child. Excess duty at the simplified rates: whisky/brandy ¥800/L, rum/gin/vodka ¥500/L, liqueur ¥400/L, distilled ¥300/L, wine/beer ¥200/L, cigarettes and sticks ¥15 each, capsules ¥50, other goods 15% of Customs value (price × 0.6), watches/golf clubs/PCs 10% consumption tax; not applied to articles with Customs value over ¥100,000, cigars or other tobacco. Cash and other means of payment over ¥1,000,000 (¥100,000 bound for North Korea) must be declared. Returns per-category within/over, excess, estimatedSimplifiedDutyJPY (+ High for the strict mixed-tobacco reading), tax-type breakdown truncated to ¥100 (reproduces Customs' ¥19,400 worked example), red/green channel, cashDeclarationRequired, warnings, assumptions, sources, rulesAsOf. Many guides still show pre-2021 tobacco limits — call this instead of guessing. Educational estimate; the Customs officer decides.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
goodsNoOther articles: overseas retail price of ONE article in yen, quantity, dutyFreeTariff true for watches / golf clubs / PCs, forChild for a child's items.
cigarsNoCigars (allowance 50).
alcoholNoSeveral drinks: [{type, ml or bottles}]. Allowance goes to the highest-rate drink first.
cashJPYNoCash (yen + foreign in yen) one person carries.
hnbTypeNoWhat hnbPackages contain. Default sticks.
ageYearsNoTraveler age. Under 20 = no alcohol/tobacco allowance; under 6 = only items for the child. Default adult.
alcoholMlNoTotal alcohol volume in ml (allowance 2,280 ml per adult).
hnbSticksNoLoose IQOS / glo sticks (allowance 200).
perfumeMlNoPerfume in ml (allowance about 56 ml; eau de toilette not counted).
perfumeOzNoPerfume in ounces (allowance 2 oz).
travelersNoPeople in the same age band pooling allowances. Default 1.
cigarettesNoCigarettes (allowance 200).
alcoholTypeNoDrink type for the simplified rate. Default other (¥200/L).
hnbCapsulesNoPloom TECH / with capsules (allowance 50).
hnbPackagesNoHeat-not-burn packs (allowance 10; 20 sticks or 5 capsules each).
goldBullionKgNoGold bullion carried in kg (over 1 kg must be declared).
goodsTotalJPYNoInstead of goods: total overseas value of other articles (approximate).
alcoholBottlesNoBottles of alcohol (assumed 760 ml each unless alcoholMl is given).
otherTobaccoGramsNoPipe / other tobacco in grams (allowance 250 g).
boundForNorthKoreaNoLeaving Japan for North Korea (declaration threshold ¥100,000).
paymentInstrumentsJPYNoChecks, travelers checks, promissory notes, securities in yen.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.5/5.0
Behavior5/5

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

Annotations cover safety (readOnly, idempotent, non-destructive, closed-world), and the description adds substantial context beyond them: it enumerates returned fields (within/over, estimatedSimplifiedDutyJPY, channel, cashDeclarationRequired, warnings, assumptions, rulesAsOf), states the rules' effective date, and explicitly frames the result as an educational estimate subject to the officer's decision.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded, but the body is a single sprawling block that crams rules, rates, output fields, and caveats together without structure. Given the domain's complexity much of it earns its place, but the density hurts scanability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 21-parameter tool with no output schema, the description compensates by describing the return shape and the rules' scope, so an agent knows what inputs matter and what comes back. Nothing essential for correct invocation is missing.

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 description coverage is 100%, so the baseline is 3. The description goes further by supplying the rate schedule that gives the alcoholType/hnbType enums meaning (¥800/L whisky, ¥15/stick cigarettes, 15% other goods) and notes precedence ('Allowance goes to the highest-rate drink first'), which aids correct parameter use.

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+resource+scope ('Japan Customs per-person duty-free allowance when entering Japan') and clearly occupies a distinct niche from siblings like japan_luggage_check, japan_tax_free_refund_check, and japan_visa_fee_check. An agent can identify it without opening the schema.

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?

Gives a clear usage trigger ('call this instead of guessing') and warns that many guides show stale pre-2021 tobacco limits, implying when this tool is the right choice. It doesn't name an alternative sibling or state exclusions explicitly, so it falls short of a 5.

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

All Free Agent Tools toolsInspect
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