Nimistu MCP
An MCP server that connects AI assistants to the Estonian Business Register, allowing users to query company profiles, ownership structures, person connections, trademarks, and sector data using natural language. It provides traceable, source-stamped answers from open data without requiring an API key.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://nimistu.ee/api/mcpWhat its tools do
10 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Query company profiles including owners, board, and financials
- Find companies connected to a specific person
- Search for trademarks by text and identify owners
- Look up companies by EMTAK activity code
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- nimistu 0.1.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 10 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
10 advertised
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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1424 ms
- 95th percentile latency
- 1424 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1424 ms · metadata changed · 10 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http nimistu-mcp https://nimistu.ee/api/mcpCodex
codex mcp add nimistu-mcp --url https://nimistu.ee/api/mcpCursor
{
"mcpServers": {
"nimistu-mcp": {
"url": "https://nimistu.ee/api/mcp"
}
}
}Cline
{
"mcpServers": {
"nimistu-mcp": {
"type": "streamableHttp",
"url": "https://nimistu.ee/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"nimistu-mcp": {
"type": "http",
"url": "https://nimistu.ee/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http nimistu-mcp https://nimistu.ee/api/mcpClaude Desktop
https://nimistu.ee/api/mcpWindsurf
{
"mcpServers": {
"nimistu-mcp": {
"serverUrl": "https://nimistu.ee/api/mcp"
}
}
}Let your agent find its tools
Find servers like Nimistu MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.