search_companies
Pack: prh-fi · Endpoint: https://gateway.pipeworx.io/prh-fi/mcp
Search the Finnish business register (PRH / YTJ) by company name and/or filters. Results under {totalResults, companies:[…]}. Each company has businessId (Y-tunnus), names[], mainBusinessLine, companyForms[], addresses[], status. e.g. {name:“Nokia”} or {name:“Oy”, location:“Helsinki”, companyForm:“17”}. Use businessId here for an exact single-company lookup, or call get_company.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | no | Company name search, e.g. “Nokia”. |
location | string | no | Registered municipality/city, e.g. “Helsinki”. |
businessId | string | no | Exact Finnish Y-tunnus, format NNNNNNN-N, e.g. “0112038-9”. |
companyForm | string | no | Company form code, e.g. “17” (public limited company / Oyj), “16” (limited company / Oy). |
mainBusinessLine | string | no | Main business line code (TOL/NACE), e.g. “70100” (head office activities). |
page | number | no | 1-based page number (default 1). |
Example call
curl -X POST https://gateway.pipeworx.io/prh-fi/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_companies","arguments":{}}}'Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"prh-fi": {
"url": "https://gateway.pipeworx.io/prh-fi/mcp"
}
}
}See Getting Started for client-specific install steps.