FreightUtils MCP Server — MCP-сервер для Claude Code
Справочник и калькулятор для логистики: агент считает объёмный вес, LDM, пошлины и проверяет опасные грузы по ADR. Каждый ответ со ссылкой на источник.
claude mcp add --transport http freightutils https://www.freightutils.com/api/mcpЧто делает FreightUtils MCP Server
Сервер даёт агенту 25 инструментов для расчётов и справок по автоперевозкам, авиа и морю. Среди них ldm_calculator, cbm_calculator, chargeable_weight_calculator, container_lookup, unit_converter, consignment_calculator и emissions_calculator для CO2e по методу ISO 14083 / GLEC на открытых факторах DEFRA, EPA и ADEME.
Отдельный блок — опасные грузы и таможня. adr_lookup ищет по 2 939 записям UNECE ADR 2025, adr_exemption_calculator проверяет малое количество по 1.1.3.6, adr_lq_eq_check — LQ и EQ. Для тарифа есть hs_code_lookup по 6 940 кодам HS 2022, uk_duty_calculator на живых данных GOV.UK Trade Tariff и incoterms_lookup. Справочные инструменты закрывают авиакомпании, аэропорты, UN/LOCODE и типы ULD. validate находит в тексте номера контейнеров по ISO 6346, AWB и IMO и проверяет контрольные разряды.
Ответы детерминированные, с блоком _source — орган, редакция, лицензия и статус проверки. Это справка, а не подача документов и не юридическая консультация: чистая проверка ics2_check не означает принятия ENS, а validate делает только структурную проверку контрольного разряда. Анонимно доступно 25 запросов в сутки на IP, поэтому для регулярной работы понадобится ключ в переменной FREIGHTUTILS_API_KEY — пакет читает её из process.env и добавляет Authorization: Bearer <key> к запросам.
Какие задачи решает
- посчитать загрузочные метры для европейского или американского трейлера
- перевести объёмный вес в оплачиваемый для авиаперевозки
- проверить, попадает ли партия под исключение по ADR 1.1.3.6
- найти код ТН ВЭД и посчитать пошлину и НДС при импорте в Великобританию
- выловить в строке бронирования номера контейнеров и AWB с ошибкой в контрольном разряде
Примеры запросов агенту
- Посчитай оплачиваемый вес для коробки 120×80×100 см и 45 кг, рейс авиа
- Проверь по ADR, можно ли везти UN 1789 малым количеством
- Найди код HS 2022 для кофемолки и посчитай пошлину при ввозе в Великобританию
Как установить FreightUtils MCP Server
1Командой платформы: удалённый сервер
claude mcp add --transport http freightutils https://www.freightutils.com/api/mcp2Командой платформы
claude mcp add freightutils-mcp-server -- npx -y freightutils-mcp1Командой платформы: удалённый сервер
codex mcp add freightutils-mcp-server --url https://www.freightutils.com/api/mcp2Командой платформы
codex mcp add freightutils-mcp-server -- npx -y freightutils-mcpФайл настроек
{
"mcpServers": {
"freightutils-mcp-server": {
"url": "https://www.freightutils.com/api/mcp"
}
}
}{
"mcpServers": {
"freightutils-mcp-server": {
"command": "npx",
"args": [
"-y",
"freightutils-mcp"
]
}
}
}Файл настроек
{
"servers": {
"freightutils-mcp-server": {
"type": "http",
"url": "https://www.freightutils.com/api/mcp"
}
}
}{
"servers": {
"freightutils-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"freightutils-mcp"
]
}
}
}1Командой платформы: удалённый сервер
gemini mcp add -t http freightutils-mcp-server https://www.freightutils.com/api/mcp2Командой платформы
gemini mcp add freightutils-mcp-server npx -y freightutils-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о FreightUtils MCP Server
Как установить FreightUtils MCP Server в Claude Code?
Добавьте удалённый сервер командой claude mcp add --transport http freightutils https://www.freightutils.com/api/mcp. Если нужен локальный запуск через npm, используйте claude mcp add freightutils-mcp-server -- npx -y freightutils-mcp.
Что делает FreightUtils MCP Server?
Даёт агенту 25 инструментов для расчётов и справок по грузоперевозкам: LDM, CBM, оплачиваемый вес, контейнеры, ADR, коды HS, пошлины, Incoterms, аэропорты и UN/LOCODE. Каждый ответ сопровождается ссылкой на источник.
Нужен ли ключ API для работы?
Без ключа сервер отвечает анонимно, но не больше 25 запросов в сутки на IP. Для большего лимита задайте FREIGHTUTILS_API_KEY в окружении, где запущен сервер.
