Taiwan Companies MCP server

@pipeworx/taiwan-companies

Taiwan's statutory company register (公司登記) — every incorporated company, its 統一編號, registered name, responsible person, capital, registered address and current legal standing — from the Ministry of Economic Affairs' Department of Commerce open-data service.

Part of Pipeworx — an MCP gateway connecting AI agents to 1679+ live data sources.

Tools

by company name (Chinese or partial).

• twcompanysearchname(name, status?, limit?, offset?) — search the register

統一編號 (Business Administration Number).

• twcompanybyban(ban) — the full registration record for one 8-digit

dissolved-or-revoked) with every register date converted from Minguo era.

• twcompany_status(ban) — normalized legal standing (registered / suspended /

Auth

Keyless. No registration, no key, no published quota.

Relationship to the other Taiwan packs

taiwan-procurement reads the public-tender bulletin (who won which government contract) and taiwan-stocks reads TWSE/TPEx market data for the ~1,800 listed issuers. This pack is the corporate register underneath both: it resolves a 統一編號 that appears in a tender award, and it covers the overwhelming majority of Taiwanese companies, which are not listed anywhere.

Data sources

— 公司登記基本資料 by 統一編號. Full record: capital, paid-in capital, par value, equity, address, registering authority, setup/amendment/revocation dates, suspension window.

• https://data.gcis.nat.gov.tw/od/data/api/5F64D864-61CB-4D0D-8AD9-492047CC1EA6

— 公司登記基本資料 by 公司名稱. Name search only.

• https://data.gcis.nat.gov.tw/od/data/api/6BBA2268-1367-4B42-9CCA-BC17499EBE8C

Traps, all verified live 2026-09-17

Every one of these is a silent zero — HTTP 200 with an empty body — which is the failure class nothing pages you about.

alone returns HTTP 200 and zero bytes. Only CompanyName like X and CompanyStatus eq NN returns rows. No error, no hint.

• The name search REQUIRES a status filter. $filter=Company_Name like 台積電

04 解散 (dissolved), 05 撤銷 (revoked). 02, 03, 06–09 all answer with an empty body, indistinguishable from "no such company".

• Only three status codes exist: 01 核准設立 (registered/active),

with an empty 200: 6BBA2268 ignores BusinessAccountingNO, 5F64D864 returns nothing for a Company_Name like filter.

• The two datasets are not interchangeable. Each answers the other's query

CompanyStatusDesc, so any code-based mapping silently loses the status on exactly the lookup most callers use.

• The BAN dataset omits CompanyStatus** and returns only

「此API不存在，請查明後繼續。」 — not a 404 and not JSON.

• An unknown dataset id answers HTTP 200 with Chinese prose —

1987-02-21 (076 + 1911); 1150821 is 2026-08-21. Read as a Gregorian integer it is off by 1,911 years and looks entirely plausible. Both forms are returned.

• Dates are Minguo (ROC) era, zero-padded YYYMMDD. 0760221 is

what was actually paid in. For large issuers they differ by billions of TWD.

• CapitalStockAmount is authorised capital, PaidInCapital_Amount is

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

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

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/taiwan-companies/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — askpipeworx, discovertools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

Shortened. The full README is on GitHub.