Search / ai.firmy/mcp
protogridR0· no sign-inPolish companies and people: KRS, CEIDG, financials, boards, VAT, sanctions. Free, no API key.
v1.0.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"firmy": {
"type": "http",
"url": "https://firmy.ai/mcp"
}
}
}claude mcp add --transport http firmy https://firmy.ai/mcp[mcp_servers.firmy]
url = "https://firmy.ai/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"firmy": {
"type": "remote",
"url": "https://firmy.ai/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"firmy": {
"type": "http",
"url": "https://firmy.ai/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=firmy&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZmlybXkuYWkvbWNwIn0%3D"
}{
"servers": {
"firmy": {
"type": "http",
"url": "https://firmy.ai/mcp"
}
}
}{
"mcpServers": {
"firmy": {
"httpUrl": "https://firmy.ai/mcp"
}
}
}extensions:
"firmy":
enabled: true
name: "firmy"
type: streamable_http
uri: "https://firmy.ai/mcp"
timeout: 300
protocol.modernprotocol.statelessprotocol.transportprotocol.list_ttlauth.prm, auth.as_metadata, auth.cimdauth.secret_in_urltools.descriptionstools.description_lengthtools.schemastools.annotationstools.directory_hintstools.token_costtools.api_dumptools.hidden_textstability.changesstability.rug_pullstability.new_linksdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-100% +updated-12d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://firmy.ai/mcp streamable-http | none | yes | 100% | 603 ms | 2026-07-28 | 2026-11-14 |
get_accountread-only | 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: {}. |
get_company | 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"]}. |
get_person | 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"]}. |
list_companiesread-only | 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}. |
rank_companiesread-only | 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}. |
refresh_company | 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"}. |
search_companiesread-only | 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"}. |
search_personsread-only | 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"}. |
Schemas: list_tools.
{
"name": "ai.firmy/mcp",
"icons": [
{
"src": "https://firmy.ai/favicon-512x512.png",
"sizes": [
"512x512"
],
"mimeType": "image/png"
},
{
"src": "https://firmy.ai/favicon.svg",
"sizes": [
"any"
],
"mimeType": "image/svg+xml"
}
],
"title": "firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://firmy.ai/mcp",
"type": "streamable-http"
}
],
"version": "1.0.0",
"websiteUrl": "https://firmy.ai/mcp",
"description": "Polish companies and people: KRS, CEIDG, financials, boards, VAT, sanctions. Free, no API key."
}