Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents

REMOTE · FIRMY.AI

Polish companies and people: KRS, CEIDG, financials, boards, VAT, sanctions. Free, no API key.

Available components

73 Trust /100

Last scanned (3 hours ago)

Scores higher than 60% of remote servers

Reachable. Last reached 5 Nov 2026.

Category CRM and Sales

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security74
Transport & Reachability100
Schema Quality & AI Usability76
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 3062 tokens (~382/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management10
  • Stability observed for 3 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 5 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

  • 3 Nov 26 +1
    • Stability: unverified → 0.03 ▲ functional
  • 2 Nov 26 71

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 5 Nov 2026 · Probed https://firmy.ai/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=firmy.ai CN=WE1,O=Google Trust Services,C=US 22 Oct 2026 20 Jan 2027 ECDSA 256 ECDSA-SHA256 21fda31ee2be7cf913483d5bd1e79135
SANs: firmy.ai, powiadomienia.firmy.ai, *.powiadomienia.firmy.ai
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of firmy.ai. — Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
ai. present 1814, 3799 8, 8 Verified
firmy.ai. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://firmy.ai/mcp Verified 200
http (plaintext) http://firmy.ai/mcp HTTPS enforced 301 https://firmy.ai/mcp
MCP tools · 8 exposed · ~2,663 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
get_account ~169

Zwraca tryb, w jakim działasz (darmowy albo Pro), i czy jesteś zalogowany; w trybie darmowym także krótką instrukcję, jak korzystać z serwera. Tryb darmowy czyta tylko to, co serwis już zna (sekcja spoza pamięci wraca jako "missing" z AUTH_REQUIRED); "id" to KRS, NIP, REGON, adres firmy.ai albo "p-…" osoby; zacznij od search_companies, gdy nie masz identyfikatora. Użyj na początku rozmowy, żeby wiedzieć, czy sekcje spoza pamięci serwisu da się dociągnąć. Koszt: 0 operacji. Przykład: {}.

Input schema present but exposes no named parameters.

NameTypeReqDescription
authenticatedbooleanyes–
hintstring––
modestringyes–

No examples provided.

get_company ~657

Tryb darmowy czyta tylko to, co serwis już zna (sekcja spoza pamięci wraca jako "missing" z AUTH_REQUIRED); "id" to KRS, NIP, REGON, adres firmy.ai albo "p-…" osoby; zacznij od search_companies, gdy nie masz identyfikatora. Zwraca profil firmy i sekcje z "include" (bez "include": profile, people, ownership, ai_scores, description) w jednym wywołaniu oraz mapę "available", która mówi, co jeszcze można dopytać (finanse, dokumenty, VAT, sankcje, przetargi i inne). Sekcje do wyboru: profile, people, ownership, subsidiaries, group_structure, sole_proprietor, financials, documents, beneficial_owners, vat, bankruptcy, sanctions, knf_warnings, tenders, public_aid, domain, ai_scores, description, job_offers, foundation_spending, reviews, similar. Użyj, gdy masz KRS, NIP, REGON albo adres strony firmy; gdy masz tylko nazwę, najpierw search_companies. Koszt w trybie Pro (operacje za sekcję, która chybiła w pamięci serwisu): profile 3, subsidiaries 1, sole_proprietor 1, financials 20, documents 1, beneficial_owners 5, vat 1, bankruptcy 4, public_aid 1, domain 1, description 1, job_offers 1, foundation_spending 20; w trybie darmowym 0, a sekcja spoza pamięci wraca jako "missing" z AUTH_REQUIRED. Przykład: {"id": "0000006865", "include": ["financials", "vat", "sanctions"]}.

NameTypeReqDescription
estimateboolean–Nic nie pobieraj, pokaż tylko, które sekcje są w pamięci i ile by kosztowały w trybie Pro.
freshboolean–Pobierz ponownie mimo pamięci serwisu. W trybie darmowym zawsze AUTH_REQUIRED.
idstringyesKRS (10 cyfr), NIP (także z myślnikami), REGON (9 albo 14 cyfr) albo adres strony firmy na firmy.ai (/KRS/…, /NIP/…). Serwer sam rozpoznaje typ.
id_typestring–Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam.
includearray–Które sekcje zwrócić: profile, people, ownership, subsidiaries, group_structure, sole_proprietor, financials, documents, beneficial_owners, vat, bankruptcy, sanctions, knf_warnings, tenders, public_a…
NameTypeReqDescription
ai_scoresobject––
as_ofstringyes–
availableobjectyes–
bankruptcyobject––
beneficial_ownersobject––
descriptionobject––
documentsobject––
domainobject––
estimateobject––
financialsobject––
foundation_spendingobject––
group_structureobject––
id_resolvedobjectyes–
includedarrayyes–
job_offersobject––
knf_warningsobject––
modestringyes–
ownershipobject––
peopleobject––
profileobject––
public_aidobject––
reviewsobject––
sanctionsobject––
similarobject––
sole_proprietorobject––
sourcearrayyes–
subsidiariesobject––
tendersobject––
urlstringyes–
vatobject––

No examples provided.

get_person ~493

Zwraca profil osoby z KRS (funkcje w firmach, bez daty urodzenia) i sekcje z "include" (bez "include": profile, shareholdings, co_managers, sanctions, bio) w jednym wywołaniu oraz mapę "available". Sekcje do wyboru: profile, shareholdings, co_managers, beneficial_owner_in, sanctions, bio, namesakes. Użyj, gdy masz identyfikator osoby "p-…" z search_persons, z odpowiedzi get_company albo adres strony /osoba/…; gdy masz tylko imię i nazwisko, najpierw search_persons. Osoba, która sprzeciwiła się publikacji, odpowiada błędem GONE. Koszt w trybie Pro (operacje za sekcję, która chybiła w pamięci serwisu): profile 1, shareholdings 1, bio 1; w trybie darmowym 0, a sekcja spoza pamięci wraca jako "missing" z AUTH_REQUIRED. Przykład: {"id": "p-a4df0b6002743095015b98a43bddabc8", "include": ["shareholdings", "co_managers"]}.

NameTypeReqDescription
estimateboolean–Nic nie pobieraj, pokaż tylko, które sekcje są w pamięci i ile by kosztowały w trybie Pro.
freshboolean–Pobierz ponownie mimo pamięci serwisu. W trybie darmowym zawsze AUTH_REQUIRED.
idstringyesIdentyfikator osoby "p-…" (z search_persons albo z odpowiedzi get_company), dawny adres z imieniem i datą albo adres strony /osoba/… na firmy.ai.
id_typestring–Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam.
includearray–Które sekcje zwrócić: profile, shareholdings, co_managers, beneficial_owner_in, sanctions, bio, namesakes. Sekcja profile jest zawsze. Bez tego pola: profile, shareholdings, co_managers, sanctions, b…
NameTypeReqDescription
as_ofstringyes–
availableobjectyes–
beneficial_owner_inobject––
bioobject––
co_managersobject––
estimateobject––
id_resolvedobjectyes–
includedarrayyes–
modestringyes–
namesakesobject––
profileobject––
sanctionsobject––
shareholdingsobject––
sourcearrayyes–
urlstringyes–

No examples provided.

list_companies ~296

Zwraca stronę 100 firm z listy tak, jak ją pokazują listy na stronie: według miasta, działu PKD (dwie cyfry), formy prawnej albo litery początkowej nazwy (litera tylko z miastem). Użyj do przeglądania firm z jednego miasta, branży albo formy prawnej; gdy szukasz konkretnej firmy po nazwie, użyj search_companies. Koszt w trybie Pro: 0 operacji. Lista działu PKD czyta nocne fakty i bywa niedostępna, gdy jeszcze ich nie zbudowano. Przykład: {"pkd_division": "62", "city": "Kraków", "page": 2}.

NameTypeReqDescription
citystring–Miasto z listy serwisu, np. "Kraków" (z polskimi znakami albo bez).
legal_formstring–Forma prawna, np. "Spółka z o.o." albo "Fundacja".
letterstring–Pierwsza litera albo cyfra nazwy; tylko razem z "city".
pageinteger–Numer strony, od 1 (po 100 firm).
pkd_divisionstring–Dział PKD, dwie cyfry, np. "62".
NameTypeReqDescription
itemsarrayyes–
modestringyes–
next_page–yes–
sourcestring––
total_countinteger––

No examples provided.

rank_companies ~302

Zwraca ranking firm według jednej miary: revenue (przychody), profit (zysk netto), growth (wzrost przychodów r/r), margin (marża netto), altman (wskaźnik Altmana Z) albo valuation (wycena AI), z wartością miary, opcjonalnie dla jednego miasta. Użyj do pytań „największe, najbardziej zyskowne, najszybciej rosnące firmy”; nie użyj do porównania dwóch konkretnych firm (wołaj dla nich get_company z sekcją financials). Koszt w trybie Pro: 0 operacji. Ranking obejmuje tylko firmy ze zbadanymi sprawozdaniami. Przykład: {"metric": "revenue", "city": "Gdańsk", "limit": 10}.

NameTypeReqDescription
citystring–Miasto z listy serwisu, np. "Gdańsk"; bez niego ranking krajowy.
limitinteger–Ile firm (domyślnie 20, najwyżej 100).
metricstringyesMiara rankingu: revenue (przychody), profit (zysk netto), growth (wzrost r/r), margin (marża netto), altman (wskaźnik Altmana Z), valuation (wycena AI).
NameTypeReqDescription
itemsarrayyes–
modestringyes–
next_page–yes–
sourcestring––
total_countinteger––

No examples provided.

refresh_company ~268

Odświeża dane firmy: unieważnia pamięć podręczną, ładuje ją od nowa razem ze sprawozdaniami, zapisuje wskaźniki i zwraca pola, które się zmieniły; ta sama blokada 6 godzin na firmę co przycisk „Odśwież” na stronie. Użyj, gdy get_company zwraca dane wyraźnie nieaktualne i potrzebujesz nowszych; w innych wypadkach get_company wystarcza. Koszt w trybie Pro: 25 operacji; w trybie darmowym narzędzie odpowiada AUTH_REQUIRED, a z "estimate": true szacunkiem (0 operacji, "allowed": false). Przykład: {"id": "0000006865"}.

NameTypeReqDescription
estimateboolean–Tylko oszacuj koszt, nie odświeżaj.
idstringyesKRS, NIP, REGON albo adres strony firmy na firmy.ai.
id_typestring–Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam.
NameTypeReqDescription
codestring––
estimateobject––

No examples provided.

search_companies ~265

Zwraca listę firm z KRS pasujących do nazwy, NIP-u, numeru KRS albo REGON-u: id (numer KRS), nazwę, NIP, REGON, miasto, formę prawną, status i adres strony. Użyj, gdy nie masz identyfikatora firmy albo chcesz zawęzić nazwę do miasta; gdy masz KRS lub NIP, wołaj od razu get_company. Koszt w trybie Pro: 0 operacji (wyszukiwarka KRS i baza, bez płatnych źródeł). Przykład: {"query": "CD Projekt", "city": "Warszawa"}.

NameTypeReqDescription
citystring–Miasto siedziby, np. "Gdańsk"; zawęża wyszukiwanie po nazwie.
limitinteger–Ile wyników na stronie (domyślnie 20, najwyżej 100).
pageinteger–Numer strony wyników, od 1.
querystringyesNazwa firmy, NIP, numer KRS albo REGON (cyfry mogą być oddzielone spacjami albo myślnikami).
NameTypeReqDescription
itemsarrayyes–
modestringyes–
next_page–yes–
sourcestring––
total_countinteger––

No examples provided.

search_persons ~213

Zwraca listę osób z KRS o podanym imieniu i nazwisku: publiczny identyfikator "p-…" (id), imiona, nazwisko, liczbę powiązań z firmami i adres strony. Użyj, gdy masz imię i nazwisko, a potrzebujesz identyfikatora osoby do get_person; imiennicy są rozróżniani przez liczbę powiązań, a ich profile przez get_person. Nie ma wyszukiwania po PESEL ani po dacie urodzenia. Koszt w trybie Pro: 0 operacji. Przykład: {"query": "Jan Kowalski"}.

NameTypeReqDescription
limitinteger–Ile wyników na stronie (domyślnie 20, najwyżej 100).
pageinteger–Numer strony wyników, od 1.
querystringyesImię i nazwisko osoby, np. "Jan Kowalski".
NameTypeReqDescription
itemsarrayyes–
modestringyes–
next_page–yes–
sourcestring––
total_countinteger––

No examples provided.

Install

How do I install the firmy.ai: Polish company and person registers (KRS, CEIDG… MCP server?

firmy.ai: Polish company and person registers (KRS, CEIDG… is a hosted endpoint at https://firmy.ai/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · firmy.ai

# add to Claude Code
claude mcp add --transport http ai-firmy-mcp 'https://firmy.ai/mcp'
Common questions

What is the firmy.ai: Polish company and person registers (KRS, CEIDG… MCP server?

firmy.ai: Polish company and person registers (KRS, CEIDG… is an MCP server listed in the public MCP registry as ai.firmy/mcp. Polish companies and people: KRS, CEIDG, financials, boards, VAT, sanctions. Free, no API key. This page covers its hosted endpoint (https://firmy.ai/mcp).

Is the firmy.ai: Polish company and person registers (KRS, CEIDG… MCP server safe to use?

firmy.ai: Polish company and person registers (KRS, CEIDG… scores 73 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the firmy.ai: Polish company and person registers (KRS, CEIDG… MCP server expose?

firmy.ai: Polish company and person registers (KRS, CEIDG… exposes 8 tools: search_companies, search_persons, get_company, get_person, list_companies, and 3 more. Their descriptions and schemas cost roughly 2,663 tokens of context every time the server is loaded.

Does the firmy.ai: Polish company and person registers (KRS, CEIDG… MCP server require authentication?

No. We connected to firmy.ai: Polish company and person registers (KRS, CEIDG… without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the firmy.ai: Polish company and person registers (KRS, CEIDG… MCP server still maintained?

firmy.ai: Polish company and person registers (KRS, CEIDG… is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.