# mcp-finnish-companies 🇫🇮

MCP server for the Finnish company registry (PRH/YTJ - Patent and Registration Office). Part of the [Nordic MCP Toolkit](https://github.com/robobobby).

## Features

- **Search companies** by name, location, Business ID, company form, or industry
- **Lookup by Business ID** (Y-tunnus) with full detail: addresses, registers, history
- **Industry search** using TOL 2008 classification codes or text
- **Recent registrations** tracker for new business formation trends
- Free government open data API (CC BY 4.0), no API key required

## Tools

| Tool | Description |
|------|-------------|
| `search_companies` | Search by name, location, Business ID, company form, industry, or postal code |
| `company_lookup` | Detailed lookup by Finnish Business ID (Y-tunnus) |
| `search_by_industry` | Find companies by TOL 2008 industry classification |
| `recent_registrations` | Track newly registered companies over a time period |

## Installation

```json
{
  "mcpServers": {
    "finnish-companies": {
      "command": "npx",
      "args": ["-y", "mcp-finnish-companies"]
    }
  }
}
```

Or run locally:

```bash
git clone https://github.com/robobobby/mcp-finnish-companies.git
cd mcp-finnish-companies
npm install
node src/index.js
```

## Examples

- "Find tech companies in Helsinki" → `search_companies` with location="Helsinki", business_line="62010"
- "Look up Nokia's details" → `search_companies` with name="Nokia", company_form="OYJ"
- "What companies were registered in Tampere this week?" → `recent_registrations` with location="Tampere"
- "Look up Business ID 0112038-9" → `company_lookup` with business_id="0112038-9"

## Company Form Codes

| Code | Type |
|------|------|
| OY | Limited company (Osakeyhtiö) |
| OYJ | Public limited company (Julkinen osakeyhtiö) |
| KY | Limited partnership (Kommandiittiyhtiö) |
| AY | General partnership (Avoin yhtiö) |
| OK | Cooperative (Osuuskunta) |
| SÄÄ | Foundation (Säätiö) |

## API

Uses the [PRH Open Data YTJ API v3](https://avoindata.prh.fi/en) (Creative Commons BY 4.0). Free, no authentication required.

## Part of the Nordic MCP Toolkit

- 🇩🇰 [mcp-danish-cvr](https://github.com/robobobby/mcp-danish-cvr) - Danish company registry
- 🇩🇰 [mcp-danish-addresses](https://github.com/robobobby/mcp-danish-addresses) - Danish addresses (DAWA)
- 🇩🇰 [mcp-danish-weather](https://github.com/robobobby/mcp-danish-weather) - Danish weather (DMI)
- 🇩🇰 [mcp-danish-energy](https://github.com/robobobby/mcp-danish-energy) - Danish energy data
- 🇳🇴 [mcp-norwegian-companies](https://github.com/robobobby/mcp-norwegian-companies) - Norwegian company registry
- 🇫🇮 **mcp-finnish-companies** - Finnish company registry (this one)

## License

MIT