REGON (Polish business register)

Name: REGON (Polish business register)
Author: SmartMobileHouse

von SmartMobileHouseVersion 0.2.3i★ –iLäuft auf deinem Computer

Name in der Registryio.github.SmartMobileHouse/regon-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Look up Polish businesses in the GUS REGON register (BIR1) by NIP, REGON, or KRS.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges
Das musst du eintragen: REGON_API_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: REGON_API_KEY, REGON_ENV

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "regon": {
      "command": "uvx",
      "args": [
        "regon-mcp"
      ],
      "env": {
        "REGON_API_KEY": "your-value",
        "REGON_ENV": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add regon --env REGON_API_KEY=your-value --env REGON_ENV=your-value -- uvx regon-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "regon": {
      "command": "uvx",
      "args": [
        "regon-mcp"
      ],
      "env": {
        "REGON_API_KEY": "your-value",
        "REGON_ENV": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "regon": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "regon-mcp"
      ],
      "env": {
        "REGON_API_KEY": "your-value",
        "REGON_ENV": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

REGON_API_KEY geheim env
GUS BIR USER_KEY for live production data. Omit to use the public test key against the anonymized test database.
REGON_ENV env
Which GUS environment to query: 'test' (default) or 'prod'. Use 'prod' with a real USER_KEY.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto SmartMobileHouse bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32661 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 92 % der anderen 32661 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32661 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist REGON (Polish business register) sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: REGON_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.2.3) kam vorgestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, Claude Checkpoint MCP

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert vorgestern

Installieren

Claude Checkpoint MCP

von daniel-munoz

MCP server that checkpoints Claude Code session context to survive crashes and token limits

Läuft auf deinem ComputerAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

regon-mcp

A Model Context Protocol server that gives AI assistants clean, typed access to the Polish REGON business register (GUS BIR1). Look up any Polish company by NIP, REGON, or KRS and get back structured data — name, address, legal form, activity codes — without touching the underlying SOAP API.

The official GUS BIR1 API is a WCF SOAP service with WS-Addressing, MTOM multipart responses, an HTTP-header session token, and XML-nested-inside-XML result payloads. regon-mcp hides all of that behind a handful of simple tools.

Built and maintained by Smart Mobile House —

secure AI implementation for enterprise.

Background and design notes: the regon-mcp write-up.

Tools

Tool	Description
`search_by_nip(nip)`	Look up an entity by 10-digit NIP (tax id).
`search_by_regon(regon)`	Look up an entity by 9- or 14-digit REGON.
`search_by_krs(krs)`	Look up an entity by 10-digit KRS (court register).
`search_bulk(identifiers, id_type)`	Look up up to 20 entities of one type at once.
`get_full_report(regon, report_type)`	Fetch a detailed report for one entity.
`list_report_types()`	List valid report names, with guidance on which to use.

Every response includes a source block that names the register (REGON / GUS), the environment, and a UTC retrieved_at timestamp — so downstream use can cite the data correctly, as GUS requires.

Quick start

No install needed — run it straight from the repo with uv:

uvx --from git+https://github.com/SmartMobileHouse/regon-mcp regon-mcp

By default it uses the public test key against the anonymized GUS test database, so it runs with zero setup. For live data, request a free USER_KEY from regon_bir@stat.gov.pl and set the environment variables below.

Use it in Claude Desktop / Claude Code

Add to your MCP config (e.g. claude_desktop_config.json or a project .mcp.json):

"mcpServers": { "regon": { "command": "uvx", "args": ["--from", "git+https://github.com/SmartMobileHouse/regon-mcp", "regon-mcp"], "env": { "REGON_API_KEY": "your-user-key", "REGON_ENV": "prod" } } } }

During development, point it at a local checkout instead:

"mcpServers": { "regon": { "command": "uvx", "args": ["--from", "/absolute/path/to/regon-mcp", "regon-mcp"], "env": { "REGON_API_KEY": "abcde12345abcde12345" } } } }

Configuration

Variable	Default	Description
`REGON_API_KEY`	public test key	Your GUS BIR `USER_KEY`.
`REGON_ENV`	`test`	`test` (anonymized data) or `prod` (live data).
`REGON_TIMEOUT`	`30`	HTTP timeout in seconds.

Use REGON_ENV=prod only with a real USER_KEY; the test key works only against the test environment.

Development

git clone https://github.com/SmartMobileHouse/regon-mcp

cd regon-mcp uv sync # create the venv and install deps uv run pytest # offline tests: validation, parsing, mocked client,

and an in-memory MCP tool-discovery smoke test.

(network tests are deselected by default)

uv run regon-mcp # run the server over stdio

Live tests against the GUS endpoint (deselected unless opted in):

REGON_RUN_NETWORK=1 uv run pytest -m network # session lifecycle (test env) REGON_PROD_KEY= uv run pytest -m network # positive-control on live data

The client is a small hand-rolled SOAP layer over httpx (see src/regon_mcp/client.py) — no heavyweight SOAP stack, no runtime WSDL fetch.

Notes & limitations

The GUS test database is anonymized and returns little or no entity data. Meaningful results require a production USER_KEY with REGON_ENV=prod.
Respect the GUS terms of use and rate limits. This project is an independent open-source client and is not affiliated with or endorsed by GUS.
Data belongs to GUS. When you present it, cite REGON / GUS with the retrieval date (surfaced in every response's source block).

REGON (Polish business register)

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

Claude Checkpoint MCP

README vom Entwickler

regon-mcp

Tools

Quick start

Use it in Claude Desktop / Claude Code

Configuration

Development

and an in-memory MCP tool-discovery smoke test.

(network tests are deselected by default)

Live tests against the GUS endpoint (deselected unless opted in):

Notes & limitations

License