Skip to content

un-comtrade-mcp-server

io.github.cyanheads/un-comtrade-mcp-servercyanheadsstreamable-httpv0.5.0Scanned

UN Comtrade international trade statistics via MCP. Country/HS lookups, flows, balances, rankings.

11 tools: 11 only read.

Tools: 0 delete, 0 irreversible, 0 write, 11 read.
  • Reads private data · 0
  • Reads text others write · 8
  • Can send data out · 0
  • No findings

Tools listed without sign-in. Remote posture

With Anlyon

Decide which of this server's tools your agent can use.

  • Anlyon lists the tools and adopts none.
  • Each tool you adopt gets approvals and receipts.
  • Your agent never holds the key.
Govern this server →

A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.

What the un-comtrade-mcp-server can do

The un-comtrade-mcp-server is published by the GitHub account cyanheads. It has 11 tools. Every one of them only reads: going by their definitions, none of them creates, changes, sends or deletes anything.

8 tools bring in text other people can write (comtrade_get_trade_flows, comtrade_get_trade_balance, comtrade_get_top_partners and 5 more).

None of the fixed checks matched anything in its tool definitions. That is not a safety guarantee.

Its remote endpoint lists its tools without sign-in, and its tools changed 5 times since Anlyon Radar first saw them.

Last scanned Nov 22, 2026, version 0.5.0.

Tools

Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.

11 tools

Only reads 11Show 11 read-only tools
  • comtrade_get_data_availabilityCheck which reporter/period/classification combinations have published data before querying trade.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_data_availability" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Check which reporter/period/classification combinations have published data before querying trade. Returns datasets ordered by reporter code, newest period first within each reporter, with classification, record count and release dates where available. Annual data is typically published 3–12 months after the reference year and some reporters skip years. Omit filters to browse the index, 50 rows by default. Continue with nextOffset using the same filters and limit.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_get_services_tradeFetch annual international trade-in-services data.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_services_trade" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Fetch annual international trade-in-services data. Classification EB (default) serves each reporter-period as reported, in its own scheme (EB10, EB10S or EB02 codes); EB10 or EB02 selects UN Comtrade's conversion of other schemes into that one. Each row names its classification and whether it is original or converted. Same bilateral structure as goods trade: returns flow value in USD, period, and reporter/partner/category metadata for each row. Follow nextOffset for remaining records; each page repeats the upstream period requests. Use comtrade_list_service_categories to find a service code and its scheme before querying. Keyless preview makes one request per served period, at least 4 seconds apart, capped at 500 records per request. Services coverage is more limited than goods trade.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_get_top_commoditiesRank HS chapters (2-digit) or headings (4-digit) by trade value for one reporter, flow, and annual or monthly period.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_top_commodities" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rank HS chapters (2-digit) or headings (4-digit) by trade value for one reporter, flow, and annual or monthly period. Set parent_code and a deeper aggr_level to rank headings or subheadings within one chapter or heading. The tool uses matching TOTAL to identify the HS edition and queries explicit commodity codes in chunks, subdividing capped chunks. Shares use matching TOTAL or the reported parent value for a drill-down. Incomplete coverage returns available categories without ranks or shares and identifies unresolved codes. Defaults to World; optionally select one bilateral partner. Counterpart to comtrade_get_top_partners.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_get_top_partnersRank trading partners for a reporter by trade value for a given commodity and flow direction.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_top_partners" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rank trading partners for a reporter by trade value for a given commodity and flow direction. Returns the top N partners sorted by descending value — answers "who does country X mainly export product Y to?" or "where does country X mainly import product Z from?" for a single period. Fetches a disaggregated breakdown across all partners then sorts locally. Takes an HS or SITC code in the selected classification; omit cmd_code to rank partners for total trade.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_get_top_reportersRank retrieved reporting areas by reported import or export value for one goods code and period.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_top_reporters" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rank retrieved reporting areas by reported import or export value for one goods code and period. Partner 0 (World) ranks reporters by their trade with all partners. Use a bilateral partner to rank reporters by their trade with that area. Shares use the retrieved reporting areas before the display limit. Use comtrade_get_top_partners to rank the partners of one reporter.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_get_top_services_partnersRank partners of one reporter by trade value for a single annual EBOPS series.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_top_services_partners" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Rank partners of one reporter by trade value for a single annual EBOPS series. Omit service_code for total services, or use comtrade_list_service_categories to find one category. EB serves original reports, while EB10 and EB02 serve converted series. Shares divide by the sum of eligible retrieved partners before the display limit. Read coverageNotice before interpreting the ranking.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_get_trade_balanceCompute the trade balance for a country over one or more periods — total exports minus total imports — with an optional HS or SITC commodity filter whose codes must not overlap.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_trade_balance" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Compute the trade balance for a country over one or more periods — total exports minus total imports — with an optional HS or SITC commodity filter whose codes must not overlap. Keyless preview makes two requests per served period, at least 4 seconds apart; authenticated calls batch periods. Returns the export and import values per period and, when both flows have data, the signed balance (USD) and coverage ratio (exports / imports). Note: mirror asymmetry is common — balance reflects values as reported by this country; the same flow may be recorded differently by the partner. Uses comtrade_lookup_countries to resolve reporter codes.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_get_trade_flowsFetch bilateral trade flow records — the primary data retrieval tool.Reads text others writeNo findings

    Why it is in this group

    • The name "comtrade_get_trade_flows" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Fetch bilateral trade flow records — the primary data retrieval tool. Returns trade value in USD (primaryValue — FOB for exports, CIF for imports), quantity, net weight, and period/commodity/partner metadata for each row. Accepts multiple periods and commodity codes per call; pass partner_code 0 to get totals aggregated across all partners. Omit cmd_code or pass "TOTAL" to aggregate all commodities. Follow nextOffset for remaining records; each page repeats the upstream period requests. Keyless preview makes one request per served period, at least 4 seconds apart, with a 500-record cap per request. Use comtrade_lookup_countries to resolve reporter/partner codes and comtrade_search_commodities to resolve HS codes. For SITC, supply codes from the selected SITC revision.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • comtrade_list_service_categoriesList service trade categories from the combined EB catalog, including numeric EBOPS and SDMX codes.No findings

    Why it is in this group

    • The name "comtrade_list_service_categories" says "list": a word for reading.
    Description, as the server wrote it
    List service trade categories from the combined EB catalog, including numeric EBOPS and SDMX codes. Returns category codes, descriptions, parent codes, and the EBOPS scheme catalogs that list each code: EB10 (EBOPS 2010), EB10S (EBOPS 2010 SDMX codes), EB02 (EBOPS 2002). Search by keyword or by several terms in any order, or browse direct children of a parent code; "200" lists the EB10 and EB02 top levels. Use the returned id as service_code in comtrade_get_services_trade. Code 3 is transport; SA is manufacturing services. Each page holds up to limit categories; continue with nextOffset using the same query and parent_code.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • comtrade_lookup_countriesResolve country and area names to Comtrade M49 numeric codes used in all data queries.No findings

    Why it is in this group

    • The name "comtrade_lookup_countries" says "lookup": a word for reading.
    Description, as the server wrote it
    Resolve country and area names to Comtrade M49 numeric codes used in all data queries. Accepts a partial or full name, an official name (e.g. "Republic of Korea"), a common name (e.g. "UK", "Turkey"), or an ISO alpha-2/alpha-3 code (e.g. "USA", "US"), ignoring case and accents; exact matches are listed before partial ones. Returns matching entries with their numeric code, ISO identifiers, a validAsReporter flag, and validity dates; within the exact and partial groups, historical entities such as Fed. Rep. of Germany (...1990) are listed after current ones. World (code 0) is a valid partner but not a valid reporter, while some groupings, such as the European Union (97), do report — check validAsReporter. Use this before any trade data tool that requires reporter_code or partner_code. To aggregate across all partners, use partner code 0 (World) — no lookup needed.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • comtrade_search_commoditiesFind HS or SITC commodity codes by keyword, description, or code prefix.No findings

    Why it is in this group

    • The name "comtrade_search_commodities" says "search": a word for reading.
    Description, as the server wrote it
    Find HS or SITC commodity codes by keyword, description, or code prefix. A code written with dots, spaces, or hyphens ("0901.11") matches 090111. Exact codes, code prefixes and contiguous description matches rank first, followed by descriptions containing every query term in any order. Default HS searches include historical codes and report which edition catalogs list each code. Use a trade row’s classificationCode or comtrade_get_data_availability to identify the edition, then search that edition for its descriptions. Keyless goods queries use HS for as-reported data. Continue with nextOffset using the same query, classification, and aggr_level.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data or outbound.

Reads private data0
Reads files, mail, messages, databases, secrets, calendars or repositories.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Tools listed without sign-in

Looked at Nov 20, 2026, 19:34 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
0
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
not observed
RFC 9728 protected resource metadata
not observed
Authorization servers
not observed
Legacy HTTP+SSE transport
no
Dynamic client registration
not observed
Client ID metadata documents
not observed

Findings

Matches of fixed checks, with the text they matched.

No check matched anything in these tool definitions. That is not a safety guarantee.

History

Changes to its tool definitions and to its remote endpoint, newest first.

  1. Tools1 added, 4 changed.+1 added~4 changedView diff
  2. Tools1 added, 6 changed.+1 added~6 changedView diff
  3. Tools6 changed.~6 changedView diff
  4. Tools9 changed.~9 changedView diff
  5. Tools8 changed.~8 changedView diff

Install

Pinned to version 0.5.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http un-comtrade https://un-comtrade.caseyjhand.com/mcp
claude mcp add --transport http un-comtrade https://un-comtrade.caseyjhand.com/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__un-comtrade__comtrade_lookup_countries",
      "mcp__un-comtrade__comtrade_search_commodities",
      "mcp__un-comtrade__comtrade_list_service_categories",
      "mcp__un-comtrade__comtrade_get_trade_flows",
      "mcp__un-comtrade__comtrade_get_trade_balance",
      "mcp__un-comtrade__comtrade_get_top_partners",
      "mcp__un-comtrade__comtrade_get_top_services_partners",
      "mcp__un-comtrade__comtrade_get_top_reporters",
      "mcp__un-comtrade__comtrade_get_top_commodities",
      "mcp__un-comtrade__comtrade_get_data_availability",
      "mcp__un-comtrade__comtrade_get_services_trade"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as un-comtrade. Review it before you use it.

Capability tags behind 8 rules
  • mcp__un-comtrade__comtrade_get_trade_flows untrusted-input
  • mcp__un-comtrade__comtrade_get_trade_balance untrusted-input
  • mcp__un-comtrade__comtrade_get_top_partners untrusted-input
  • mcp__un-comtrade__comtrade_get_top_services_partners untrusted-input
  • mcp__un-comtrade__comtrade_get_top_reporters untrusted-input
  • mcp__un-comtrade__comtrade_get_top_commodities untrusted-input
  • mcp__un-comtrade__comtrade_get_data_availability untrusted-input
  • mcp__un-comtrade__comtrade_get_services_trade untrusted-input

Pin

Keep the decision: fail CI when the tools change, follow every change, or show a badge.

Pin in CI

Fail a build when the tools you reviewed are not the tools the server serves today.

curl -s "https://radar.anlyon.com/api/v1/servers/io.github.cyanheads/un-comtrade-mcp-server/verify?hash=cd26e8bf710af7721d13c5424368b5d8fa184557d491b172bc167d24d9c624c2" | jq -e '.changed == false'

Pinned hash cd26e8bf710a, from Nov 22, 2026, 02:19 UTC.

Watch

Get told when its tools change: a new tool, a new description, a new class.

https://radar.anlyon.com/servers/io.github.cyanheads/un-comtrade-mcp-server/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

Anlyon Radar badge for io.github.cyanheads/un-comtrade-mcp-server
[![Anlyon Radar](https://radar.anlyon.com/badge/io.github.cyanheads/un-comtrade-mcp-server.svg)](https://radar.anlyon.com/servers/io.github.cyanheads/un-comtrade-mcp-server)

Source: MCP Registry · repository. Synced Nov 22, 2026, 02:17 UTC.

un-comtrade-mcp-server: questions and answers

Answered from the scan above, not from the publisher's description.

Is the un-comtrade-mcp-server safe?

No scan can promise that. What its definitions show: 11 tools, all of which only read, and 0 findings from fixed checks. Read-only tools can still pass private data to a model.

Can the un-comtrade-mcp-server delete data?

No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.

Can the un-comtrade-mcp-server do things that cannot be undone?

No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.

What tools does the un-comtrade-mcp-server have?

11 tools: 11 read. comtrade_lookup_countries, comtrade_search_commodities, comtrade_list_service_categories, comtrade_get_trade_flows, comtrade_get_trade_balance, comtrade_get_top_partners, comtrade_get_top_services_partners, comtrade_get_top_reporters and 3 more.

Does the un-comtrade-mcp-server need sign-in or OAuth?

Its remote endpoint listed its tools to an anonymous client, without sign-in.

Does the un-comtrade-mcp-server send data to outside services?

None of its tools sends, posts or publishes, or takes a recipient, channel or URL.

Has the un-comtrade-mcp-server changed its tools?

Yes, 5 times since Anlyon Radar started tracking it, most recently on Nov 22, 2026. Every change is on this page and in its Atom feed.