prh-mcp-server 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * PRH MCP Server — Finnish company registry.
+ * FREE public API. No authentication required.
+ * Look up any Finnish company: business ID, name, address, business lines, company form.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { PrhClient } from "./prh-client.js";
+const server = new McpServer({ name: "prh-mcp-server", version: "1.0.0" });
+const client = new PrhClient();
+function json(data) { return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; }
+server.tool("search_companies", "Search Finnish companies by name, business ID, location, company form, or business line. Free public data from PRH (Finnish Patent and Registration Office).", {
+    name: z.string().optional().describe("Company name (partial match works)"),
+    businessId: z.string().optional().describe("Y-tunnus / Business ID (e.g. 0112038-9)"),
+    location: z.string().optional().describe("City (e.g. Helsinki, Tampere, Espoo)"),
+    companyForm: z.string().optional().describe("Company form: OY, OYJ, KY, AY, TMI, etc."),
+    mainBusinessLine: z.string().optional().describe("Business line code or text"),
+    postCode: z.string().optional().describe("Postal code"),
+    page: z.string().optional().describe("Page number (starts at 0)"),
+}, async (p) => json(await client.searchCompanies(p)));
+server.tool("get_company_by_id", "Look up a specific Finnish company by its exact business ID (Y-tunnus). Returns full details including all names, addresses, business lines, and registration info.", {
+    businessId: z.string().describe("Y-tunnus (e.g. 0112038-9 for Nokia Oyj)"),
+}, async ({ businessId }) => json(await client.searchCompanies({ businessId })));
+server.tool("get_code_descriptions", "Get PRH codeset descriptions (company forms, register types, etc.).", {
+    code: z.string().describe("Code: YRMU (company forms), TOIMI (business lines), KONK (bankruptcy status), etc."),
+    lang: z.string().optional().describe("Language: fi, en, sv (default: en)"),
+}, async ({ code, lang }) => json(await client.getDescriptions(code, lang)));
+server.tool("get_post_codes", "Get Finnish postal code directory.", {
+    lang: z.string().optional().describe("Language: fi, en, sv (default: fi)"),
+}, async ({ lang }) => json(await client.getPostCodes(lang)));
+async function main() { await server.connect(new StdioServerTransport()); }
+main().catch((e) => { console.error("Server error:", e); process.exit(1); });

package/dist/prh-client.d.ts

@@ -0,0 +1,14 @@
+export declare class PrhClient {
+    private request;
+    searchCompanies(params: {
+        name?: string;
+        businessId?: string;
+        location?: string;
+        companyForm?: string;
+        mainBusinessLine?: string;
+        postCode?: string;
+        page?: string;
+    }): Promise<unknown>;
+    getDescriptions(code: string, lang?: string): Promise<unknown>;
+    getPostCodes(lang?: string): Promise<unknown>;
+}

package/dist/prh-client.js

@@ -0,0 +1,29 @@
+/**
+ * PRH (Finnish Patent and Registration Office) public API client.
+ * API docs: https://avoindata.prh.fi/
+ * Auth: NONE — this is free public data, no API key needed.
+ */
+const BASE_URL = "https://avoindata.prh.fi/opendata-ytj-api/v3";
+export class PrhClient {
+    async request(url, params) {
+        const u = new URL(url);
+        if (params)
+            for (const [k, v] of Object.entries(params)) {
+                if (v)
+                    u.searchParams.set(k, v);
+            }
+        const res = await fetch(u.toString(), { headers: { Accept: "application/json" } });
+        if (!res.ok)
+            throw new Error(`PRH API error ${res.status}: ${await res.text()}`);
+        return res.json();
+    }
+    async searchCompanies(params) {
+        return this.request(`${BASE_URL}/companies`, params);
+    }
+    async getDescriptions(code, lang = "en") {
+        return this.request(`${BASE_URL}/description`, { code, lang });
+    }
+    async getPostCodes(lang = "fi") {
+        return this.request(`${BASE_URL}/post_codes`, { lang });
+    }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "prh-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for PRH (Finnish Patent and Registration Office) — Look up Finnish company data, board members, financial reports. Free public API, no auth required.",
+  "main": "dist/index.js",
+  "bin": {
+    "prh-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "prh",
+    "finland",
+    "finnish",
+    "company-registry",
+    "yritysrekisteri",
+    "kaupparekisteri",
+    "model-context-protocol"
+  ],
+  "author": "Viggo Johansson",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * PRH MCP Server — Finnish company registry.
+ * FREE public API. No authentication required.
+ * Look up any Finnish company: business ID, name, address, business lines, company form.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { PrhClient } from "./prh-client.js";
+
+const server = new McpServer({ name: "prh-mcp-server", version: "1.0.0" });
+const client = new PrhClient();
+function json(data: unknown) { return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] }; }
+
+server.tool("search_companies", "Search Finnish companies by name, business ID, location, company form, or business line. Free public data from PRH (Finnish Patent and Registration Office).", {
+  name: z.string().optional().describe("Company name (partial match works)"),
+  businessId: z.string().optional().describe("Y-tunnus / Business ID (e.g. 0112038-9)"),
+  location: z.string().optional().describe("City (e.g. Helsinki, Tampere, Espoo)"),
+  companyForm: z.string().optional().describe("Company form: OY, OYJ, KY, AY, TMI, etc."),
+  mainBusinessLine: z.string().optional().describe("Business line code or text"),
+  postCode: z.string().optional().describe("Postal code"),
+  page: z.string().optional().describe("Page number (starts at 0)"),
+}, async (p) => json(await client.searchCompanies(p)));
+
+server.tool("get_company_by_id", "Look up a specific Finnish company by its exact business ID (Y-tunnus). Returns full details including all names, addresses, business lines, and registration info.", {
+  businessId: z.string().describe("Y-tunnus (e.g. 0112038-9 for Nokia Oyj)"),
+}, async ({ businessId }) => json(await client.searchCompanies({ businessId })));
+
+server.tool("get_code_descriptions", "Get PRH codeset descriptions (company forms, register types, etc.).", {
+  code: z.string().describe("Code: YRMU (company forms), TOIMI (business lines), KONK (bankruptcy status), etc."),
+  lang: z.string().optional().describe("Language: fi, en, sv (default: en)"),
+}, async ({ code, lang }) => json(await client.getDescriptions(code, lang)));
+
+server.tool("get_post_codes", "Get Finnish postal code directory.", {
+  lang: z.string().optional().describe("Language: fi, en, sv (default: fi)"),
+}, async ({ lang }) => json(await client.getPostCodes(lang)));
+
+async function main() { await server.connect(new StdioServerTransport()); }
+main().catch((e) => { console.error("Server error:", e); process.exit(1); });

package/src/prh-client.ts

@@ -0,0 +1,36 @@
+/**
+ * PRH (Finnish Patent and Registration Office) public API client.
+ * API docs: https://avoindata.prh.fi/
+ * Auth: NONE — this is free public data, no API key needed.
+ */
+const BASE_URL = "https://avoindata.prh.fi/opendata-ytj-api/v3";
+
+export class PrhClient {
+  private async request<T>(url: string, params?: Record<string, string>): Promise<T> {
+    const u = new URL(url);
+    if (params) for (const [k, v] of Object.entries(params)) { if (v) u.searchParams.set(k, v); }
+    const res = await fetch(u.toString(), { headers: { Accept: "application/json" } });
+    if (!res.ok) throw new Error(`PRH API error ${res.status}: ${await res.text()}`);
+    return res.json() as Promise<T>;
+  }
+
+  async searchCompanies(params: {
+    name?: string;
+    businessId?: string;
+    location?: string;
+    companyForm?: string;
+    mainBusinessLine?: string;
+    postCode?: string;
+    page?: string;
+  }) {
+    return this.request<unknown>(`${BASE_URL}/companies`, params);
+  }
+
+  async getDescriptions(code: string, lang: string = "en") {
+    return this.request<unknown>(`${BASE_URL}/description`, { code, lang });
+  }
+
+  async getPostCodes(lang: string = "fi") {
+    return this.request<unknown>(`${BASE_URL}/post_codes`, { lang });
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"]
+}