# 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.

- Trust score: 73/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `firmy.ai`: 73/100 (this document), [markdown](https://verifymcp.io/servers/ai-firmy-mcp/firmy.md), [page](https://verifymcp.io/servers/ai-firmy-mcp/firmy)

## Channel facts

- Endpoint: `https://firmy.ai/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 76/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 10/100
  - Stability observed for 3 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## 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.

### Claude

```bash
claude mcp add --transport http ai-firmy-mcp 'https://firmy.ai/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "ai-firmy-mcp": {
      "url": "https://firmy.ai/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "ai-firmy-mcp": {
      "type": "http",
      "url": "https://firmy.ai/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.ai-firmy-mcp]
url = "https://firmy.ai/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-firmy-mcp": {
      "type": "remote",
      "url": "https://firmy.ai/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-firmy-mcp --url 'https://firmy.ai/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  ai-firmy-mcp:
    url: "https://firmy.ai/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "ai-firmy-mcp": {
      "Transport": "http",
      "Url": "https://firmy.ai/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add ai-firmy-mcp -t streamable-http -u 'https://firmy.ai/mcp'
```

### Other

```json
{
  "mcpServers": {
    "ai-firmy-mcp": {
      "type": "http",
      "url": "https://firmy.ai/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 73, +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.

### 2026-11-03 (score 72, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-02 (score 71)

First indexed and scored.

## MCP tools (8)

### `search_companies` (~265 tokens)

Szukaj firm

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"}.

Input parameters:

- `city` (string): Miasto siedziby, np. "Gdańsk"; zawęża wyszukiwanie po nazwie.
- `limit` (integer): Ile wyników na stronie (domyślnie 20, najwyżej 100).
- `page` (integer): Numer strony wyników, od 1.
- `query` (string, required): Nazwa firmy, NIP, numer KRS albo REGON (cyfry mogą być oddzielone spacjami albo myślnikami).

Output parameters:

- `items` (array)
- `mode` (string)
- `next_page`
- `source` (string)
- `total_count` (integer)

### `search_persons` (~213 tokens)

Szukaj osób

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"}.

Input parameters:

- `limit` (integer): Ile wyników na stronie (domyślnie 20, najwyżej 100).
- `page` (integer): Numer strony wyników, od 1.
- `query` (string, required): Imię i nazwisko osoby, np. "Jan Kowalski".

Output parameters:

- `items` (array)
- `mode` (string)
- `next_page`
- `source` (string)
- `total_count` (integer)

### `get_company` (~657 tokens)

Profil firmy

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"]}.

Input parameters:

- `estimate` (boolean): Nic nie pobieraj, pokaż tylko, które sekcje są w pamięci i ile by kosztowały w trybie Pro.
- `fresh` (boolean): Pobierz ponownie mimo pamięci serwisu. W trybie darmowym zawsze AUTH_REQUIRED.
- `id` (string, required): KRS (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_type` (string): Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam.
- `include` (array): 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…

Output parameters:

- `ai_scores` (object)
- `as_of` (string)
- `available` (object)
- `bankruptcy` (object)
- `beneficial_owners` (object)
- `description` (object)
- `documents` (object)
- `domain` (object)
- `estimate` (object)
- `financials` (object)
- `foundation_spending` (object)
- `group_structure` (object)
- `id_resolved` (object)
- `included` (array)
- `job_offers` (object)
- `knf_warnings` (object)
- `mode` (string)
- `ownership` (object)
- `people` (object)
- `profile` (object)
- `public_aid` (object)
- `reviews` (object)
- `sanctions` (object)
- `similar` (object)
- `sole_proprietor` (object)
- `source` (array)
- `subsidiaries` (object)
- `tenders` (object)
- `url` (string)
- `vat` (object)

### `get_person` (~493 tokens)

Profil osoby

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"]}.

Input parameters:

- `estimate` (boolean): Nic nie pobieraj, pokaż tylko, które sekcje są w pamięci i ile by kosztowały w trybie Pro.
- `fresh` (boolean): Pobierz ponownie mimo pamięci serwisu. W trybie darmowym zawsze AUTH_REQUIRED.
- `id` (string, required): Identyfikator osoby "p-…" (z search_persons albo z odpowiedzi get_company), dawny adres z imieniem i datą albo adres strony /osoba/… na firmy.ai.
- `id_type` (string): Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam.
- `include` (array): 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…

Output parameters:

- `as_of` (string)
- `available` (object)
- `beneficial_owner_in` (object)
- `bio` (object)
- `co_managers` (object)
- `estimate` (object)
- `id_resolved` (object)
- `included` (array)
- `mode` (string)
- `namesakes` (object)
- `profile` (object)
- `sanctions` (object)
- `shareholdings` (object)
- `source` (array)
- `url` (string)

### `list_companies` (~296 tokens)

Lista firm

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}.

Input parameters:

- `city` (string): Miasto z listy serwisu, np. "Kraków" (z polskimi znakami albo bez).
- `legal_form` (string): Forma prawna, np. "Spółka z o.o." albo "Fundacja".
- `letter` (string): Pierwsza litera albo cyfra nazwy; tylko razem z "city".
- `page` (integer): Numer strony, od 1 (po 100 firm).
- `pkd_division` (string): Dział PKD, dwie cyfry, np. "62".

Output parameters:

- `items` (array)
- `mode` (string)
- `next_page`
- `source` (string)
- `total_count` (integer)

### `rank_companies` (~302 tokens)

Ranking firm

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}.

Input parameters:

- `city` (string): Miasto z listy serwisu, np. "Gdańsk"; bez niego ranking krajowy.
- `limit` (integer): Ile firm (domyślnie 20, najwyżej 100).
- `metric` (string, required): Miara rankingu: revenue (przychody), profit (zysk netto), growth (wzrost r/r), margin (marża netto), altman (wskaźnik Altmana Z), valuation (wycena AI).

Output parameters:

- `items` (array)
- `mode` (string)
- `next_page`
- `source` (string)
- `total_count` (integer)

### `refresh_company` (~268 tokens)

Odśwież firmę

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"}.

Input parameters:

- `estimate` (boolean): Tylko oszacuj koszt, nie odświeżaj.
- `id` (string, required): KRS, NIP, REGON albo adres strony firmy na firmy.ai.
- `id_type` (string): Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam.

Output parameters:

- `code` (string)
- `estimate` (object)

### `get_account` (~169 tokens)

Tryb i konto

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: {}.

Output parameters:

- `authenticated` (boolean)
- `hint` (string)
- `mode` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ai-firmy-mcp/firmy#diagnostics

## Score history

- 2026-11-05: 73
- 2026-11-04: 72
- 2026-11-03: 72
- 2026-11-02: 71

## 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.

## Links

- Remote endpoint: https://firmy.ai/mcp
- Website: https://firmy.ai/mcp
- Changelog RSS feed: https://verifymcp.io/servers/ai-firmy-mcp/firmy.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-firmy-mcp/firmy.json
- HTML version of this page: https://verifymcp.io/servers/ai-firmy-mcp/firmy