Skip to content
View bartosz-kuc's full-sized avatar

Block or report bartosz-kuc

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
bartosz-kuc/README.md

Bartosz Kuć

🇬🇧 English · 🇵🇱 Polski

English

Warsaw-based developer. JDG owner running skanfirmy.pl. Day job in process automation at a global ad-tech company.

Products

  • skanfirmy.pl — free tools to verify Polish companies by tax ID (NIP), straight from official government registers. 9 tools: VAT White List, KRS registry, REGON registry, bank account verification, tax micro-account, PKD 2025 codes, late-payment interest, EU VIES, and bulk NIP lookup (up to 30 tax IDs at once, CSV/JSON export). Every tool is also callable by AI agents via MCP server (9 JSON-RPC tools) or plain REST: /nip/{number}, /nips/{list}, /regon/{number}, /vies/{country}/{number}. No key, no login.
  • otwarteapi.pl — directory of Polish and EU public APIs described so they can be discovered and called by AI agents and people. 22 entries across VAT, KRS, GUS, NBP, ECB, Eurostat and single-country statistics offices. Bilingual PL/EN, following the Agentic Resource Discovery spec (ai-catalog.json). Catalog data is public on bartosz-kuc/otwarteapi-catalog — PRs welcome.
  • polish-company-utils — zero-dependency npm library: validate Polish NIP/REGON/PESEL/IBAN and generate the tax micro-account. The same checksum logic that powers skanfirmy.pl, extracted for developers.
  • skanfirmy-mcp — the skanfirmy.pl MCP server documented for AI agents (9 tools, no key), with its Model Context Protocol registry manifest.

honest-mcp — 13 open-source local MCP servers

A family of small, auditable MCP servers that let AI clients (Claude, Cursor, Zed) reach real services without a cloud middleman. Every server runs on your own machine and talks directly to the actual service API. No hosted MCP host, no data collection, no third-party token custody. MIT.

Your AI client ↔ MCP stdio ↔ this server (on your Mac) ↔ HTTPS ↔ real service

Polish accounting & business

Repo What
honest-mbank-parser-mcp Parses mBank CSV exports fully offline — no network calls at all
honest-nbp-mcp NBP FX rates + gold fixing — accounting-grade conversion helpers
honest-vies-mcp EU VAT check with consultation number for audit proof
honest-nip-krs-mcp Biała Lista MF + KRS registry lookups
honest-pl-holidays-mcp Business-day math that respects Polish public holidays

Polish public data

Repo What
honest-stat-gov-mcp GUS Bank Danych Lokalnych — public statistics down to the gmina
honest-nfz-mcp NFZ waiting lists and medical service dictionary
honest-imgw-mcp IMGW weather, hydro data, and active meteorological warnings
honest-gios-air-mcp GIOŚ air quality — station data and composite index

Google (self-hosted alternatives)

Repo What
honest-gmail-mcp Gmail — send, search, label, draft
honest-calendar-mcp Google Calendar
honest-drive-mcp Drive with full permission management — the piece missing from the official connector

Utility

Repo What
honest-rss-mcp RSS/Atom feed reader

Quality

Each server is ~150–300 lines of Python — auditable in one sitting.

Every repo ships the same automation stack:

  • Dependabot weekly version and security updates
  • GitHub CodeQL SAST on every push and PR
  • CI matrix on Python 3.10–3.13
  • Secret scanning with push protection
  • MIT licensed, verified commits

Consulting

Available for consulting on Polish tax and business integrations (KSeF, GUS/NFZ/GIOŚ APIs, mBank data), MCP server design, and AI-assisted tooling for JDGs and small teams.


Polski

Deweloper z Warszawy. Prowadzę JDG, w ramach której działa skanfirmy.pl. Na co dzień zajmuję się automatyzacją procesów w globalnej firmie z branży ad-tech.

Produkty

  • skanfirmy.pl — bezpłatne narzędzia do weryfikacji polskich firm po numerze NIP, prosto z oficjalnych rejestrów rządowych. 9 narzędzi: Biała Lista VAT, KRS, REGON, weryfikacja rachunku, mikrorachunek podatkowy, kody PKD 2025, kalkulator odsetek, VIES, oraz zbiorcze sprawdzanie NIP-ów (do 30 na jedno wywołanie, eksport CSV/JSON). Wszystkie narzędzia są też dostępne dla agentów AI przez serwer MCP (9 narzędzi JSON-RPC) i zwykłe REST-y: /nip/{numer}, /nips/{lista}, /regon/{numer}, /vies/{kraj}/{numer}. Bez klucza, bez logowania.
  • otwarteapi.pl — katalog polskich i unijnych publicznych API, opisanych tak by mogły być odkrywane i wywoływane przez agentów AI oraz ludzi. 22 pozycje: VAT, KRS, GUS, NBP, EBC, Eurostat i statystyki pojedynczych krajów UE. Dwujęzycznie PL/EN, zgodny ze specyfikacją Agentic Resource Discovery (ai-catalog.json). Dane katalogu publiczne w bartosz-kuc/otwarteapi-catalog — PR-y mile widziane.
  • polish-company-utils — biblioteka npm bez zależności: walidacja NIP/REGON/PESEL/IBAN i generator mikrorachunku. Ten sam kod, który napędza skanfirmy.pl, wyciągnięty dla programistów.
  • skanfirmy-mcp — serwer MCP skanfirmy.pl udokumentowany dla agentów AI (9 narzędzi, bez klucza), z manifestem do rejestru Model Context Protocol.

honest-mcp — 13 otwartoźródłowych, lokalnych serwerów MCP

Rodzina małych, łatwych do zaudytowania serwerów MCP, które pozwalają klientom AI (Claude, Cursor, Zed) korzystać z prawdziwych usług bez chmurowego pośrednika. Każdy serwer działa na Twoim własnym komputerze i łączy się bezpośrednio z prawdziwym API danej usługi. Brak hostowanego serwera MCP, brak zbierania danych, brak przechowywania tokenów przez stronę trzecią. Licencja MIT.

Twój klient AI ↔ MCP stdio ↔ ten serwer (na Twoim Macu) ↔ HTTPS ↔ prawdziwa usługa

Księgowość i biznes

Repo Co robi
honest-mbank-parser-mcp Parsuje wyciągi CSV z mBanku całkowicie offline — bez żadnych połączeń sieciowych
honest-nbp-mcp Kursy walut NBP + fixing złota — przeliczenia na potrzeby księgowości
honest-vies-mcp Weryfikacja VAT UE (VIES) z numerem konsultacji jako dowodem na potrzeby audytu
honest-nip-krs-mcp Wyszukiwanie w Białej Liście MF oraz w rejestrze KRS
honest-pl-holidays-mcp Obliczenia dni roboczych uwzględniające polskie święta

Polskie dane publiczne

Repo Co robi
honest-stat-gov-mcp GUS Bank Danych Lokalnych — dane statystyczne aż do poziomu gminy
honest-nfz-mcp Listy oczekujących NFZ i słownik świadczeń medycznych
honest-imgw-mcp Dane pogodowe i hydrologiczne IMGW oraz aktywne ostrzeżenia meteorologiczne
honest-gios-air-mcp Jakość powietrza GIOŚ — dane ze stacji pomiarowych i indeks jakości powietrza

Google (własne, samodzielnie hostowane alternatywy)

Repo Co robi
honest-gmail-mcp Gmail — wysyłanie, wyszukiwanie, etykiety, szkice
honest-calendar-mcp Google Calendar
honest-drive-mcp Drive z pełnym zarządzaniem uprawnieniami — element, którego brakuje w oficjalnym konektorze

Narzędzia

Repo Co robi
honest-rss-mcp Czytnik kanałów RSS/Atom

Jakość

Każdy serwer to ok. 150–300 linii kodu w Pythonie — do zaudytowania w jednym posiedzeniu.

Każde repo ma ten sam zestaw automatyzacji:

  • Cotygodniowe aktualizacje wersji i bezpieczeństwa (Dependabot)
  • Statyczna analiza bezpieczeństwa GitHub CodeQL przy każdym pushu i PR
  • Macierz CI na Pythonie 3.10–3.13
  • Skanowanie sekretów z blokadą push
  • Licencja MIT, podpisane commity

Consulting

Dostępny do współpracy przy integracjach podatkowo-biznesowych (KSeF, API GUS/NFZ/GIOŚ, dane mBank), projektowaniu serwerów MCP oraz narzędziach AI dla JDG i małych zespołów.

Popular repositories Loading

  1. honest-mbank-parser-mcp honest-mbank-parser-mcp Public

    Local MCP server that parses mBank CSV operation exports — fully offline

    Python 1

  2. llms-txt-hub llms-txt-hub Public

    Forked from thedaviddias/llms-txt-hub

    🤖 The largest directory for AI-ready documentation and tools implementing the proposed llms.txt standard

    TypeScript

  3. awesome-apis awesome-apis Public

    Forked from brandonhimpfen/awesome-apis

    A curated list of high-quality APIs, SDKs, developer tools, open data sources, and API design resources.

    Python

  4. otwarteapi-catalog otwarteapi-catalog Public

    Catalog data behind otwarteAPI.pl — Polish and EU public government APIs in ai-catalog.json (ARD) format

  5. honest-nip-krs-mcp honest-nip-krs-mcp Public

    Local MCP server for Polish company registries — Biała Lista MF + KRS

    Python

  6. honest-nbp-mcp honest-nbp-mcp Public

    Local MCP server for NBP FX rates + gold fixing (Polish accounting-friendly)

    Python