# 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:

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

### 2. Add it to your MCP client

**Claude Desktop** (`claude_desktop_config.json`):

```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.

## Data & attribution

Data from PRH/YTJ (Finnish Patent and Registration Office / Business Information System)
open data. This project is not affiliated with or endorsed by PRH or YTJ.

## License

MIT © Nectia Automation. The bridge code is open source; the hosted Actor is a commercial
service.