@pipeworx/cro-ireland

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/cro-ireland’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 3

Ireland’s statutory company register — name/number/status/type/address/ incorporation date for every registered company — published as open data by the CRO (Companies Registration Office). Filings/submissions history is covered separately, live, against the CRO’s own API (BYO key).

Fleet #3346, filling the one EU-register gap we didn’t cover (Companies House, Brønnøysund, Estonia, Latvia, GLEIF already shipped). Loaded live 2026-10-19: 827,248 ie_companies rows, verified table-count-matched against the ingest manifest.

Tools

• ie_search_companies(name, status?, limit?) — prefix search on a company’s current registered name (e.g. "Ryanair" finds “RYANAIR DESIGNATED ACTIVITY COMPANY” and “RYANAIR HOLDINGS PUBLIC LIMITED COMPANY”). Returns each match’s CRO number, status, type, registered address, eircode and incorporation date. status filters to one of the register’s own status TEXT values (“Normal”, “Dissolved”, “Liquidation”, etc.) — there are 30+ codes and the open data already carries a human label per row, so this filters on that label rather than the numeric code.
• ie_get_company(cro_number) — one company by its CRO number: current name, status, type, registered address, eircode, incorporation date, last/next annual-return dates, last accounts date, and dissolution date when applicable. A number with no match answers found: false, reason: "not_held", not a bare error.
• ie_get_filings(cro_number, company_bus_ind?) — an Irish company’s filing/submission history (annual returns, accounts, charges, etc.), live from the CRO’s own Open Services REST API. Requires your own CRO Open Services credentials (see Auth) — this is not in the open-data snapshot the other two tools read, only in the CRO’s live, access-controlled API.

Auth

Mixed. ie_search_companies and ie_get_company are keyless — they answer only through the Pipeworx gateway, which holds the D1 mirror; a standalone npm install has no data to read, and the tools throw a clear “not bound in this runtime” error there instead of returning an empty list.

ie_get_filings runs on a Pipeworx-supplied CRO Open Services credential (issued to Mojibake Inc. after a signed Open Services agreement, 2026-11-02), so callers need no key. A caller with their own CRO account can still pass its email as _apiKey and the key as _apiSecret (or both as _apiKey "email:key"). company_bus_ind selects a company (C, default) or a registered business name (B); the CRO rejects a filings request without it.

Data sources

• CRO (Companies Registration Office), Company Records open data. Licence: Creative Commons Attribution 4.0 (CC BY 4.0), published by the CRO on its own open-data portal as a daily snapshot, designated a “high-value dataset” under Ireland’s Open Data Directive. The exact download route lives only in scripts/cro-ireland/refresh.sh (CLAUDE.md step 9b).
• CRO (Companies Registration Office), Open Services REST API (services.cro.ie) — live, for filings/submissions only. Pipeworx-supplied credential; your own is optional.

Refreshing the mirror

bash scripts/cro-ireland/refresh.sh build   # download + build local SQLite; no remote writes
bash scripts/cro-ireland/refresh.sh load    # the above, then replace the D1 tables and verify

The CRO republishes the Company Records snapshot daily; run this on the same cadence (by hand, or via a scheduled workflow once one is applied).

Schema

scripts/cro-ireland/schema.sql: ie_companies (one row per company) + ie_meta (key/value: data_as_of, source, licence). Must stay in sync with src/store.ts’s CompanyRow.

Tools

• ie_search_companies — Search Ireland’s CRO company register by name prefix, optionally filtered by status.
• ie_get_company — One Irish company by CRO number: status, type, address, incorporation date.
• ie_get_filings — An Irish company’s filing history by CRO number, via the CRO’s live Open Services API.