Cro Ireland MCP server

@pipeworx/cro-ireland

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).

Part of Pipeworx — an MCP gateway connecting AI agents to 1875+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

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

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.

• iesearchcompanies(name, status?, limit?) -- prefix search on a

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.

• iegetcompany(cro_number) -- one company by its CRO number: current

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.

• iegetfilings(cronumber, apiKey, _apiSecret) -- an Irish company's

Auth

Mixed. iesearchcompanies and iegetcompany 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.

iegetfilings is BYO key, no platform key exists. The CRO's Open Services API (services.cro.ie) requires a CustomerKey the CRO issues only after a signed Open Services Terms & Conditions submission -- verified live 2026-10-19: every endpoint returns 401 Access denied. Invalid API credentials in Header. with no credential at all. That is a contractual step (CLAUDE.md "What we will source" -- vendor terms you actually accept are Bruce's call, not an agent's), so this tool is BYOK: pass your own registered account email as apiKey and the API key the CRO issued you as apiSecret. Without both it refuses in words -- "CRO Open Services requires an API key" -- rather than guessing or substituting other data. A Needs Bruce item is filed for whether to pursue a platform key.

Data sources

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), Company Records open data. Licence:

(services.cro.ie) -- live, for filings/submissions only. BYO credential; no platform key.

• CRO (Companies Registration Office), Open Services REST API

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

Shortened. The full README is on GitHub.