skanfirmy

Verify Polish companies by NIP, KRS or REGON and validate EU VAT numbers via VIES, straight from official government registers (Ministry of Finance VAT white…

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Sprawdz Nip: Check VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP.
  • Sprawdz Lista Nip: Bulk-check up to 30 NIPs in one call to the Ministry of Finance VAT White List: VAT status, bank accounts, REGON, KRS and address of each entity. For verifying a portfolio of counte
  • Sprawdz Regon: Look up entity data in the REGON register (Statistics Poland / GUS BIR) by NIP: REGON number, official name, legal form (legal or natural person), full address (voivodeship, county, mun

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Verify Polish companies by NIP, KRS or REGON and validate EU VAT numbers via VIES, straight from official government registers (Ministry of Finance VAT white list, KRS, Statistics Poland / GUS). Also checks bank accounts against the white list, generates the tax micro-account, searches PKD activity codes and computes statutory interest. Hosted, keyless, no signup. 14 tools.

Как подключить

Как подключить skanfirmy к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://skanfirmy--firma.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить skanfirmy к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://skanfirmy--firma.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить skanfirmy к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://skanfirmy--firma.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (14)

Технические названия из tools/list. Нужны только разработчикам.

sprawdz_nipCheck VAT status (VAT White List / Biała Lista) and KRS data for a Polish company by NIP.
sprawdz_lista_nipBulk-check up to 30 NIPs in one call to the Ministry of Finance VAT White List: VAT status, bank accounts, REGON, KRS and address of each entity. For verifying a portfolio of counterparties. Ministry limits: max 30 NIPs per call, about 500 bulk queries/day per IP. Does not fetch full KRS data (use sprawdz_nip for individual entities).
sprawdz_regonLook up entity data in the REGON register (Statistics Poland / GUS BIR) by NIP: REGON number, official name, legal form (legal or natural person), full address (voivodeship, county, municipality). Covers ALL entities, including sole proprietors that are not in the KRS.
sprawdz_viesValidate a counterparty's EU VAT number in the VIES system (European Commission).
sprawdz_rachunekCheck whether a bank account number (NRB) appears in the VAT White List for a given NIP. Due diligence for payments above PLN 15,000.
generuj_mikrorachunekGenerate the individual tax micro-account (for PIT/CIT/VAT payments) from a NIP or PESEL.
szukaj_pkdSearch PKD 2025 business activity codes by activity name or code number.
oblicz_odsetkiCalculate statutory or commercial (B2B) late-payment interest, broken down by NBP reference-rate periods.
szukaj_katalog_apiSearch otwarteAPI.pl, a catalog of public Polish and EU APIs (VAT, KRS, GUS, NBP, ECB, Eurostat and more). Returns matching entries with a link to each API's official docs. An empty query returns the whole catalog (optionally narrowed by scope or topic).
observe_nipAdd a NIP to monitoring. You get notified (via changes_since or email) when its VAT status or bank account on the Ministry of Finance White List changes. Requires a skanfirmy API key (Authorization: Bearer, or the api_key argument). Free plan: up to 10 NIPs.
unobserve_nipRemove a NIP from monitoring. Requires a skanfirmy API key.
list_observationsReturn the list of NIPs you monitor, with their current VAT status and last-checked date. Requires a skanfirmy API key.
changes_sinceReturn changes (VAT status or bank accounts) detected since a given date for the NIPs you monitor. A polling channel for agents. Requires a skanfirmy API key.
set_webhookSet (or clear) a push webhook URL for your monitoring, instead of or in addition to polling. When we detect a change for a monitored NIP, we send a POST signed with HMAC-SHA256 (X-Skanfirmy-Signature header). Returns the secret ONCE. Pass an empty url to disable. Requires a skanfirmy API key. Public https addresses only (port 443).