Xonta Customs RU

● Active

ru.xonta/customs

Import into Russia/EAEU: invoice parsing, TN VED codes, duties, VAT, fees, car recycling fee

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "customs": {
      "command": "uvx",
      "args": [
        "xonta-customs-mcp"
      ],
      "env": {
        "DOCPARSE_TOKEN": "<your DOCPARSE_TOKEN>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env DOCPARSE_TOKEN='<your DOCPARSE_TOKEN>' --transport stdio customs -- uvx xonta-customs-mcp
OpenAI Codex CLI
codex mcp add customs --env DOCPARSE_TOKEN='<your DOCPARSE_TOKEN>' -- uvx xonta-customs-mcp
VS Code
code --add-mcp '{"name":"customs","type":"stdio","command":"uvx","args":["xonta-customs-mcp"],"env":{"DOCPARSE_TOKEN":"<your DOCPARSE_TOKEN>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • DOCPARSE_TOKENsecretOptional bearer token for DOCPARSE_URL

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Legal & Government
Version
0.2.1
Registry
active
Published
11/16/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Xonta Customs RU is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 6 days ago (Nov 16, 2026), 0 open issues.
Official registry
Active
Published as ru.xonta/customs in the official MCP registry, version 0.2.1.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Local package or hosted
Ships as a local package (PyPI) that runs on your machine, and as a hosted endpoint at mcp.xonta.ru that receives what your client sends it.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 04:07 UTCStatus history & uptime →
● Working765 msprotocol 2025-06-18v0.2.2promptsresourcestools

The endpoint answered the MCP handshake as "Xonta Customs RU" and listed 10 tools. Answering since Nov 17, 2026.

Context cost ≈ 3.2k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 10 tools.

Tools (10)

  • tnved_search2 params

    Search the TN VED EAEU (ТН ВЭД ЕАЭС) commodity nomenclature by product words or code prefix. Returns candidate 10-digit codes with official names and the ETT import duty rate. Use the candidates to pick a code, then call tnved_code_info for details. Text search matches nomenclature wording, so use technical terms (material, function), not brand names. Results are candidates, not a classification decision.

    Show parameters
    • querystringrequiredProduct description in Russian (e.g. 'насос шестеренный гидравлический') or a code prefix like '8413' or '8413603100'
    • limitintegerMax results
  • tnved_code_info2 params

    Get everything known about one TN VED EAEU code. Returns the official name with parent headings, the ETT import duty rate parsed into ad valorem / specific / combined parts, EAEU antidumping measures that may apply (filtered by origin country if given) and EEC classification rulings for this heading.

    Show parameters
    • codestringrequiredTN VED EAEU code, 4-10 digits, spaces allowed, e.g. '8413 60 310 0'
    • origin_countryISO 3166-1 alpha-2 country of origin, e.g. 'CN', to check antidumping measures
  • calc_import_payments16 params

    Calculate import customs payments into Russia for one goods item, in RUB. Computes: import duty by the EAEU ETT rate (ad valorem, specific per kg/pcs/pair/litre, or combined 'X%, but not less than Y EUR per unit'), antidumping duty, excise, import VAT ((customs value + duty + antidumping + excise) x 22% or 10%) and the 2026 customs clearance fee by customs value bracket. Converts currencies at Bank of Russia rates. Returns a line-by-line breakdown with sources.

    Show parameters
    • customs_valuenumberrequiredCustoms value of the goods (usually CIF to the EAEU border) in `currency`
    • currencystringCurrency of customs_value: RUB, CNY, USD, EUR, etc.
    • codeTN VED EAEU code; its ETT duty rate is used if duty_rate is not given
    • duty_rateDuty rate as in the tariff, overrides the code: '10', '0', '0,6 евро за 1 кг', '15, но не менее 2,5 евро за 1 пару'
    • vat_rateintegerImport VAT rate in 2026: 22 general, 10 for goods on Government lists (some food, children's goods, medical), 0 if exempt
    • antidumping_rate_pctnumberAntidumping/countervailing/special duty rate in % of customs value, if a measure applies
    • excise_rubnumberExcise in RUB if the goods are excisable (alcohol, tobacco, fuel, cars)
    • quantity_kgNet weight in kg, needed for per-kg specific rates
    • quantity_pcsPieces, for per-piece rates
    • quantity_pairPairs (footwear)
    • quantity_lLitres
    • quantity_m2Square metres
    • quantity_cm3Engine displacement in cm3
    • exchange_ratesRUB per 1 unit, e.g. {'CNY': 11.2, 'EUR': 92.5}. If omitted, Bank of Russia rates for `on_date` are fetched
    • on_dateDeclaration date YYYY-MM-DD for exchange rates; default today
    • recycling_fee_rubnumberCar recycling fee (утильсбор) in RUB from calc_recycling_fee, to show the full cost of importing a vehicle. Not part of the VAT base
  • calc_recycling_fee8 params

    Recycling fee (утилизационный сбор) for a passenger car (category M1) imported into Russia. Uses the official coefficient table (Decree 1291 as amended by Decree 1713 of 01.11.2025): base rate 20 000 RUB x coefficient by engine type, volume, power band (kW), age and year (Dec 2025, 2026 ... 2030). Covers the commercial table and the personal-use table (0.17 / 0.26 for up to 160 hp and up to 3 l). Returns the coefficient, band and source.

    Show parameters
    • enginestringrequiredice = petrol/diesel; hybrid_parallel counts as ICE; ev = electric; hybrid_series = series hybrid (counts as EV)
    • power_hpEngine power in horsepower (л.с.); for EVs the 30-minute max power
    • power_kwEngine power in kW, alternative to power_hp
    • engine_volume_ccEngine displacement in cm3 (required for ice and hybrid_parallel)
    • older_than_3_yearsbooleanTrue if more than 3 years have passed since the production date
    • personal_usebooleanImported by an individual for personal use (preferential 3 400 / 5 200 RUB up to 160 hp and 3 l)
    • on_dateDate YYYY-MM-DD the fee is calculated for; default today. Tables run Dec 2025 - 2030
    • eaeu_extra_rubnumberFor cars released in another EAEU country: sum of Ктп + Кндс + Ка (duty, VAT, excise differences), if known
  • parse_invoice2 params

    Parse a supplier's commercial invoice or packing list into customs-ready line items. Extracts invoice number, date, parties, currency, Incoterms and country of origin, and for each line: description, model, material, supplier HS code, quantity, unit, price, amount, net and gross weight. Checks arithmetic (qty x price, sum vs total), explains what to add to the invoice value for customs value under the given Incoterms, and suggests a TN VED search query per line (HS code first 6 digits or Russian keywords). Feed the lines to tnved_search and calc_import_payments.

    Show parameters
    • invoice_textInvoice or packing list as Markdown or plain text, e.g. the output of DocParse. Tables with English, Chinese (品名, 数量, 单价, 金额, 净重) or Russian headers
    • file_urlPublic link to the invoice file: .xlsx/.csv are parsed directly; PDF/scans/DOCX go through DocParse when the server has it configured
  • customs_clearance_fee1 param

    Customs clearance fee (сбор за таможенные операции) for an import declaration into Russia in 2026. The fee depends on the total customs value of the declaration: from 1 231 RUB (up to 200 000) to 73 860 RUB (over 10 million). Also returns the full bracket table and the legal source.

    Show parameters
    • total_customs_value_rubnumberrequiredTotal customs value of all goods in the declaration, RUB
  • antidumping_check3 params

    Check EAEU trade defence measures (antidumping duties) by code, product and origin country. Returns matching measures with the Eurasian Economic Commission decision, the decision that sets duty rates per producer, expiry date and a link. The bundled list covers measures renewed in 2026 and is not exhaustive: absence of a match is not proof that no measure applies.

    Show parameters
    • codeTN VED EAEU code or prefix
    • origin_countryISO alpha-2 country of origin, e.g. CN, UA, AZ
    • productProduct words in Russian or English, e.g. 'грузовые шины'
  • classification_rulings_search2 params

    Search EEC (Eurasian Economic Commission) decisions on classification of specific goods. These decisions are binding for all EAEU customs and are the strongest evidence for a code. Returns the decision number and date, the product, the TN VED code or heading and a source link.

    Show parameters
    • queryProduct words, e.g. 'прицел тепловизионный'
    • codeTN VED code or heading, e.g. '9013'
  • exchange_rates2 params

    Official Bank of Russia exchange rates (RUB per 1 unit) used for customs payments.

    Show parameters
    • currenciesCurrency codes, e.g. ['CNY','USD','EUR']; all if omitted
    • on_dateDate YYYY-MM-DD; default today
  • server_status

    Data versions of this server: tariff load date and source, antidumping and rulings list dates, fee table source.

Checked by Serverdex with a plain initialize + tools/list call to mcp.xonta.ru/customs/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 16, 2026
Stars
0
Forks
0
Last push
Nov 16, 2026
License
MIT

Pythoncustomseaeuhs-codeimportmcpmcp-servermodel-context-protocoltnved

From the README

Xonta Customs RU MCP server for importing goods into Russia and the Eurasian Economic Union (EAEU). Free and open source. Русская версия ниже What it does Gives an AI agent the customs tools a Russian broker uses every day: What sets it apart: • Specific and combined rates. "10%, but not less than 2 EUR per pair" is parsed and computed, not skipped. • Every number has a source. Fees cite the Government decree, measures cite EEC decisions, rates cite the Bank of Russia. • No made-up numbers. If a rate can't be parsed or a measure's rate is unknown, the server says so and asks for it. • Russian legal context for 2026: VAT 22%, new customs fee scale, EAEU trade defence measures, the December 2025 power-based recycling fee for cars. • From invoice to payments. A Chinese invoice goes in, customs-ready lines come out: the supplier's HS code is used as the first 6 digits of TN VED, Incoterms tell what to add for customs value. All results are informational. The final code and payments are decided by the declarant and customs. Connect Hosted (no install) Claude Desktop / Cursor / any client with remote MCP support: Local (stdio) The local server needs the tariff table for code search (calculation works without it if you pass the rate): Any .xlsx or .csv with a header row containing a code column and a name column works; the duty rate and unit columns are picked up when present. Example Shoes with leather uppers from China, 1 000 pairs, invoice value 20 000 CNY.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://mcp.xonta.ru/customs/mcp

The most-starred Legal & Government servers in the index, with their live-check result.

ServerStarsLast pushLive check
Korean Law MCP2,891Nov 2026Working
EdgarTools2,859Nov 2026Local / not checked
Global law2,167Nov 2026Working
MCP Fiscal Brasil433Nov 2026Local / not checked
Legal Data Hunter422Nov 2026Needs sign-in

Xonta Customs RU: questions people ask

Is Xonta Customs RU a remote or a local MCP server?
According to its entry in the official MCP registry, Xonta Customs RU ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (PyPI) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
Does Xonta Customs RU need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Xonta Customs RU safe to use?
Looks healthy: Xonta Customs RU is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Local package or hosted; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Xonta Customs RU still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 16, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 16, 2026.
What tools does Xonta Customs RU expose?
10 tools as listed by the server itself during the live check, including tnved_search, tnved_code_info, calc_import_payments, calc_recycling_fee, parse_invoice. The full list with parameters is in the Live check section above.
How do I add Xonta Customs RU to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.

More from mrsergeiluzhnov

All 3 servers by mrsergeiluzhnov →
  1. Xonta MAXMAX messenger bots and mini-apps in English or Russian: Bot API, code checks, Telegram migration
  2. Xonta Docs RURussian docs for AI agents: invoices/acts PDF, document parsing, INN checks, medical ad checks
Browse all Legal & Government →

Add the badge to your site

Show visitors that Xonta Customs RU is listed here — it’s also the link we check for a free listing.

Xonta Customs RU — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/ru-xonta-customs?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Xonta Customs RU — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Xonta Customs RU — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/ru-xonta-customs?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/ru-xonta-customs) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/ru-xonta-customs) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/ru-xonta-customs)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/ru-xonta-customs"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/ru-xonta-customs"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/ru-xonta-customs"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).