vatnode/vatnode-mcp

vatnode/vatnode-mcp

от vatnode
MCP-сервер для проверки VAT и данных по НДС в ЕС. AI-агенты могут узнать ставки НДС, проверить формат номера и валидировать VAT ID через VIES - бесплатно или с API-ключом для расширенной валидации.

vatnode-mcp

npm version Tests License: MIT vatnode/vatnode-mcp MCP server

Official Model Context Protocol server for vatnode — VAT validation and EU tax data for AI agents.

Lets AI assistants (Claude Desktop, Cursor, ChatGPT, Continue, Cline, …) look up VAT rates, check VAT number formats, and validate VAT IDs against the EU VIES service without leaving the chat.

  • Free, offline — VAT rates and format checks for 45 European countries, no account needed
  • Live validation — verify EU VAT numbers against VIES, get the registered company + the VIES consultation number (requires a free vatnode API key; the consultation number is produced once you set your own VAT as requester in dashboard Settings)
  • Five focused tools — well-described for accurate agent tool selection
  • Pure stdio, zero hosted dependencies, runs locally via npx

Tools

Tool Free Description
get_country_vat_rates ✅ Standard / reduced / super-reduced / parking rates + VAT number format for a country
list_eu_vat_rates ✅ All 27 EU member states (plus XI for Northern Ireland) at once
check_vat_format ✅ Offline syntactic check of a VAT number against the country regex
list_supported_countries ✅ All 45 supported countries and which ones support full VIES validation
validate_vat_number 🔑 Live VIES validation — returns validity, company name, address, registration date, and (when a requester VAT is set in dashboard Settings) the VIES consultation number
Инструменты были проиндексированы:
check_vat_formatтолько чтениеидемпотентный

Выполняет офлайн-синтаксическую проверку VAT-номера по стране-специфическому regex-шаблону. Только для чтения и офлайн: без сетевых вызовов, без API-ключа, без лимита запросов, без побочных эффектов. НЕ проверяет VAT через VIES (правильный формат не означает, что VAT реален или активен) — для этого используйте validate_vat_number. Вывод: { input, normalized, countryCode, validFormat (boolean), error }; countryCode равен null, если префикс неизвестен. Используйте, когда пользователь хочет быстро проверить формат VAT-идентификатора без траты квоты. Бесплатно, API-ключ не нужен.

Проверить формат номера VAT

Параметры
  • vatIdstringобязательный

    Номер НДС, с пробелами/дефисами или без них, с префиксом страны или без него (например, "DE123456789", "IE 6388047 V").

get_country_vat_ratesтолько чтениеидемпотентный

Возвращает стандартную, пониженную, сверхпониженную и парковочную ставки НДС для одной европейской страны, а также формат и регулярное выражение номера НДС. Работает только для чтения и офлайн: не выполняет сетевых вызовов, не требует API-ключа, не имеет ограничений по частоте запросов, не вызывает побочных эффектов. Принимает коды ISO 3166-1 alpha-2 (DE, FR, IT, …); также охватывает европейские юрисдикции за пределами ЕС, где это возможно (NO, CH, GB, UA, TR, …). Вывод: { countryCode, countryName, vatName, vatAbbr, currency, standardRate, reducedRates[], superReducedRate, parkingRate, vatNumberFormat, vatNumberPattern, identifiers, updatedAt }; ставки указаны в процентах и могут быть null, если не применимы. identifiers содержит названия (не номера) регистратора компании, реестра компаний, регистрационного номера, налогового идентификатора и идентификатора НДС, каждый с ключом в виде языка (все официальные языки плюс "en") или null, например, registryCodeName для FI: { fi: "Y-tunnus", sv: "FO-nummer", en: "Business ID" }. Возвращает ошибку, если код страны неизвестен. Используется, когда пользователь спрашивает "какая ставка НДС в X" или ему нужен формат номера НДС для страны. Бесплатно, API-ключ не требуется.

Получить ставки НДС для страны

Параметры
  • countryCodestringобязательный

    Код страны ISO 3166-1 alpha-2, например "DE", "FR", "IT".

list_eu_vat_ratesтолько чтениеидемпотентный

Возвращает текущие ставки НДС для всех государств-членов ЕС (плюс XI для Северной Ирландии). Только для чтения и офлайн: без сетевых вызовов, без API-ключа, без ограничений по частоте запросов, без побочных эффектов. Не принимает аргументов. Вывод: { rates: Array<{ countryCode, countryName, vatName, vatAbbr, currency, standardRate, reducedRates[], superReducedRate, parkingRate, vatNumberFormat, vatNumberPattern, identifiers, updatedAt }>, count, updatedAt }. Ставки указаны в процентах (например, 25.5). identifiers хранит названия (не номера) регистрирующего органа компании, реестра компаний, номера в реестре, налогового идентификатора и идентификатора НДС; каждое значение имеет ключ по языку (все официальные языки плюс "en") или null. Используйте, когда пользователь просит обзор, сравнение по странам или "все ставки НДС в ЕС". Для одной страны предпочтителен get_country_vat_rates. Данные берутся из TEDB Еврокомиссии и обновляются ежедневно. Бесплатно, API-ключ не нужен.

Список ставок НДС в ЕС

Параметры

Без параметров.

list_supported_countriesтолько чтениеидемпотентный

Возвращает все страны, по которым сервер vatnode располагает данными о НДС (EU-27 + XI для Северной Ирландии + ~17 других европейских юрисдикций, таких как NO, CH, GB, UA, TR). Только чтение и офлайн: без сетевого вызова, без API-ключа, без лимита запросов, без побочных эффектов. Не принимает аргументов. Вывод: { countries: Array<{ countryCode, countryName, isEUMember, viesValidationSupported }>, count, euCount, updatedAt }, отсортировано по countryCode. viesValidationSupported: true — значит validate_vat_number может выполнять прямую проверку VIES; для стран вне ЕС — только поиск по ставкам. Используйте, чтобы узнать покрытие или выбрать корректный countryCode перед вызовом get_country_vat_rates или validate_vat_number.

Список поддерживаемых стран

Параметры

Без параметров.

validate_vat_numberтолько чтениеидемпотентныйвнешний мир

Проверяет номер НДС ЕС через официальный сервис VIES и возвращает результат проверки, название компании, адрес, дату регистрации и другие метаданные. Номер консультации VIES (consultationNumber) возвращается, когда VAT запрашивающей стороны настроен один раз в разделе Settings панели vatnode. Это разовая настройка аккаунта, а не параметр для каждого вызова. Если запрашивающая сторона настроена, каждый ответ - либо успех с непустым consultationNumber, либо ошибка. Если нет, consultationNumber равен null, а откат к национальному реестру остаётся включённым. Используйте, когда пользователь хочет убедиться, что номер НДС настоящий, найти компанию по номеру НДС или ему нужны доказательства для бухгалтерии и комплаенса. Побочные эффекты: выполняет аутентифицированный сетевой запрос к api.vatnode.dev (который обращается к сервису EU VIES) и расходует один запрос из вашей месячной квоты; работает только на чтение (проверяет, ничего не меняет) и допускает безопасные повторные попытки. Требуется API-ключ vatnode (есть бесплатный тариф; задайте VATNODE_API_KEY). VIES поддерживает только EU-27 + XI (Северная Ирландия); для остальных стран возвращается ошибка.

Проверить VAT номер ЕС

Параметры
  • vatIdstringобязательный

    Номер НДС ЕС, с префиксом страны. Пробелы и дефисы удаляются. Примеры: «DE123456789», «IE6388047V», «FR12345678901».

1.3.0основная
1.2.0
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.0
0.3.3
0.3.2
0.3.1
0.3.0
0.2.1
0.2.0
0.1.1
0.1.0

Выберите клиент, чтобы установить vatnode/vatnode-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "vatnode-vatnode-mcp-sirg9xpfdr": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "vatnode-vatnode-mcp-sirg9xpfdr": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "vatnode-vatnode-mcp-sirg9xpfdr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"vatnode-vatnode-mcp-sirg9xpfdr\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"vatnode-mcp\"],\"env\":{\"VATNODE_API_KEY\":\"vat_live_...\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "vatnode-vatnode-mcp-sirg9xpfdr": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add vatnode-vatnode-mcp-sirg9xpfdr --env VATNODE_API_KEY=vat_live_... -- npx -y vatnode-mcp

Либо через JSON-конфиг:

claude mcp add-json vatnode-vatnode-mcp-sirg9xpfdr "{\"command\":\"npx\",\"args\":[\"-y\",\"vatnode-mcp\"],\"env\":{\"VATNODE_API_KEY\":\"vat_live_...\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add vatnode-vatnode-mcp-sirg9xpfdr --env VATNODE_API_KEY=vat_live_... -- npx -y vatnode-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.vatnode-vatnode-mcp-sirg9xpfdr]
command = "npx"
args = ["-y", "vatnode-mcp"]

[mcp_servers.vatnode-vatnode-mcp-sirg9xpfdr.env]
VATNODE_API_KEY = "vat_live_..."
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите vatnode/vatnode-mcp, а в поле команды запуска — строку ниже:
npx -y vatnode-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vatnode-vatnode-mcp-sirg9xpfdr": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "vatnode-vatnode-mcp-sirg9xpfdr": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например vatnode-vatnode-mcp-sirg9xpfdr.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: vatnode-vatnode-mcp-sirg9xpfdr
    command: npx
    args:
      - "-y"
      - "vatnode-mcp"
    env:
      VATNODE_API_KEY: vat_live_...
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "vatnode-vatnode-mcp-sirg9xpfdr": {
      "command": "npx",
      "args": [
        "-y",
        "vatnode-mcp"
      ],
      "env": {
        "VATNODE_API_KEY": "vat_live_..."
      }
    }
  }
}

Похожие MCP-сервера

Patent-PreCheck/patent-precheck-mcp

Patent-PreCheck/patent-precheck-mcp

от patent-precheck

MCP-сервер для предварительной проверки патентоспособности изобретения. Оценивает по критериям USPTO, выдаёт баллы готовности к подаче и рекомендации. Не требует API-ключей, полезен разработчикам и...

JavaScript⭐ 1
nexusforge-tools/mcp-eu-finance

nexusforge-tools/mcp-eu-finance

от nexusforge-tools

MCP-сервер для AI-агентов, предоставляющий европейские макроэкономические данные: ставки ЕЦБ, инфляцию, ВВП и безработицу по всем странам ЕС. Не требует API-ключа. Полезен разработчикам и аналитикам для интеграции актуальных финансовых показателей в свои инструменты.

TypeScript⭐ 1
AlvisoOculus/optionsahoy-mcp

AlvisoOculus/optionsahoy-mcp

от alvisooculus

MCP сервер для детерминированного расчета налогов на акционерное вознаграждение: ISO, NSO, RSU, QSBS и концентрация акций. Точные цифры, а не оценка LLM. Полезен для планирования продаж и хеджирова...

TypeScript⭐ 5
@czagents/cnb

@czagents/cnb

от martinhavel

MCP сервер для доступа к чешским и европейским госданным: ARES, ČNB, ADIS, санкции, банкротства. Встроенный агрегатор due diligence оценивает риски и строит цепочку собственников. Для комплаенса, KYC.

TypeScript⭐ 6
AgentModule/mcp

AgentModule/mcp

от agentmodule

MCP-сервер предоставляет агентам детерминированные правила и директивы EU AI Act для runtime-проверки compliance, собирает audit-прозрачные доказательства и помогает избегать штрафов. Полезен разра...

JavaScript⭐ 2
Vaquill-AI/canlii-mcp

Vaquill-AI/canlii-mcp

от vaquill-ai

MCP-сервер для доступа к канадской правовой информации CanLII. Ищите судебные дела, законодательство и цитирования через единый API. Пригодится юристам, исследователям и разработчикам ИИ.

TypeScript⭐ 7
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин