io.github.cyanheads/un-comtrade-mcp-server

Est-ce que io.github.cyanheads/un-comtrade-mcp-server est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.cyanheads/un-comtrade-mcp-server » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 9 outils

• comtrade_get_data_availability≈ 968 tokens

  Check which reporter/period/classification combinations have published data before constructing expensive trade queries. Returns dataset records with period, classification, record count, and first/latest release dates. Call this before querying recent periods — annual data is typically published 3–12 months after the reference year and not all countries report every year. Omit all parameters to browse the full availability index.

  Paramètres, retour & exemple (5)

  Paramètres

  • freq · string · optionnel · A | M
    Frequency: A=annual, M=monthly.
  • period · string · optionnel
    Period to check: YYYY (annual) or YYYYMM (monthly). Omit to see all available periods for the reporter.
  • type_code · string · optionnel · C | S
    Trade type: C=commodities (goods), S=services.
  • reporter_code · integer · optionnel
    M49 reporter code to check. Omit to browse availability across all reporters.
  • classification · string · optionnel
    Classification code filter (e.g. "HS", "H6", "EB10"). Omitted or blank defaults to HS for goods and EB10 for services.

  Exemple d'appel

  {"name": "comtrade_get_data_availability", "arguments": {"freq": "A", "period": "texte", "type_code": "C", "reporter_code": 1, "classification": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "notice": "texte", "datasets": [], "totalDatasets": 1}}

• comtrade_get_services_trade≈ 1185 tokens

  Fetch international trade-in-services data (EBOPS 2010 classification). Same bilateral structure as goods trade: returns flow value in USD, period, and reporter/partner/category metadata for each row. Use comtrade_list_service_categories to find the right service code before querying. Preview makes one paced request per served period, capped at 500 records per request. Services coverage is more limited than goods trade.

  Paramètres, retour & exemple (5)

  Paramètres

  • period · array · requis
    Periods (YYYY or YYYYMM). Serves the first 12 and discloses the remainder; input ceiling 120. Preview makes one paced request per period.
  • flow_code · string · requis · M | X
    Trade flow: M=imports (credit received by reporter), X=exports (debit paid).
  • partner_code · integer · optionnel
    M49 partner code. Use 0 for all partners combined. Omit for a disaggregated by-partner breakdown.
  • service_code · string · optionnel
    EBOPS 2010 service category code (e.g. "SA" for transport). Use comtrade_list_service_categories to find available codes. Omit to get totals across all service categories.
  • reporter_code · integer · requis
    M49 numeric code of the reporting country.

  Exemple d'appel

  {"name": "comtrade_get_services_trade", "arguments": {"period": [], "flow_code": "M", "reporter_code": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "shown": 1, "notice": "texte", "records": [], "truncated": true, "totalCount": 1, "truncationHint": "texte", "unservedPeriods": []}}

• comtrade_get_top_commodities≈ 1132 tokens

  Rank commodity categories for a reporter by trade value for a given flow direction and period. Returns the top N HS chapters (2-digit) or headings (4-digit) sorted by descending value — answers "what does country X mainly export?" or "what does country X mainly import?". Symmetric counterpart to comtrade_get_top_partners. Optionally filter to a single partner country.

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
    Maximum number of top commodity categories to return; above 50 returns all retrieved categories.
  • period · string · requis
    Single period: annual (YYYY) or monthly (YYYYMM).
  • flow_code · string · requis · M | X
    Trade flow: M=imports, X=exports.
  • aggr_level · ? · optionnel
    HS aggregation level: 2 = chapter (broader), 4 = heading (more specific).
  • partner_code · integer · optionnel
    M49 partner code to filter to a specific bilateral relationship. Omit to rank commodities across all partners.
  • reporter_code · integer · requis
    M49 numeric code of the reporting country.

  Exemple d'appel

  {"name": "comtrade_get_top_commodities", "arguments": {"period": "texte", "flow_code": "M", "reporter_code": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "notice": "texte", "period": "texte", "flowCode": "texte", "aggrLevel": 1, "truncated": true, "commodities": [], "reporterCode": 1, "reporterDesc": "texte", "totalValueUsd": 1, "totalCommodities": 1}}

• comtrade_get_top_partners≈ 1058 tokens

  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. Omit cmd_code to rank partners for total trade.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    Maximum number of top partners to return; above 50 returns all retrieved partners.
  • period · string · requis
    Single period: annual (YYYY) or monthly (YYYYMM).
  • cmd_code · string · optionnel
    Single HS commodity code (e.g. "84", "8471"). Omit or pass "TOTAL" to rank partners for total merchandise trade.
  • flow_code · string · requis · M | X
    Trade flow: M=imports, X=exports.
  • reporter_code · integer · requis
    M49 numeric code of the reporting country.

  Exemple d'appel

  {"name": "comtrade_get_top_partners", "arguments": {"period": "texte", "flow_code": "M", "reporter_code": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "notice": "texte", "period": "texte", "cmdCode": "texte", "flowCode": "texte", "partners": [], "truncated": true, "reporterCode": 1, "reporterDesc": "texte", "totalPartners": 1, "totalValueUsd": 1}}

• comtrade_get_trade_balance≈ 1272 tokens

  Compute the trade balance for a country over one or more periods — total exports minus total imports — with optional HS or SITC commodity filter. Preview makes two paced requests per served period; authenticated calls batch periods. Returns the signed balance (USD), export value, import value, 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.

  Paramètres, retour & exemple (5)

  Paramètres

  • freq · string · optionnel · A | M
    Frequency: A=annual, M=monthly.
  • period · array · requis
    Annual periods (YYYY) or monthly periods (YYYYMM). Serves the first 12 and discloses the remainder; input ceiling 120.
  • cmd_code · array · optionnel
    HS or SITC commodity codes to restrict the balance calculation. Serves the first 20 and discloses the remainder; input ceiling 200. Omit to compute the overall trade balance across all commodities.
  • reporter_code · integer · requis
    M49 numeric code of the reporting country.
  • classification · string · optionnel · HS | H0 | H1 | H2 | H3 | H4 | H5 | H6
    Goods classification: HS/H0–H6 or SITC S1–S4/SS.

  Exemple d'appel

  {"name": "comtrade_get_trade_balance", "arguments": {"period": [], "reporter_code": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "notice": "texte", "periods": [], "cmdCodes": [], "mirrorCaveat": "texte", "reporterCode": 1, "reporterDesc": "texte", "referenceNotice": "texte", "unservedPeriods": [], "unservedCmdCodes": []}}

• comtrade_get_trade_flows≈ 1651 tokens

  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. Preview makes one paced request per served period, 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.

  Paramètres, retour & exemple (7)

  Paramètres

  • freq · string · optionnel · A | M
    Frequency: A=annual, M=monthly.
  • period · array · requis
    One or more periods to query. Annual: "YYYY" (e.g. ["2022", "2023"]). Monthly: "YYYYMM" (e.g. ["202201", "202202"]). Serves the first 12 periods and discloses the remainder; input ceiling 120.
  • cmd_code · array · optionnel
    HS or SITC commodity codes to query. Serves the first 20 codes and discloses the remainder; input ceiling 200. Pass ["TOTAL"] or omit to aggregate all commodities. Use comtrade_search_commodities for HS codes only.
  • flow_code · string · requis · M | X | RX | RM
    Trade flow direction: M=imports, X=exports, RX=re-exports, RM=re-imports.
  • partner_code · integer · optionnel
    M49 code of the trade partner. Use 0 to aggregate across all partners (World total). Omit to get a disaggregated breakdown by partner country.
  • reporter_code · integer · requis
    M49 numeric code of the reporting country. Use comtrade_lookup_countries to resolve names to codes.
  • classification · string · optionnel · HS | H0 | H1 | H2 | H3 | H4 | H5 | H6
    Goods classification: HS/H0–H6 or SITC S1–S4/SS. Defaults to combined HS.

  Exemple d'appel

  {"name": "comtrade_get_trade_flows", "arguments": {"period": [], "flow_code": "M", "reporter_code": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "shown": 1, "notice": "texte", "records": [], "truncated": true, "totalCount": 1, "truncationHint": "texte", "referenceNotice": "texte", "unservedPeriods": [], "unservedCmdCodes": []}}

• comtrade_list_service_categories≈ 824 tokens

  List EBOPS 2010 service trade categories — the equivalent of comtrade_search_commodities for the services domain. Returns category codes, descriptions, and parent codes. Filter by keyword to find a specific service type (e.g. "transport", "financial", "travel"), or browse from a parent category code. Use the returned id as service_code in comtrade_get_services_trade.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum number of categories to return; above 500 returns all matching categories.
  • query · string · optionnel
    Keyword or category code prefix to filter results. Examples: "transport", "SA", "financial services". Omit to list all EBOPS categories.
  • parent_code · string · optionnel
    Return only sub-categories of this parent EBOPS code. Example: "SA" to see all transport service sub-categories.

  Exemple d'appel

  {"name": "comtrade_list_service_categories", "arguments": {"limit": 1, "query": "texte", "parent_code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "shown": 1, "notice": "texte", "truncated": true, "categories": [], "totalMatches": 1}}

• comtrade_lookup_countries≈ 984 tokens

  Resolve country and area names to Comtrade M49 numeric codes used in all data queries. Accepts a partial name, full name, or ISO alpha-2/alpha-3 code (e.g. "United States", "USA", "US"). Returns matching entries with their numeric code, ISO identifiers, and a validAsReporter flag — regional groupings like "World" (code 0) are valid partners but not valid reporters. 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.

  Paramètres, retour & exemple (3)

  Paramètres

  • role · string · optionnel · reporter | partner | any
    Filter by role: "reporter" returns only codes valid for the reporterCode parameter, "partner" returns only partner areas (includes regional groupings), "any" returns all matches regardless of role.
  • query · string · requis
    Country or area name fragment, full name, or ISO alpha-2/alpha-3 code to search for. Case-insensitive. Examples: "Germany", "DEU", "DE", "united states", "china".
  • include_groups · boolean · optionnel
    Whether to include regional and economic groupings (e.g. EU, ASEAN). Set to false to return only individual countries.

  Exemple d'appel

  {"name": "comtrade_lookup_countries", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "notice": "texte", "matches": [], "totalMatches": 1}}

• comtrade_search_commodities≈ 1132 tokens

  Find HS commodity codes by keyword, partial description, or known code prefix. Returns matched codes at the requested aggregation level (2-, 4-, or 6-digit) with full descriptions, parent code, leaf status, and a recommended_query_code field indicating the best code level for subsequent trade queries (2-digit chapter for broad analysis, 4- or 6-digit for specific products). This is the critical resolution step — agents cannot derive HS codes from product names without this tool. Use aggr_level 2 to start broad; narrow with aggr_level 4 or 6 once you have a chapter. To get all commodities for an entire chapter, pass the 2-digit code as cmd_code in trade tools.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Maximum number of results to return; above 200 returns all matching codes.
  • query · string · requis
    Keyword, partial description, or HS code prefix to search for. Examples: "motor vehicles", "8471", "coffee", "84" (chapter 84 = machinery).
  • aggr_level · ? · optionnel
    Aggregation level: 2 = HS chapter (most general), 4 = heading, 6 = subheading (most specific). Omit to return all matching levels.
  • classification · string · optionnel · HS | H0 | H1 | H2 | H3 | H4 | H5 | H6
    HS classification version. "HS" covers the combined dataset across all editions (H0–H6). Use a specific edition (e.g. "H6") for version-specific lookups.

  Exemple d'appel

  {"name": "comtrade_search_commodities", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "shown": 1, "notice": "texte", "matches": [], "truncated": true, "totalMatches": 1}}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://un-comtrade.caseyjhand.com/mcp