Search Companies
search_companiesSearch 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.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "Nokia"
},
"name": "search_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Company name search, e.g. "Nokia". | |
| page | No | 1-based page number (default 1). | |
| location | No | Registered municipality/city, e.g. "Helsinki". | |
| businessId | No | Exact Finnish Y-tunnus, format NNNNNNN-N, e.g. "0112038-9". | |
| companyForm | No | Company form code, e.g. "17" (public limited company / Oyj), "16" (limited company / Oy). | |
| mainBusinessLine | No | Main business line code (TOL/NACE), e.g. "70100" (head office activities). |