MCPサーバー

nimistu — Estonian Business Register

io.github.Nimistu/nimistu-mcp
ビジネス・業務 データ・分析 公開・接続可能 MCP 2025-11-25

このMCPでできること

Searches and analyzes Estonian business-register data covering companies, people, ownership, financial reports, activities, trademarks, and rankings.

annual_reports
Annual reports (majandusaasta aruanded) for an Estonian company
Every filed annual report for one company, newest first: revenue, profit, employees, equity, assets, liabilities and labour cost, plus ratios computed from them (net margin, revenue and profit per employee, year-over-year revenue change, equity ratio, current ratio, labour share) and where the latest year sits against the company's EMTAK sector median. Use `get_company` for the profile; use this when the question is about financial history or performance.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reg_code'], 'properties': {'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'How many years to return, newest first. Default 10.'}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}, 'reg_code': {'type': 'string', 'description': "8-digit Estonian registry code (e.g. '10000018')."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['regCode', 'name', 'reports', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'ratios': {'description': 'Computed from the latest report: { netMarginPct, revenuePerEmployee, profitPerEmployee, revenueGrowthPct, equityRatioPct, currentRatio, labourSharePct }. Null when nothing has been filed.'}, 'sector': {'description': 'Peer comparison for the latest year: { key, level, companies, medianRevenueEur, medianMarginPct, medianRevPerEmployee, medianGrowthPct }, or null when the sector has too few filers.'}, 'regCode': {'type': 'string'}, 'reports': {'type': 'array', 'items': {}, 'description': 'One entry per filed year: { year, revenueEur, profitEur, employees, equityEur, totalAssetsEur, liabilitiesEur, labourCostsEur, isAudited }.'}}, 'additionalProperties': False}
companies_by_emtak
List companies by EMTAK activity
List active Estonian companies whose primary activity is a given EMTAK code, optionally filtered by county. Use `lookup_emtak` to find the code first.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': "Exact EMTAK code, e.g. '47811'."}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max companies to return (default 25).'}, 'county': {'type': 'string', 'description': "Optional county filter, e.g. 'Harju maakond'."}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['code', 'rows', 'url'], 'properties': {'url': {'type': 'string'}, 'code': {'type': 'string'}, 'rows': {'type': 'array', 'items': {}, 'description': 'Companies with name, reg_code and city.'}, 'total': {'description': 'Total active companies matching (number).'}}, 'additionalProperties': False}
fetch
Fetch a nimistu record by id
Retrieve the full content of a record by the `id` returned from `search` (e.g. 'company:10000018', 'person:18345', 'trademark:123', 'emtak:47811'). Returns the record text, its canonical nimistu.ee URL and metadata.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': "Record id from search, formatted '<type>:<value>'."}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'title', 'text', 'url', 'metadata'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'description': 'Canonical nimistu.ee URL for the record.'}, 'text': {'type': 'string', 'description': 'The full record rendered as Markdown.'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'description': 'Type-specific metadata, e.g. { type, regCode }.', 'additionalProperties': {}}}, 'additionalProperties': False}
get_company
Get full company profile
Full profile of an Estonian company by its registry code: status, address, activity (EMTAK), VAT, employees, financials, tax debt, sanctions, board members, shareholders, supervisory board, foreign parent, subsidiaries and trademarks.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reg_code'], 'properties': {'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}, 'reg_code': {'type': 'string', 'description': "8-digit Estonian registry code (e.g. '10000018')."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['regCode', 'name', 'board', 'shareholders', 'council', 'founders', 'subsidiaryCount', 'trademarkCount', 'url'], 'properties': {'lei': {}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'board': {'type': 'array', 'items': {}, 'description': 'Current board members.'}, 'email': {}, 'phone': {}, 'county': {}, 'status': {}, 'address': {}, 'council': {'type': 'array', 'items': {}, 'description': 'Supervisory board.'}, 'regCode': {'type': 'string'}, 'website': {}, 'activity': {}, 'founders': {'type': 'array', 'items': {}}, 'emtakCode': {}, 'legalForm': {}, 'vatNumber': {}, 'taxDebtEur': {}, 'registeredAt': {}, 'shareholders': {'type': 'array', 'items': {}}, 'employeeCount': {}, 'foreignParent': {'description': '{ name, country, regCode } or null.'}, 'lastProfitEur': {}, 'sanctionCount': {}, 'deregisteredAt': {}, 'lastReportYear': {}, 'lastRevenueEur': {}, 'trademarkCount': {'type': 'number'}, 'shareCapitalEur': {}, 'subsidiaryCount': {'type': 'number'}}, 'additionalProperties': False}
get_person
Get a person and their company connections
Profile of a person in the Estonian business register: birth year, sanctions, and all companies they are connected to (board member, shareholder, etc.), current and past. Look the person up with `search` first to get their id.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'id': {'type': 'integer', 'description': 'Internal person id (from a search result, e.g. 18345).'}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}, 'isikukood': {'type': 'string', 'description': 'Estonian personal identification code (11 digits), if known.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'connectionCount', 'connections', 'url'], 'properties': {'id': {}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'country': {}, 'birthYear': {}, 'connections': {'type': 'array', 'items': {}, 'description': 'Companies the person is/was connected to, each with its roles.'}, 'sanctionCount': {}, 'connectionCount': {'type': 'number'}}, 'additionalProperties': False}
lookup_emtak
Look up or search EMTAK activity codes
EMTAK is the Estonian classification of economic activities. Pass `code` for details + stats on one activity, or `query` to search activities by Estonian name. Returns the code, ET/EN name and the count of active companies.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'description': "Exact EMTAK code, e.g. '47811'."}, 'query': {'type': 'string', 'description': "Search activities by Estonian keyword, e.g. 'jaemüük'."}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string'}, 'code': {'type': 'string'}, 'query': {'type': 'string'}, 'stats': {}, 'nameEn': {}, 'nameEt': {}, 'results': {'type': 'array', 'items': {}}, 'counties': {'type': 'array', 'items': {}}, 'activeCompanies': {}}, 'additionalProperties': False}
rankings
Top lists / rankings of Estonian companies and people
Curated leaderboards from the nimistu data: top taxpayers, revenue, profit, employers, tax debtors, grant recipients, procurement winners, people holding the most board seats, audit firms, recipients of state payments, VAT groups, top corporate shareholders, and members of Parliament (Riigikogu) or the Cabinet active in business.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['list'], 'properties': {'list': {'enum': ['top_taxpayers', 'top_revenue', 'top_profit', 'top_employers', 'top_tax_debtors', 'top_grant_recipients', 'top_procurement_winners', 'top_board_seat_holders', 'top_audit_firms', 'top_state_payments', 'top_vat_groups', 'top_shareholder_companies', 'riigikogu_in_business', 'cabinet_in_business'], 'type': 'string', 'description': 'Which leaderboard to return.'}, 'year': {'type': 'integer', 'description': 'Year for financial lists (taxpayers/revenue/profit/employers). Defaults to the latest available.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many rows (default 20).'}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['list', 'rows'], 'properties': {'list': {'type': 'string'}, 'rows': {'type': 'array', 'items': {}, 'description': 'Ranked entries for the requested leaderboard.'}, 'year': {'description': 'Year used for financial lists, or null.'}}, 'additionalProperties': False}
search
Search Estonian companies, people and trademarks
Full-text search across the nimistu register of Estonian companies, people and trademarks. Returns matches each with a stable `id` (pass to `fetch`, `get_company` or `get_person`) and a canonical nimistu.ee URL. Use this first to locate an entity by name or registry code.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'A company name, person name, 8-digit registry code, or trademark text.'}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Matched companies, people and trademarks; pass `id` to fetch/get_company/get_person.'}}, 'additionalProperties': False}
search_trademarks
Search trademarks
Search Estonian-linked trademarks (EUIPO + Estonian Patent Office) by their verbal element. Returns each mark with its status and the owning company.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results (default 10).'}, 'query': {'type': 'string', 'description': "Trademark text to search for, e.g. 'BOLT'."}, 'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'results'], 'properties': {'query': {'type': 'string'}, 'results': {'type': 'array', 'items': {}, 'description': 'Matched trademarks, each with status and owning company.'}}, 'additionalProperties': False}
whats_new_today
What happened today in the Estonian business register
A summary of recent activity: a daily narrative of notable changes plus counts of newly registered companies (last few working days), broken down by legal form, county and activity, with a sample of the newest companies.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'locale': {'enum': ['et', 'en'], 'type': 'string', 'description': "Response language for labels and URLs. 'et' (Estonian, default) or 'en'."}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['forms', 'counties', 'emtak', 'newest'], 'properties': {'emtak': {'type': 'array', 'items': {}, 'description': 'New registrations by activity.'}, 'forms': {'type': 'array', 'items': {}, 'description': 'New registrations by legal form.'}, 'newest': {'type': 'array', 'items': {}, 'description': 'Sample of the newest companies.'}, 'totals': {'description': '{ total, today } new-registration counts.'}, 'summary': {'description': 'Daily narrative summary text, or null.'}, 'counties': {'type': 'array', 'items': {}, 'description': 'New registrations by county.'}, 'summaryDate': {}}, 'additionalProperties': False}
追加
rankings
2026年9月17日12:45
追加
annual_reports
2026年9月17日12:45
追加
search_trademarks
2026年9月17日12:45
追加
whats_new_today
2026年9月17日12:45
追加
companies_by_emtak
2026年9月17日12:45
追加
lookup_emtak
2026年9月17日12:45
追加
get_person
2026年9月17日12:45
追加
get_company
2026年9月17日12:45
追加
fetch
2026年9月17日12:45
追加
search
2026年9月17日12:45