Finnish Company Lookup — MCP Server (PRH / YTJ)

Look up any Finnish company by Business ID (Y-tunnus) or name, straight from the official PRH / YTJ open data register — as a Model Context Protocol server your AI agent can call.

Built for AI automation agencies, n8n / LangChain builders, and internal IT teams who need Finnish company data without wrestling with Finnish API docs.

Tools

| Tool | What it does | |------|--------------| | search_companies | Search by name, location (municipality), or companyForm. Returns matches with Business ID + current name. | | get_company | Full registry detail for one businessId: current name, aux names, company form, main line of business, registered addresses, website, trade-register status, special situations. | | get_financial_periods | List the financial years a company has filed digital statements for (PRH XBRL open data). | | get_financials | Parse a company's digital financial statement into clean key figures — revenue, operating profit, profit before tax, taxes, net profit, personnel expenses, total assets, equity, liabilities (EUR) — plus the full income statement and balance sheet. Defaults to the latest year. |

Registry descriptions can be returned in en, fi, or sv via the language argument. Financial line-item labels are Finnish (from the official taxonomy); key-figure names are English.

Financials coverage: based on PRH's digital financial-statement filings, which are mostly SMEs. Many large companies do not e-file here; get_financial_periods returns an empty list when nothing is available.

Example

// get_company
{ "businessId": "2336509-6", "language": "en" }

{
  "businessId": "2336509-6",
  "name": "Supercell Oy",
  "auxiliaryNames": ["Supercell Ltd"],
  "companyForm": "Limited company",
  "mainBusinessLine": { "code": "62200", "description": "Computer consultancy ..." },
  "website": "www.supercell.com",
  "registeredInTradeRegister": true,
  "addresses": [{ "kind": "visiting", "street": "Jätkäsaarenlaituri", "postCode": "00180", "city": "HELSINKI" }]
}

Use it

Hosted (Apify) — recommended

Connect your MCP client to the Actor's Standby URL at the /mcp path. Billing is per successful tool call (Pay-Per-Event) — no keys to manage beyond your Apify token.

Local (stdio)

npm install
npm run build

Then register with any MCP client (e.g. Claude Desktop):

{
  "mcpServers": {
    "prh-ytj": { "command": "node", "args": ["/abs/path/to/servers/prh-ytj/dist/server.js"] }
  }
}

Or run the HTTP transport locally: PORT=3999 npm run standby → POST http://localhost:3999/mcp.

Develop

npm test        # unit tests against recorded PRH fixtures
npm run typecheck
npm run dev     # stdio server via tsx

Architecture (small, single-purpose units):

• src/prh/client.ts — HTTP only: PRH v3 calls, throttle, TTL cache.
• src/prh/normalize.ts — shape-mapping only: raw PRH JSON → clean agent shape.
• src/tools.ts — MCP contracts only: search_companies, get_company, optional billing hook.
• src/server.ts — stdio transport. src/standby.ts — Apify Standby HTTP transport.

Data source & attribution

Data from the Finnish Patent and Registration Office (PRH) and Tax Administration joint YTJ open data, licensed CC BY 4.0. This server is an independent tool and is not affiliated with PRH.

License

MIT