Abn Lookup

@pipeworx/abn-lookup

BYOK。Australian Business Register の検索：ABN または ACN から登録済みの法人名、法人タイプ、ABN のステータス、GST 登録状況、住所の州・郵便番号、事業名を取得するか、法人名・事業名で登録情報を検索します。

Pipeworx の一部です。AI エージェントを 1872 以上の稼働中のデータソースに接続する MCP ゲートウェイです。この連携は独立した非公式のものであり、上流プロバイダーとは提携・承認関係になく、同プロバイダーから公開されたものでもありません。

ツール

• abn_lookup(abn, _apiKey) — ABN から法人名、法人タイプ、ステータス、GST、住所、事業名を取得します。
• abn_search(name, state?, maxResults?, _apiKey) — 法人名・事業名から、関連度順の ABN 候補を取得します。
• acn_lookup(acn, _apiKey) — ACN（会社番号）から、abn_lookup と同じ詳細情報を取得します。

認証

BYO のみです。プラットフォームキーはありません。すべての呼び出しで、呼び出し元が所有する ABR ウェブサービス GUID を _apiKey で指定する必要があります。https://abr.business.gov.au/Tools/WebServices から無料で登録してください。ABR は、GUID をメールで送信する前に、登録済みの本人確認情報で Web Services Agreement（利用規約および個人情報共有に関する確認）に同意することを求めています。これは本人による同意が必要な手続きのため、Pipeworx は GUID を保有したり、代わりに提供したりしません。

_apiKey がない場合、すべてのツールは「API キーが必要です」というメッセージを返して処理を拒否し、上記の登録 URL を案内します。

データソース

• https://abr.business.gov.au/json/AbnDetails.aspx — ABN または ACN の詳細情報。
• https://abr.business.gov.au/json/AcnDetails.aspx — ACN の詳細情報。
• https://abr.business.gov.au/json/MatchingNames.aspx — 名前検索。

注意点

• JSON エンドポイントは JSONP 形式です。レスポンス本文は <callback>({...}) のようにラップされます。ここでの <callback> は送信された callback= クエリパラメーターに従います（省略時は callback がデフォルトで使用されることを実稼働環境で確認済みです）。このパッケージでは callback を固定値としてハードコードせず、関数名に基づいて汎用的にラッパーを除去します。
• 無効な GUID または認識されない GUID を指定した場合、HTTP エラーではなく、主要フィールドがすべて空で Message 文字列（例："The GUID entered is not recognised as a Registered Party"）を含む HTTP 200 が返されます。ABR は実際に該当情報が見つからない場合も同じ形式を返すため、主要フィールドが空で Message が含まれていても、レスポンスだけではキーが拒否されたのかどうかを判別できません。このパッケージでは推測せず、その旨をエラーで明示します。
• マッピング済み出力のフィールド名（Abn、AbnStatus、EntityName、BusinessName[] など）は、ABR が公開している JSON サンプル URL に基づいています。稼働中の環境での検索が成功した場合の形式は、フリート GUID が存在しないため、エンドツーエンドで未検証です（BYOK、2026-09-03 判定）。ABR の生のペイロードは常に raw として返されるため、実際のキーを持つ呼び出し元は、ここで古くなったフィールド名が原因で処理を妨げられることはありません。
• abn_search の state は、ABR が返した候補の各 State フィールドに基づくクライアント側のフィルターです。ABR の公式なクエリーパラメーターではありません。ABR の公開 JSON サンプルドキュメントには、MatchingNames.aspx 用の州フィルターパラメーターが記載されていません。

クイックスタート

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

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

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

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

これは意図的な設計であり、誤って多重化されているわけではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を対象に振り分ける ask_pipeworx を通じて回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

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

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

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

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

このパックでは独自の API キー（_apiKey）を使用します。こちらでは API キーを用意していないため、キーなしで実行できる curl の例はありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/abn_lookup を実行してください。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

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

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

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

起動することを確認するには、直接実行することもできます。

npx -y @pipeworx/mcp-abn-lookup

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

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Abn Lookup data" })

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

詳細

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

ライセンス

MIT