0.1.0 • Published 2d agoCLI

finnish-company-mcp-server

Licence

MIT

Version

0.1.0

Deps

Size

8 kB

Vulns

Weekly

Summary Dependency Versions

Finnish Company Lookup & Financials MCP

Look up any Finnish company with your AI agent. Official registry data (name, Business ID / Y-tunnus, address, company form, registration status), parsed financial statements (revenue, profit, balance sheet), and registered notices — from PRH/YTJ, Finland's Business Register.

Example: "What is Supercell's Business ID and latest revenue?" → the agent finds the company and returns its registry details and financial key figures.

This package is a lightweight, open bridge that connects any MCP client (Claude Desktop, etc.) to the hosted, maintained Finnish company MCP server on Apify. The bridge holds no data logic — it forwards your requests to the hosted service, which does the real work (registry lookups, XBRL financial-statement parsing) and meters usage to your own Apify account.

Tools

Tool	What it does
`search_companies`	Find companies by name.
`get_company`	Registry details by Business ID (Y-tunnus).
`get_financial_periods`	List a company's available financial statement periods.
`get_financials`	Parsed key figures + income statement + balance sheet (EUR).
`get_company_notices`	Registered filings / change monitoring (KYC).

Languages: English, Finnish, Swedish.

Setup

1. Get access + an Apify API token

This bridge calls a hosted, paid Actor on Apify. You need your own Apify account and API token:

Open the Actor on the Apify Store: https://apify.com/nectia/finnish-company-lookup-mcp
Subscribe / rent the Actor (billed per call — pay only for what you use).
Copy your token from Apify Console → Settings → Integrations → API token.

2. Add it to your MCP client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "finnish-company": {
      "command": "npx",
      "args": ["-y", "finnish-company-mcp-server"],
      "env": {
        "APIFY_API_TOKEN": "PASTE_YOUR_APIFY_TOKEN_HERE"
      }
    }
  }
}

Restart your client. No build step, no other keys.

How it works

Your MCP client  ──stdio──►  finnish-company-mcp-server (this bridge)  ──HTTPS──►  Hosted Actor on Apify  ──►  PRH/YTJ API

The bridge authenticates to the hosted Actor with your APIFY_API_TOKEN and transparently proxies the tools. Your token stays on your machine; Apify meters the calls to your account.