Koskamo

CustomsWise MCP

An MCP server providing practitioner-verified EU customs guidance, including HS classification, duty rates, origin rules, and restriction flags for AI agents.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

CustomsWise MCP logo, by Giuseppe AqueciCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by Giuseppe Aqueci
MCP endpoint (Streamable HTTP)
https://customswise-api.onrender.com/mcp
Vendor documentation

What its tools do

7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

7 of 7 have a description · 0 of 7 declare behavior hints · 6 of 6 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Retrieve HS/CN classification support and restriction flags
  • Get import duty and VAT reference for an HS/CN code
  • Check licences, prohibitions, sanctions and dual-use flags
  • Query preferential origin rules and proof of origin

Source and maintenance

Community listingRegistry 0.1.0

Protocol and capabilities

Server
CustomsWise 0.1.0
MCP protocol negotiated in check
2025-11-25
Tools
7 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

7 advertised

list_catalog
Advertised by the server during the last successful anonymous check.

FREE. Directory of everything CustomsWise can answer, and how much expert-verified content is available right now. Returns, per category — classification support, import duty & VAT, restrictions/sanctions, preferential origin, special procedures, and the natural-language FAQ — the count of verified entries, the tool that serves it and its price, plus supported languages (en/it). Call this FIRST to discover the paid tools and confirm verified content exists before spending. All answers are reviewed by a licensed customs professional.

list_catalog input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
classify_product
Advertised by the server during the last successful anonymous check.

Expert-verified EU/Italy customs classification support. Give a plain-language product description and get the likely HS/CN tariff heading orientation, the classification reasoning/notes, and any import-restriction flags — reviewed and signed by a licensed customs professional. Use it before shipping cross-border to avoid a wrong HS code, which causes fines, seized goods and back-duties. Guidance only, NOT a legally binding Tariff Information (BTI/ITV); genuinely ambiguous cases are flagged for expert escalation. Cost: $0.50 per call, paid automatically via x402 (USDC micropayment over HTTP 402).

classify_product input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Plain-language description of the product to classify — include material, function and form for a better match, e.g. 'stainless steel vacuum flask with plastic lid' or 'men's cotton knitted t-shirt'."
    },
    "lang": {
      "type": "string",
      "description": "Response language: 'en' (default) or 'it'."
    }
  }
}
get_tariff
Advertised by the server during the last successful anonymous check.

Expert-verified import duty and Italian import VAT for any EU HS/CN code. Returns the practitioner-verified third-country duty where available; for every other valid code it still returns the normalized/validated code, the applicable Italian import VAT rate, and a direct deep link to the official EU TARIC page — so you always get a usable answer. Use it to estimate landed cost or confirm the duty on a classified good. Duty rates change over time, so treat this as reference, not a binding ruling. Cost: $0.25 per call, paid automatically via x402 (USDC micropayment over HTTP 402). Example code: '6109100010'.

get_tariff input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "code": {
      "type": "string",
      "description": "HS/CN tariff code to look up (6-10 digits; spaces or dots allowed), e.g. '6109 10 00' or '8471300000'."
    },
    "lang": {
      "type": "string",
      "description": "Response language: 'en' (default) or 'it'."
    }
  }
}
check_restrictions
Advertised by the server during the last successful anonymous check.

Expert-verified EU import/export restriction screening. Give a product, HS code or country and get known prohibitions, licence/authorisation requirements, sanctions exposure and dual-use flags, reviewed by a licensed customs professional. Use it to check whether goods can legally move before you ship. High-risk topics (Russia/sanctions clearance, dual-use determinations) are NEVER answered autonomously — they are flagged for mandatory expert escalation. Guidance only, not binding advice. Cost: $0.25 per call, paid automatically via x402 (USDC micropayment over HTTP 402).

check_restrictions input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Product, HS code or country to screen, e.g. 'drone with camera', '8525' or 'export to Russia'."
    },
    "lang": {
      "type": "string",
      "description": "Response language: 'en' (default) or 'it'."
    }
  }
}
get_origin_rule
Advertised by the server during the last successful anonymous check.

Expert-verified preferential rules of origin for EU trade agreements. Give a product or an agreement and get the applicable rule of origin (e.g. tariff-shift or value-added criteria) plus how origin must be proven — EUR.1 movement certificate, statement on origin, or the REX registered-exporter system — reviewed by a licensed customs professional. Use it to determine whether goods qualify for a reduced/zero preferential duty and what documentation is required. Guidance only, not binding advice. Cost: $0.50 per call, paid automatically via x402 (USDC micropayment over HTTP 402).

get_origin_rule input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Product or trade agreement to check, e.g. 'olive oil' or 'EU-South Korea EUR.1'."
    },
    "lang": {
      "type": "string",
      "description": "Response language: 'en' (default) or 'it'."
    }
  }
}
get_procedure
Advertised by the server during the last successful anonymous check.

Expert-verified explanation of EU special customs procedures: inward processing, outward processing, returned goods relief, and temporary admission. Returns the purpose, eligibility conditions, required documents and practical notes for the chosen regime, reviewed by a licensed customs professional. Use it to understand how to suspend or reclaim duty/VAT when goods are processed, repaired or temporarily moved across the EU border. Complex regime structuring is flagged for expert escalation. Guidance only, not binding advice. Cost: $0.25 per call, paid automatically via x402 (USDC micropayment over HTTP 402).

get_procedure input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Special-regime keyword(s), e.g. 'inward processing', 'temporary admission', 'returned goods relief' or 'repair'."
    },
    "lang": {
      "type": "string",
      "description": "Response language: 'en' (default) or 'it'."
    }
  }
}
ask_customs
Advertised by the server during the last successful anonymous check.

Ask a general EU/Italy customs question in natural language and get a practitioner-verified answer. Covers common real-world topics such as the required import-documentation checklist, duties on goods from China, transfer-of-residence duty/VAT relief, temporary admission / inward processing for repair, and Italy-San Marino trade formalities. Use it when you don't know which specialised tool fits, or for procedural 'how do I…' questions. Guidance only, not binding advice; high-risk cases are flagged for expert escalation. Cost: $0.25 per call, paid automatically via x402 (USDC micropayment over HTTP 402).

ask_customs input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Your customs question in plain language, e.g. 'What documents do I need to import from China?' or 'Do I pay duty moving personal goods to Italy from outside the EU?'."
    }
  }
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1089 ms
95th percentile latency
1089 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1089 ms · metadata changed · 7 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http customswise-mcp https://customswise-api.onrender.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add customswise-mcp --url https://customswise-api.onrender.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable customswise-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "customswise-mcp": {
      "url": "https://customswise-api.onrender.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "customswise-mcp": {
      "type": "streamableHttp",
      "url": "https://customswise-api.onrender.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start customswise-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "customswise-mcp": {
      "type": "http",
      "url": "https://customswise-api.onrender.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http customswise-mcp https://customswise-api.onrender.com/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://customswise-api.onrender.com/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "customswise-mcp": {
      "serverUrl": "https://customswise-api.onrender.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like CustomsWise MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.