Lookup company by tax ID

twtools-lookup_company_by_tax_id

TW-specificMITExternal API

Depends on a third-party API (e.g. MOEAIC business registry) — may fail due to upstream downtime, rate limits, or format changes. Other Tier A pure-function tools are unaffected.

以統一編號查詢公司登記資料（經濟部商業司開放 API）。

Args:
    tax_id: 8 位統一編號。

Returns: 公司名 / 狀態 / 負責人 / 登記地址 / 主管機關 / 資本額 /
    設立日 (ISO) / 最後變更日 (ISO)。raw 內保留原始 OData 欄位。

⚠ Tier B：實際打外部 API（data.gcis.nat.gov.tw OData v3）。可能因
upstream 停機、rate-limit、format 異動而 fail。返回 found=False 並
附 reason 而不是丟例外。

Input schema

{
  "properties": {
    "tax_id": {
      "title": "Tax Id",
      "type": "string"
    }
  },
  "required": [
    "tax_id"
  ],
  "title": "lookup_company_by_tax_idArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see twtools-lookup_company_by_tax_id. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 twtools-lookup_company_by_tax_id 處理 "…"。

# It will call:
twtools-lookup_company_by_tax_id(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs