{"id":"dev.tradestats/tradestats","slug":"dev-tradestats-tradestats","title":"TradeStats - customs trade statistics","description":"Customs trade statistics API and MCP: monthly imports/exports by HS code and partner, Japan and UK.","version":"1.0.1","publisher":{"kind":"domain","id":"tradestats.dev","label":"tradestats.dev","url":"https://tradestats.dev"},"website":"https://tradestats.dev/","repository":"","remotes":[{"type":"streamable-http","url":"https://tradestats.dev/mcp"}],"packages":[],"published":"2026-11-17","updated":"2026-11-17","status":"online","auth":"","latency_ms":2903,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_items","title":"","description":"Find product codes of one reporter by words from the product name (customs wording, e.g. \"lithium-ion\", \"frozen shrimp\", \"integrated circuits\") or by a code prefix (digits, e.g. \"8708\" or \"30\"). Japanese words work too (kanji, katakana or hiragana) and search the Japanese product names of HS6, or of HS4/HS2 with level; each hit carries description_ja when a Japanese name exists. Use it first when ","read_only":false},{"name":"get_series","title":"","description":"Monthly time series for one product (HS2/4/6 or national code) of one reporter and partner country (default: world total). Per month: value and value_usd, quantity, kilograms, unit price (per unit and per kg), year-over-year and month-over-month change, share of the country total and trailing-12-month share, flags for months whose changes are not comparable because of a reclassification or definit","read_only":false},{"name":"get_partners","title":"","description":"Trading partners of one reporter for one product. window 12 (default) covers the latest 12 months: each partner's 12-month value (and value_usd), share, year-over-year change against the previous 12 months, the 3-year change and rank; sort \"growth\" ranks by growth instead of size and, unless min_value is given, leaves out partners below a default floor (the larger of US$ 1,000,000 and 1% of the wo","read_only":false},{"name":"get_ranking","title":"","description":"Rankings of one reporter for a month. kind \"items_for_country\": the largest products (at the chosen level) for a partner country (default: world total). kind \"countries_for_item\": the largest partner countries for one product code. kind \"movers_up\" / \"movers_down\": the products with the largest US-dollar increase / decrease versus the same month a year earlier (for a partner, default world; kept f","read_only":false},{"name":"get_balance","title":"","description":"Trade balance of one reporter for a product and partner country (default: world total) by month: export value, import value and balance (exports minus imports), in the reporter's currency and in US dollars. A month with trade in one direction only shows the other side as 0 only when that direction is published for the month, has no source gap, AND the chapter has no undisclosed (withheld) amount t","read_only":false},{"name":"compare_countries","title":"","description":"One product (HS2, HS4 or HS6 code, e.g. \"850760\" lithium-ion batteries, \"8708\" auto parts, \"72\" iron and steel, \"030617\" frozen shrimp) side by side across several reporting countries (default: all of JP, GB) for one flow. Every country is measured over the same 12 months, ending at common_month (the latest month all compared countries have published, normally the earliest of their latest months).","read_only":false},{"name":"get_mirror_trade","title":"","description":"Two customs records of trade between two reporting countries: reporter's flow (export or import) with partner as the other side, next to the partner's opposite flow with the reporter as the other side. For example reporter JP, partner GB, flow export, code 8708 (auto parts) shows Japan's exports to the United Kingdom beside the United Kingdom's imports from Japan, for the same 12 months (ending at","read_only":false},{"name":"get_item_summary","title":"","description":"One-call overview of a product (HS2/4/6 or national code) of one reporter for the usual questions: a one-line summary (ai_context_summary, in US dollars), latest month, the last 12 months against the previous 12 and 3 years earlier, top 20 partners plus \"other\", the fastest growing and declining partners, calendar-year totals, partner concentration, new markets, the seasonal peak and trough months","read_only":false},{"name":"get_new_markets","title":"","description":"Partner countries that are new or surging for one product of one reporter, comparing the latest 12 months with the 12 months before. \"new\": the 12-month value is at least min_value (default 1,000,000 US dollars; never below 100,000) and the previous 12 months were lower and under 100,000 US dollars (no trade counts as 0). \"surging\": the 12-month value is at least min_value and grew +100% or more i","read_only":false},{"name":"get_seasonality","title":"","description":"Seasonal pattern of one product of one reporter: for the 3 latest full calendar years before the year of the latest published month (data through 2026-08 gives 2023 to 2025; the years are stated in the answer), each calendar month's share of the 3-year value total and of the 3-year quantity total, the lowest and highest share of that month in any single year, and the peak and trough months (adjace","read_only":false},{"name":"get_catalog","title":"","description":"Call this first. Describes what the service holds: the reporters (JP, GB) with their currency, national code level, and for import and export the first month and the latest published month; per reporter also source (the agency to name when you cite the data) and latest_month (that reporter's own latest published month; data_through, also given as common_latest_month, is only the latest month publi","read_only":false},{"name":"report_data_issue","title":"","description":"Report a figure that looks wrong or a data problem you noticed (at most 10 reports per day per caller). Give the tool and arguments of the call in question and describe the problem in message (up to 2,000 characters). Returns a report id; the text is stored for review by the operator and is never shown to other users. Use it only after checking the figure; not for questions or feature requests. Lo","read_only":false},{"name":"list_indicators","title":"","description":"Call by name, no HS code needed: lists the named indicators this service computes from public customs statistics (for example the quarterly base price of domestic naphtha, naphtha import prices and origins, or Japan passenger car and parts exports by destination). Each entry has its id, aliases in English and Japanese, definition, how often it is published, the keys of its caveats (get_indicator g","read_only":false},{"name":"get_indicator","title":"","description":"Call by name, no HS code needed: returns one named indicator as a series (monthly or quarterly, newest first) with its latest value, year-on-year changes, a partner-country breakdown where the indicator has one, the definition, the caveats and a fixed notice that the value is our own calculation and not an official figure. Give an id or an English or Japanese alias (a few distinctive words also wo","read_only":false},{"name":"decompose_change","title":"","description":"Splits the change in the value of a named indicator or of an HS code into a unit-value (price) effect and a volume effect: the latest window of 1, 3 or 12 months (default 12) is compared with the same months a year earlier, with the log-mean (LMDI) method, so the two effects add up to the change in value exactly (check shows the residual). The answer gives value, quantity and unit value for both w","read_only":false},{"name":"get_supplier_dependency","title":"","description":"Concentration of the supplying countries behind a named indicator or an HS code over the latest 12 months: the Herfindahl index (hhi, 0 to 1; score_points is the same figure on the 0 to 10,000 scale), the share of the largest supplier and of the top three, the number of supplying countries, how hhi moved against 1 and 3 years earlier (more_diversified, little_change or more_concentrated) and the m","read_only":false},{"name":"get_mirror_estimate","title":"","description":"Estimate of one country's trade for a product from the records of the reporting countries that trade with it: for a target such as CN (China), flow \"import\" sums the reporters' exports to the target (what the target bought from them) and flow \"export\" sums the reporters' imports from the target, over the same 12 months ending at the latest month every reporter used has published, in US dollars. Us","read_only":false}],"server_info":{"name":"tradestats","title":"TradeStats - Trade Statistics (Japan, United Kingdom)","version":"0.1.0"},"category":"open-data","tags":["developer","analytics","project"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-15","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/dev-tradestats-tradestats/"}