{
  "markdown": "# @pipeworx/hk-companies\n\nHong Kong Companies Registry (香港公司註冊處) open data — a live feed of\ncompanies newly incorporated, registered, or renamed on the register, with a\nname/BR-number search and an HKEX ticker join.\n\nPart of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1534+ live data sources.\n\n## Tools\n\n- `hk_company_search({ name?, brn?, type?, since?, limit? })` — search by\n  company name (English or Chinese, substring) or exact BR number. Returns BR\n  number, English/Chinese name, type, incorporation/registration date, any\n  name-change date, and the matching HKEX ticker when the name resolves to a\n  listed stock.\n- `hk_company({ brn, since? })` — look up one company's full history (initial\n  incorporation/registration + any renames) by BR number.\n- `hk_new_companies({ since?, type?, limit? })` — companies newly incorporated\n  or registered since a date, most recent first.\n- `hk_company_name_changes({ since?, limit? })` — companies that changed their\n  registered name since a date, most recent first.\n\n## Auth\n\nKeyless. `data.gov.hk` and `cr.gov.hk` are public, unauthenticated open data.\n\n## Data source — verified live 2026-09-07\n\nThe Companies Registry's open-data landing page (`cr.gov.hk/en/open-data/`) is\n404 and `data.gov.hk`'s own HTML dataset listing is client-rendered (zero\n`<a href>`s in the page source), so the real resource URLs come only from\n`data.gov.hk`'s CKAN-style API, found via its org slug for the Registry:\n\n```\nhttps://data.gov.hk/en-data/api/3/action/organization_show?id=hk-cr\nhttps://data.gov.hk/en-data/api/3/action/package_show?id=hk-cr-crdata-list-newly-registered-companies-2526\n```\n\nThat package lists ~350 weekly CSV resource pairs, one per week since\n2024-12-30:\n\n- `https://www.cr.gov.hk/docs/wrpt/RNC063/RNC063L_YYYYMMDD.csv` — Hong Kong\n  local companies (newly incorporated / re-domiciled / renamed)\n- `https://www.cr.gov.hk/docs/wrpt/RNC063/RNC063F_YYYYMMDD.csv` — non-Hong\n  Kong companies (newly registered / re-domiciled / renamed)\n\n`YYYYMMDD` is the Monday of the covered week; each file covers that Monday\nthrough the following Sunday. Publication runs roughly a week behind (the\n24-30 Aug 2026 week was published 2 Sep).\n\nThis pack fetches the live resource list from `package_show` on every call\n(no guessed URL pattern), then only fetches the CSV weeks that can contain a\nmatch, in parallel, bounded to 20 weeks per company type per call so one\nrequest can't fan out into hundreds of upstream fetches. `hk_company_search`\nand `hk_company` default to a 12-week lookback unless `since` is given (as\nfar back as `2024-12-30`, the dataset start); `hk_new_companies` and\n`hk_company_name_changes` default to the 7 days before the latest published\nweek.\n\n### CSV shapes (they differ — verified from a live fetch of both)\n\nLocal (`RNC063L`): `Seq, Current Company Name in English, Current Company\nName in Chinese, BR Number, Date of Incorporation / Re-domiciliation Date,\nDate of Change of name` — English and Chinese are already separate columns.\n\nNon-HK (`RNC063F`): `Seq, Current Corporate Name / Other Corporate Name,\nCurrent Approved Name for Carrying on Business in H.K., BR Number, Date of\nRegistration, Date of Change of name` — there is **no separate Chinese-name\ncolumn**. A non-HK company with both an English and a Chinese name gets two\nphysical rows sharing the same BR number and Seq, one name per row in the\nsingle \"Current Corporate Name / Other Corporate Name\" column. This pack\nmerges those pairs by BR number (routing CJK text to `name_zh`, everything\nelse to `name_en`) rather than surfacing them as two different companies.\n\n## Scope limit — found during research, not assumed\n\nThis is the **only** company-level open dataset the Companies Registry\npublishes. Its other three `data.gov.hk` packages under org `hk-cr`\n(`crdata-stat-non-hk-companies`, `crdata-stat-local-companies-incorporated`,\n`crdata-stat-local-companies`) are aggregate **monthly counts** (public /\nprivate / guarantee company totals), not per-company records — checked live,\nthey carry no name, BR number, or address fields. `data.gov.hk`'s org for the\nInland Revenue Department (`hk-ird`) publishes **zero** datasets, so Business\nRegistration data has no open API either.\n\nThere is **no open, keyless API that returns a company's registered address\nor status** for an arbitrary Hong Kong company. That is the Companies\nRegistry's paid Cyber Search Centre (ICRIS) product — a per-document\ncommercial search, not open data. So:\n\n- This pack can resolve a **name or BR number** for anything newly\n  incorporated, registered, or renamed since **2024-12-30**.\n- It **cannot** answer \"what is the registered address of `<any company>`\"\n  for a company outside that window (most established companies, including\n  every HKEX-listed blue chip) — there is genuinely no open source for that.\n  Every tool description says so rather than let a caller assume more than\n  the data supports.\n- Money-lender and TCSP-licensee registers were in scope per the original\n  ask; neither exists as an open dataset on `data.gov.hk` (checked: zero\n  results searching \"money lender\", \"TCSP\", \"trust company\", \"licensed money\n  lenders\" against the CKAN API) — not built.\n\n## HKEX ticker join\n\n`hk_company_search` and `hk_company` call the same keyless Yahoo Finance\nsearch endpoint `@pipeworx/hk-stocks`'s `hk_resolve_symbol` uses (called\ndirectly here, not cross-pack, since packs don't call each other at\nruntime), restricted to `.HK`-suffixed symbols, and only attach a ticker on a\nnormalized exact-name match (stripping \"Limited\"/\"Ltd\"/\"Co\"/\"Holdings\"/\n\"Group\" and non-alphanumerics) — never a fuzzy guess. In practice this fires\nrarely: a company appearing in this feed was newly incorporated, registered,\nor renamed in the last ~20 months, and HKEX-listed companies are almost\nalways older than that.\n\n## Data lag\n\nThe feed publishes roughly a week behind. A `since` date newer than the\nlatest published week returns `count: 0` with a `data_lag_note` field\nexplaining that this is publication lag, not \"no new companies\" — check that\nfield before reading a zero as a clean result.\n\n## Quick Start\n\nAdd to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"hk-companies\": {\n      \"url\": \"https://gateway.pipeworx.io/hk-companies/mcp\"\n    }\n  }\n}\n```\n\n### What this endpoint actually serves\n\n`tools/list` at `https://gateway.pipeworx.io/hk-companies/mcp` returns the tools in the table\nabove **plus the shared Pipeworx meta-tools** — `ask_pipeworx`,\n`discover_tools`, `search_within`, `remember`/`recall` and the rest of the\ngateway-wide set. So the tool count you see is larger than this table: a\nsingle-pack endpoint currently lists roughly 30 shared tools alongside the\npack's own. The connection's `initialize` response states its exact scope, and\nis the authoritative answer for a given day.\n\nThis is deliberate, not multiplexing by accident. The meta-tools are what let a\nscoped connection answer a question this pack does not cover — via\n`ask_pipeworx`, which routes across the whole catalog — without you adding a\nsecond MCP server. There is currently no way to mount a pack endpoint without\nthem; if the extra schemas cost you more context than the routing is worth,\nconnect to the full gateway once rather than to several pack endpoints.\n\nOr connect to the full Pipeworx gateway to get every pack's tools listed\ndirectly, instead of just this one's:\n\n```json\n{\n  \"mcpServers\": {\n    \"pipeworx\": {\n      \"url\": \"https://gateway.pipeworx.io/mcp\"\n    }\n  }\n}\n```\n\nBoth URLs reach the same gateway and the same 1534+ data sources. The\nonly difference is which pack's tools are listed **directly**; `ask_pipeworx`\nreaches all of them from either one.\n\n## Using with ask_pipeworx\n\nInstead of calling tools directly, you can ask questions in plain English —\nthis works on the pack endpoint above as well as on the full gateway:\n\n```\nask_pipeworx({ question: \"your question about Hk Companies data\" })\n```\n\nThe gateway picks the right tool and fills the arguments automatically.\n\n## More\n\n- [Docs and guides](https://pipeworx.io/docs)\n- [pipeworx.io](https://pipeworx.io)\n\n## License\n\nMIT\n",
  "bytes": 8195,
  "sha": "29ba7eee55665cd3656438949ea7620caea7ceb7387d5700ed4484c6a60597d1",
  "repo_slug": "pipeworx-io/mcp-hk-companies",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pipeworx_io_hk_companies_11b538a9/readme"
}