# PRH YTJ MCP Server — Finnish Company Search for AI Agents (`longanimous_bracken/prh-ytj-company-search`) Actor 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. - **URL**: https://apify.com/longanimous\_bracken/prh-ytj-company-search.md - **Developed by:** [petteri mähönen](https://apify.com/longanimous_bracken) (community) - **Categories:** Lead generation, Business, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## PRH YTJ MCP Server — Finnish Company Search for AI Agents 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: ```json {"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:** ```json { "searchQuery": "Nokia", "maxResults": 3 } ``` **Output:** ```json [ { "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](https://avoindata.prh.fi/) — 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) # Actor input Schema ## `searchQuery` (type: `string`): MCP tool input: company name or partial name to search. Examples: 'Nokia', 'Kone', 'VR-Yhtymä'. Searches current and previous names, auxiliary names, and trade names. ## `businessId` (type: `string`): MCP tool input: exact Finnish business ID (Y-tunnus). Format: 1234567-8. If provided, other search parameters are ignored. ## `location` (type: `string`): MCP tool input: filter by postal city. Examples: 'Helsinki', 'Tampere', 'Espoo'. Used together with company name for targeted searches. ## `companyForm` (type: `string`): MCP tool input: filter by company form code. Examples: 'OY' (limited company), 'OYJ' (public limited), 'KY' (limited partnership), 'AVOIN YHTIÖ' (general partnership), 'TOIMINIMI' (sole trader). ## `maxResults` (type: `integer`): MCP tool input: maximum companies to return. Recommended: 10-20 for AI agent consumption. Max: 500. ## Actor input object example ```json { "maxResults": 10 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "", "businessId": "", "location": "", "companyForm": "" }; // Run the Actor and wait for it to finish const run = await client.actor("longanimous_bracken/prh-ytj-company-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "", "businessId": "", "location": "", "companyForm": "", } # Run the Actor and wait for it to finish run = client.actor("longanimous_bracken/prh-ytj-company-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "", "businessId": "", "location": "", "companyForm": "" }' | apify call longanimous_bracken/prh-ytj-company-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=longanimous_bracken/prh-ytj-company-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PRH YTJ MCP Server — Finnish Company Search for AI Agents", "description": "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.", "version": "0.1", "x-build-id": "9bHAAVOcbe1e11Fqu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/longanimous_bracken~prh-ytj-company-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-longanimous_bracken-prh-ytj-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/longanimous_bracken~prh-ytj-company-search/runs": { "post": { "operationId": "runs-sync-longanimous_bracken-prh-ytj-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/longanimous_bracken~prh-ytj-company-search/run-sync": { "post": { "operationId": "run-sync-longanimous_bracken-prh-ytj-company-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Company Name", "type": "string", "description": "MCP tool input: company name or partial name to search. Examples: 'Nokia', 'Kone', 'VR-Yhtymä'. Searches current and previous names, auxiliary names, and trade names." }, "businessId": { "title": "Business ID (Y-tunnus)", "pattern": "^\\d{7}-\\d$", "type": "string", "description": "MCP tool input: exact Finnish business ID (Y-tunnus). Format: 1234567-8. If provided, other search parameters are ignored." }, "location": { "title": "Location (Postal City)", "type": "string", "description": "MCP tool input: filter by postal city. Examples: 'Helsinki', 'Tampere', 'Espoo'. Used together with company name for targeted searches." }, "companyForm": { "title": "Company Form", "type": "string", "description": "MCP tool input: filter by company form code. Examples: 'OY' (limited company), 'OYJ' (public limited), 'KY' (limited partnership), 'AVOIN YHTIÖ' (general partnership), 'TOIMINIMI' (sole trader)." }, "maxResults": { "title": "Max Results", "type": "integer", "description": "MCP tool input: maximum companies to return. Recommended: 10-20 for AI agent consumption. Max: 500.", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```