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.

Related MCP server: Bankr Industrial Customs MCP

Connect

Hosted (no install)

https://mcp.xonta.ru/customs/mcp

Claude Desktop / Cursor / any client with remote MCP support:

{
  "mcpServers": {
    "xonta-customs": { "url": "https://mcp.xonta.ru/customs/mcp" }
  }
}

Local (stdio)

uvx xonta-customs-mcp

{
  "mcpServers": {
    "xonta-customs": { "command": "uvx", "args": ["xonta-customs-mcp"] }
  }
}

The local server needs the tariff table for code search (calculation works without it if you pass the rate):

uvx --from xonta-customs-mcp xonta-customs-load-tariff tnved.xlsx --source "ETT EAEU, export of 05.11.2026"

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. What will customs cost?

The agent calls tnved_search("обувь с верхом из натуральной кожи"), then calc_import_payments(customs_value=20000, currency="CNY", code="6403990000", quantity_pair=1000) and gets duty by the specific part of the combined rate, VAT 22% on top, the 2026 fee and the total.

Here is the supplier's invoice (PDF). Work out the payments.

parse_invoice(file_url=...) returns three lines with quantities, prices, net weights and HS codes, plus a note that FOB terms need freight and insurance added. Each line then goes through tnved_search and calc_import_payments.

A 2 l, 170 hp car, 2 years old, imported by a company. Recycling fee?

calc_recycling_fee(engine="ice", power_hp=170, engine_volume_cc=1998) → coefficient 45, 900 000 RUB in 2026.

Data and sources

Contributions of new measures and rulings are welcome: edit src/xonta_customs/data/*.json and open a PR.

Self-hosting

pip install xonta-customs-mcp
xonta-customs-load-tariff tnved.xlsx
ALLOWED_HOSTS=mcp.example.com xonta-customs-mcp --http --host 127.0.0.1 --port 8765

Endpoints: /mcp (Streamable HTTP), /health, /.well-known/mcp/server-card.json. See deploy/ for systemd and nginx examples, and Dockerfile.

PDF and scanned invoices are converted to Markdown by DocParse (io.github.mrsergeiluzhnov/docparse in the MCP registry). Set DOCPARSE_URL (endpoint that takes {"url": ...} and returns Markdown) and optionally DOCPARSE_TOKEN. Without it, .xlsx/.csv invoices still work, and any client can pass invoice text directly in invoice_text. File links pointing to private or local addresses are refused.

Development

pip install -e ".[dev]"
pytest

License

MIT. Made by Xonta.

Xonta Customs RU — по-русски

Бесплатный MCP-сервер для импорта в Россию и ЕАЭС. Даёт ИИ-агенту инструменты таможенного брокера.

Инструменты

Чем отличается

• Считает специфические и комбинированные ставки: «10%, но не менее 2 евро за пару».

• У каждой цифры есть источник: постановление, решение ЕЭК, курс ЦБ.

• Не выдумывает цифры: если ставку не удалось разобрать или размер антидемпинговой пошлины неизвестен, сервер прямо об этом говорит.

• Учитывает 2026 год: НДС 22%, новая шкала сборов, действующие меры защиты рынка ЕАЭС, утильсбор по мощности.

• От инвойса до платежей: китайский инвойс на входе, готовые строки для расчёта на выходе.

Результаты справочные. Окончательно код и платежи определяют декларант и таможня.

Подключение

Удалённо, без установки

https://mcp.xonta.ru/customs/mcp

Claude Desktop, Cursor и любой клиент с поддержкой удалённых MCP-серверов:

{
  "mcpServers": {
    "xonta-customs": { "url": "https://mcp.xonta.ru/customs/mcp" }
  }
}

Локально (stdio)

uvx xonta-customs-mcp

{
  "mcpServers": {
    "xonta-customs": { "command": "uvx", "args": ["xonta-customs-mcp"] }
  }
}

Для поиска кодов локальному серверу нужна таблица ТН ВЭД. Расчёт работает и без неё, если передать ставку:

uvx --from xonta-customs-mcp xonta-customs-load-tariff tnved.xlsx --source "ЕТТ ЕАЭС, выгрузка от 05.11.2026"

Подойдёт любой .xlsx или .csv со строкой заголовков, где есть колонки кода и наименования. Колонки ставки и единицы измерения подхватываются, если они есть.

Примеры

Обувь с верхом из натуральной кожи из Китая, 1 000 пар, по инвойсу 20 000 юаней. Сколько заплатим на таможне?

Агент вызывает tnved_search("обувь с верхом из натуральной кожи"), затем calc_import_payments(customs_value=20000, currency="CNY", code="6403990000", quantity_pair=1000) и получает пошлину по специфической части комбинированной ставки, НДС 22% сверху, сбор 2026 года и итог.

Вот инвойс поставщика (PDF). Посчитай платежи.

parse_invoice(file_url=...) возвращает три позиции с количеством, ценами, весом нетто и HS-кодами, и предупреждает, что при условиях FOB к таможенной стоимости нужно добавить фрахт и страховку. Дальше каждая позиция проходит через tnved_search и calc_import_payments.

Автомобиль 2 л, 170 л. с., 2 года, ввозит компания. Какой утильсбор?

calc_recycling_fee(engine="ice", power_hp=170, engine_volume_cc=1998) → коэффициент 45, 900 000 рублей в 2026 году.

Данные и источники

Новые меры и решения можно добавить самому: правьте src/xonta_customs/data/*.json и присылайте pull request.

Своя установка

pip install xonta-customs-mcp
xonta-customs-load-tariff tnved.xlsx
ALLOWED_HOSTS=mcp.example.com xonta-customs-mcp --http --host 127.0.0.1 --port 8765

Адреса: /mcp (Streamable HTTP), /health, /.well-known/mcp/server-card.json. Примеры для systemd и nginx в папке deploy/, есть Dockerfile.

PDF и сканы инвойсов переводятся в Markdown через DocParse (io.github.mrsergeiluzhnov/docparse в реестре MCP). Укажите DOCPARSE_URL (адрес, который принимает {"url": ...} и отдаёт Markdown) и при необходимости DOCPARSE_TOKEN. Без этого инвойсы в .xlsx/.csv всё равно разбираются, а текст инвойса клиент может передать сам в invoice_text. Ссылки на файлы с частных и локальных адресов сервер не открывает.

Разработка

pip install -e ".[dev]"
pytest

Лицензия

MIT. Сделано в Xonta.