PRH YTJ MCP Server — Finnish Company Search for AI Agents
Pricing
from $1.50 / 1,000 results
PRH YTJ MCP Server — Finnish Company Search for AI Agents
Search Finnish companies from the Patent and Registration Office open data. Find business IDs, addresses, company forms, and registration statuses. AI-agent ready for KYC, B2B lead generation, and market research.
Pricing
from $1.50 / 1,000 results
Rating
0.0
(0)
Developer
petteri mähönen
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
2 days ago
Last modified
Categories
Share
Search Finnish companies from the Patent and Registration Office (PRH) open data API. Retrieve business IDs (Y-tunnus), company names, addresses, legal forms, and registration statuses. No browser, no proxies — pure REST API.
🧠 MCP Server — AI Agent Ready
This actor is a Model Context Protocol (MCP) server — AI assistants (Claude, GPT, Cursor) can call it directly:
{"searchQuery": "Kone", "maxResults": 5}
Returns structured Finnish company data with business IDs, addresses, and registration info.
Features
- Search by name — partial name search across current and historical names
- Search by business ID — exact Y-tunnus lookup (format: 1234567-8)
- Filter by location — narrow results to a postal city (Helsinki, Tampere, etc.)
- Filter by company form — OY (limited), OYJ (public), KY (partnership), TOIMINIMI (sole trader)
- Free open data — no API key, no rate limits, Creative Commons 4.0 licensed
- Ultra cheap — 256MB RAM, no browser overhead
Input
| Parameter | Type | Default | Description |
|---|---|---|---|
searchQuery | string | — | Company name or partial name to search |
businessId | string | — | Exact Finnish business ID (Y-tunnus, e.g. 0194099-3) |
location | string | — | Postal city to filter by |
companyForm | string | — | Company form code (OY, OYJ, KY, TOIMINIMI, etc.) |
maxResults | integer | 10 | Maximum results (max 500) |
At least one search parameter is required.
Output
Each result contains:
| Field | Type | Description |
|---|---|---|
businessId | string | Finnish business ID (Y-tunnus) |
name | string | Current registered company name |
aliases | array | Previous names and auxiliary trade names |
companyForm | string | Legal form description (e.g. "Osakeyhtiö") |
companyFormCode | string | Legal form code (e.g. "OY") |
registrationDate | string | Date of first trade register registration |
address | object | Street, city, post code, country |
contact | object | Phone, email, website |
language | string | Company's registered language |
liquidations | array | Liquidation records (if any) |
bankruptcies | array | Bankruptcy records (if any) |
registeredNotices | integer | Number of registered notices |
scrapedAt | string | ISO timestamp of the query |
Example
Input:
{"searchQuery": "Nokia","maxResults": 3}
Output:
[{"businessId": "0194099-3","name": "Fysios Mehiläinen Oy","companyForm": "Osakeyhtiö","companyFormCode": "OY","registrationDate": "1978-06-09","address": { "street": "Mannerheimintie 3", "city": "Helsinki", "postCode": "00100", "country": "FI" },"contact": { "phone": "", "email": "", "url": "https://..." }}]
Data Source
PRH Open Data API — Creative Commons 4.0 (CC BY 4.0). Data is updated daily from the Finnish Trade Register. Must credit PRH as the source when using the data.
Performance
- Memory: 256 MB
- Runtime: <1 second for most queries
- Cost: ~$0.001 per run (10 results)
- Rate limit: None detected (free public API)