_ registry / mcp http-sse · checked 53m ago

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

listed under this name in a public catalogue; the server gives only its address, firmy.ai

https://firmy.ai

Registry code: 334dd8517640c8bf

api record

firmy.ai to polskie rejestry firm i osób w jednym miejscu: KRS, finanse ze sprawozdań, biała lista VAT, listy sankcyjne, przetargi, powiązania. Serwer ma dwa tryby. Tryb darmowy, bez konta, czyta to, co serwis już zna (baza, pamięć podręczna, bezpłatne API KRS) i niczego nie dociąga na żądanie; sekcja, której nie ma w pamięci, wraca ze stanem "missing" i kodem AUTH_REQUIRED. Tryb Pro (jeszcze niedostępny) dociąga brakujące sekcje na żądanie i liczy operacje: jedno wywołanie kosztuje najwyżej 40 operacji, a "estimate": true pokazuje koszt bez wykonania.

Identyfikator "id" podajesz jako KRS (10…

endpoint
https://firmy.ai/mcp
protocol
http-sse ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents live?
Yes — it answered the hub's last check (checked 53m ago). It answered 100% of checks over the last 30 days.
Is firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents free to use?
Yes — the hub reached it with no key and no payment.
What tools does firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents have?
8 tools: search_companies, search_persons, get_company, get_person, refresh_company, list_companies, rank_companies, get_account.
Is firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
238ms

last good check

priced tools
0

of 8 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 8 tools
1 open 7 never probed 1 of 8 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • get_account open 53m ago

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
    arguments 5 lines
  • search_companies unknown never probed

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Miasto siedziby, np. \"Gdańsk\"; zawęża wyszukiwanie po nazwie."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Numer strony wyników, od 1."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Ile wyników na stronie (domyślnie 20, najwyżej 100)."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Nazwa firmy, NIP, numer KRS albo REGON (cyfry mogą być oddzielone spacjami albo myślnikami)."
    }
  }
}
    arguments 33 lines
  • search_persons unknown never probed

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Numer strony wyników, od 1."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Ile wyników na stronie (domyślnie 20, najwyżej 100)."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Imię i nazwisko osoby, np. \"Jan Kowalski\"."
    }
  }
}
    arguments 27 lines
  • get_company unknown never probed

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "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."
    },
    "fresh": {
      "type": "boolean",
      "description": "Pobierz ponownie mimo pamięci serwisu. W trybie darmowym zawsze AUTH_REQUIRED."
    },
    "id_type": {
      "enum": [
        "krs",
        "nip",
        "regon",
        "person"
      ],
      "type": "string",
      "description": "Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam."
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 30,
      "description": "Które sekcje zwrócić: 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. Sekcja profile jest zawsze. Bez tego pola: profile, people, ownership, ai_scores, description."
    },
    "estimate": {
      "type": "boolean",
      "description": "Nic nie pobieraj, pokaż tylko, które sekcje są w pamięci i ile by kosztowały w trybie Pro."
    }
  }
}
    arguments 42 lines
  • get_person unknown never probed

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "Identyfikator osoby \"p-…\" (z search_persons albo z odpowiedzi get_company), dawny adres z imieniem i datą albo adres strony /osoba/… na firmy.ai."
    },
    "fresh": {
      "type": "boolean",
      "description": "Pobierz ponownie mimo pamięci serwisu. W trybie darmowym zawsze AUTH_REQUIRED."
    },
    "id_type": {
      "enum": [
        "krs",
        "nip",
        "regon",
        "person"
      ],
      "type": "string",
      "description": "Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam."
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 30,
      "description": "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, bio."
    },
    "estimate": {
      "type": "boolean",
      "description": "Nic nie pobieraj, pokaż tylko, które sekcje są w pamięci i ile by kosztowały w trybie Pro."
    }
  }
}
    arguments 42 lines
  • refresh_company unknown never probed

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "KRS, NIP, REGON albo adres strony firmy na firmy.ai."
    },
    "id_type": {
      "enum": [
        "krs",
        "nip",
        "regon",
        "person"
      ],
      "type": "string",
      "description": "Wymusza typ identyfikatora, gdy wiesz lepiej: krs, nip, regon albo person. Zwykle zbędne: serwer rozpoznaje typ sam."
    },
    "estimate": {
      "type": "boolean",
      "description": "Tylko oszacuj koszt, nie odświeżaj."
    }
  }
}
    arguments 29 lines
  • list_companies unknown 53m ago

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Miasto z listy serwisu, np. \"Kraków\" (z polskimi znakami albo bez)."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Numer strony, od 1 (po 100 firm)."
    },
    "letter": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]$",
      "description": "Pierwsza litera albo cyfra nazwy; tylko razem z \"city\"."
    },
    "legal_form": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Forma prawna, np. \"Spółka z o.o.\" albo \"Fundacja\"."
    },
    "pkd_division": {
      "type": "string",
      "pattern": "^\\d{2}$",
      "description": "Dział PKD, dwie cyfry, np. \"62\"."
    }
  }
}
    arguments 34 lines
  • rank_companies unknown 53m ago

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

    mcp-tool

    {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "metric"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Miasto z listy serwisu, np. \"Gdańsk\"; bez niego ranking krajowy."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Ile firm (domyślnie 20, najwyżej 100)."
    },
    "metric": {
      "enum": [
        "revenue",
        "profit",
        "growth",
        "margin",
        "altman",
        "valuation"
      ],
      "type": "string",
      "description": "Miara rankingu: revenue (przychody), profit (zysk netto), growth (wzrost r/r), margin (marża netto), altman (wskaźnik Altmana Z), valuation (wycena AI)."
    }
  }
}
    arguments 33 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 334dd8517640c8bf.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/334dd8517640c8bf/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/334dd8517640c8bf/badge.svg)](https://brick.blue/agent/334dd8517640c8bf?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.