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

> firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents is a free MCP server for legal and government. Polish company and person registers (KRS, CEIDG, VAT, sanctions) for AI agents, no key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://firmy.ai/mcp
- **MCP Registry name:** ai.firmy/mcp
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-15

## About

firmy.ai exposes what a logged-out visitor sees on its website as JSON: pages keyed by KRS number, NIP tax ID or a person ID. Each section carries its source and a state date, and three kinds of content (register data, AI analysis and user opinions) are labelled separately.

A company profile can include board, supervisory board, proxies, shareholders, parent and subsidiary companies, the GLEIF group structure, filed financial statements with ratios and an Altman score, the VAT white list and VIES verdict, bankruptcy proceedings, EU and Polish interior-ministry sanction lists, KNF warnings, public tenders and state aid. Person profiles list current and past KRS roles, shareholdings and co-managers, and never include PESEL, address, phone or email.

The free mode needs no account and is limited to 30 requests per 10 seconds per IP address. A Pro mode, not yet dated, is described as adding live fetching of missing sections and a monthly operation allowance. Beneficial owners from CRBR need an account and today return an AUTH_REQUIRED error.

## Features

- **Eight tools:** Search companies and persons, fetch profiles, list companies by city, PKD division, legal form or letter, and rank them by a chosen metric.
- **Selectable profile sections:** The include parameter picks sections such as financials, vat, sanctions, tenders or subsidiaries; sections with no data come back as missing rather than as errors.
- **Labelled sources and dates:** Every section states where it came from and the date of the data, with register data, AI analysis and opinions marked apart.
- **Counterparty check prompt:** A ready-made check_counterparty prompt covers register, finances, owners, sanctions, debt and public tenders.
- **Person background prompt:** person_background summarises a person's roles, network of connections and signals worth checking.
- **Machine-readable descriptors:** A server card, AI catalogue entry and agent skill file are published under /.well-known/.

## Good for

- Check a Polish counterparty before signing a contract
- Look up the board and owners of a company by KRS or NIP
- Screen a company against EU and Polish sanction lists and KNF warnings
- Pull filed financial statements and ratios for due diligence
- Find which companies a given person manages or owns shares in
- Rank companies in a city by revenue or profit

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://firmy.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://firmy.ai/mcp
```

Enter a Name (for example "firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `search_companies`: Search companies by name, NIP, KRS or REGON.
- `search_persons`: Search people by first and last name.
- `get_company`: Company or sole-proprietor profile with selectable sections.
- `get_person`: Person profile with selectable sections.
- `list_companies`: Pages of 100 companies by city, PKD division, legal form or letter.
- `rank_companies`: Rank companies by revenue, profit, growth, margin, Altman score or AI valuation.
- `refresh_company`: Full refresh from live sources; a Pro-mode tool that currently returns AUTH_REQUIRED.
- `get_account`: Connection mode and, for accounts, plan and operation usage.

## FAQ

### Does it need an account or API key?

No. The free mode works without either; only the planned Pro mode and CRBR beneficial-owner data need an account.

### What are the rate limits?

30 requests per 10 seconds from one IP address. Going over returns HTTP 429 with a Retry-After header.

### Which clients can connect?

The page gives setup steps for Claude Code, Cursor, Claude.ai, Claude Desktop and ChatGPT, plus a raw curl example.

### Does it expose personal data?

Only what the public person page shows: KRS roles and related companies. PESEL, addresses, phone and email are excluded, and objections filed on the GDPR page also apply in MCP.

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

Yes. firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents is free to use.

### How do I add firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://firmy.ai/mcp

### What are the best alternatives to firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents?

The closest alternatives to firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents are tropia.pl: Polish companies (KRS), AnalizaFirm.pl - Polish companies (KRS), Nipli — Polish company data, Krs MCP and CzechAI – Czech business & property intelligence.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [tropia.pl: Polish companies (KRS)](https://ai-powered.com/mcp/tropia-pl-polish-companies-krs): tropia.pl: Polish companies (KRS) is a paid MCP server for analytics and data.
- [AnalizaFirm.pl - Polish companies (KRS)](https://ai-powered.com/mcp/analizafirm-pl-polish-companies-krs): AnalizaFirm.pl - Polish companies (KRS) is a freemium MCP server for analytics and data.
- [Nipli — Polish company data](https://ai-powered.com/mcp/nipli-polish-company-data): Nipli — Polish company data is a freemium MCP server for analytics and data.
- [Krs MCP](https://ai-powered.com/mcp/krs-mcp): Krs MCP is an open-source MCP server for legal and government.
- [CzechAI – Czech business & property intelligence](https://ai-powered.com/mcp/czechai-czech-business-and-property-intelligence): CzechAI – Czech business & property intelligence is an MCP server for legal and government.
- [Karpata – company data from public registers](https://ai-powered.com/mcp/karpata-company-data-from-public-registers): Karpata – company data from public registers is a paid MCP server for finance and payments.
- [Eu Registry](https://ai-powered.com/mcp/eu-registry): Eu Registry is an open-source MCP server for legal and government.
- [Polish KYB](https://ai-powered.com/mcp/polish-kyb): Polish KYB is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/firmy-ai-polish-company-and-person-registers-krs-ceidg-for-a
