regon-mcp
A Model Context Protocol server providing AI assistants with clean, typed access to the Polish REGON business register via the GUS BIR1 API. It allows users to look up Polish companies by NIP, REGON, or KRS and retrieve structured data including name, address, legal form, and activity codes, while handling the underlying SOAP API complexity.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Look up an entity by 10-digit NIP (tax id)
- Look up an entity by 9- or 14-digit REGON
- Look up an entity by 10-digit KRS (court register)
- Fetch a detailed report for one entity
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
regon-mcp 0.2.2
{
"version": "0.2.2",
"transport": "stdio",
"identifier": "regon-mcp",
"registryType": "pypi",
"environmentVariables": [
{
"name": "REGON_API_KEY",
"format": "string",
"description": "GUS BIR USER_KEY for live production data. Omit to use the public test key against the anonymized test database."
},
{
"name": "REGON_ENV",
"format": "string",
"description": "Which GUS environment to query: 'test' (default) or 'prod'. Use 'prod' with a real USER_KEY."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"regon-mcp": {
"command": "uvx",
"args": [
"regon-mcp==0.2.2"
],
"env": {
"REGON_API_KEY": "<YOUR_REGON_API_KEY>",
"REGON_ENV": "<YOUR_REGON_ENV>"
}
}
}
}Cline
{
"mcpServers": {
"regon-mcp": {
"command": "uvx",
"args": [
"regon-mcp==0.2.2"
],
"env": {
"REGON_API_KEY": "<YOUR_REGON_API_KEY>",
"REGON_ENV": "<YOUR_REGON_ENV>"
}
}
}
}VS Code
{
"servers": {
"regon-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"regon-mcp==0.2.2"
],
"env": {
"REGON_API_KEY": "<YOUR_REGON_API_KEY>",
"REGON_ENV": "<YOUR_REGON_ENV>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"regon-mcp": {
"command": "uvx",
"args": [
"regon-mcp==0.2.2"
],
"env": {
"REGON_API_KEY": "<YOUR_REGON_API_KEY>",
"REGON_ENV": "<YOUR_REGON_ENV>"
}
}
}
}Let your agent find its tools
Find servers like regon-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.