Skip to content
MCP server

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

Polish company and person registers (KRS, CEIDG, VAT, sanctions) for AI agents, no key

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
4 days ago

Similar MCP servers

About 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. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://firmy.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://firmy.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to Grok Bot desktop app → Connect apps → Add a custom connector

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.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

Free, no account; a Pro tier with 500 monthly operations is announced without a date

Prices change. Check firmy.ai before you buy.

firmy.ai: Polish company and person registers (KRS, CEIDG) for AI agents 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.

How AIPoweredBot checks servers