Regon Pl

@pipeworx/regon-pl

ポーランドの事業者登録（REGON / BIR1.1）— 統計局の公式登録簿から、NIP、 REGON、またはKRS番号を使ってポーランドの任意の企業を検索し、登録名、法的住所、 事業体の種類を取得します。

Pipeworx の一部です — AI エージェントを1683以上の稼働中のデータソースに接続するMCPゲートウェイです。

ツール

• regon_search_nip({ nip, environment, _apiKey }) — 納税者識別番号で検索します。
• regon_search_regon({ regon, environment, _apiKey }) — 9桁または14桁のREGON統計番号で検索します。
• regon_search_krs({ krs, environment, _apiKey }) — 国立裁判所登録番号で検索します。

3つとも、登録名、残り2つの識別番号、事業体の種類 （法人／個人事業主／地域単位）、県、郡、自治体、 地域、郵便番号、登録住所を返します。

認証

プラットフォームキー（PLATFORM_REGON_KEY）を使用します。?_apiKey= でBYOキーを指定できます。認証情報不要のテストパスもあります。

• environment: "production"（デフォルト）— 本番の登録簿です。API キーが必要です。https://api.stat.gov.pl/Home/RegonApi で無料登録してください。GUSから 20文字のユーザーキーが発行されます。
• environment: "test" — GUSがドキュメントで公開しているテストキーを使う、GUS独自の公開テストサービスです。 認証情報は不要で実際に応答しますが、少数の固定フィクスチャデータベースを使用します（住所は「ul. Test-Wilcza」と表示されます）。 応答の形式確認には使えますが、実在企業についての情報取得には使わないでください。 このサービスのすべての応答には、その旨を示すdisclaimerフィールドが含まれます。

データソース

• https://wyszukiwarkaregon.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc — 本番環境のBIR1.1。
• https://wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc — テスト環境のBIR1.1。

注意点

• RESTではなく、SOAP 1.2 over MTOMです。 クエリごとに2回呼び出します。Zalogujで ユーザーキーをセッションIDに交換し、その後、検索リクエストにセッションIDを指定します。
• セッションIDはSOAPエンベロープ内ではなく、HTTPのsidヘッダーに指定します。 エンベロープ内に指定すると、サービスは認証ユーザーを特定できず、 エラーなしで空の結果を返します。
• 該当なしの場合、空のドキュメントが返るわけではありません。 <dane>レコードが返され、 そのフィールドはErrorCode 4とErrorMessageEn「No data found for the specified search criteria」のみです。単純に解析すると、すべてのフィールドがnullの結果が1件あるように見えます。 典型的なサイレントなゼロ件です。このパックはErrorCodeを検出し、上流のメッセージとともにfound: falseを返します。
• 認識されないユーザーキーは、HTTPエラーではなく空のZalogujResultとして報告されます。 このパックはこれを明示的にエラーとして扱います。
• 応答はMIMEマルチパート形式で、ペイロードはSOAP結果要素内にXMLエスケープされた文字列として含まれます。二重にアンラップする必要があります。
• セッションはワーカーのメモリに30分間キャッシュされます（上流の有効期間は約60分です）。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "regon-pl": {
      "url": "https://gateway.pipeworx.io/regon-pl/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/regon-pl/mcp の tools/list は、上記の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使える一連のツール）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントでは現在、パック独自のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックが対応していない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を介して答えられるため、2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマが、ルーティングの利点を上回るほどコンテキストを消費する場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1683 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/regon_search_nip \
  -H 'Content-Type: application/json' \
  -d '{"nip":"7740001454","environment":"test"}'

最初の呼び出しではアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/regon_search_nip を呼び出します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "regon-pl": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-regon-pl"]
    }
  }
}

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-regon-pl

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に、initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Regon Pl data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT