🏰 Estonia AI Kit 🇪🇪

^{Photo by Ilya Orehov on Unsplash, modified with AI}

🇪🇪 The Digital Nation's AI Toolkit

Build AI-powered applications with Estonia's world-leading digital infrastructure

Note

This is a community-driven open source project and is not affiliated with, endorsed by, or connected to the Estonian government or any official Estonian institutions.

🌍 The Estonian Digital Revolution

Picture this: A country where 99% of government services are online. Where you can establish a company in 18 minutes. Where blockchain secures healthcare records, and every citizen has a digital identity that works seamlessly across all services. This isn't science fiction—this is Estonia today.

Since the early 1990s, Estonia has transformed itself into one of the world's most digitally advanced societies. Starting fresh with modern infrastructure and forward-thinking policies, the country built its services digital-first from the ground up. Today, Estonia stands as a model for digital governance:

• 3 minutes to file taxes online (with 98% of citizens doing so) ¹
• 2% of GDP saved annually through digital governance ²
• 120,000+ e-Residents from 170+ countries running EU companies remotely ³
• 99.9% of banking transactions happen online ⁴
• X-Road data exchange platform processes 900+ million transactions yearly ⁵

📖 What is Estonia AI Kit?

Estonia AI Kit connects your AI applications directly to Estonian government services, open data, and digital infrastructure. It includes MCP servers for AI integration, CLI tools for direct terminal access, and skills for AI coding agents (like Claude Code) to interact with authenticated services.

🎯 What is MCP?

Model Context Protocol (MCP) is an open protocol that standardizes how AI applications connect with external data sources and tools. Estonia AI Kit implements MCP servers for various Estonian services, making them accessible to AI models like Claude, GPT, and others.

📦 What's Included

This toolkit covers government services (tax, business registry, legal data, statistics) and private sector services (banking). Some require personal authentication via Smart-ID/ID-card.

🏛️ Government Services

Package	Description	Type	Auth	Status
@estonia-ai-kit/rik-mcp-server	Estonian Business Register (RIK)	MCP Server	None	🔶 WIP
@estonia-ai-kit/open-data-mcp-server	Statistics Estonia / Open Data Portal	MCP Server	None	🔶 WIP
cli/emta	Tax & Customs Board (EMTA) - TSD declarations	CLI / Skill	Smart-ID	✅ Working
rag/riigiteataja	Estonian Legal Document RAG pipeline	RAG	None	🔶 WIP
@estonia-ai-kit/shared	Shared utilities and types	Library	-	✅ Ready

🏦 Private Sector Services

Package	Description	Type	Auth	Status
cli/lhv	LHV Bank - accounts, transactions, payments	CLI / Skill	Smart-ID	✅ Working

Important

CLI tools that require authentication (Smart-ID, ID-card) authenticate as you and access your data. Sessions expire after ~30 minutes.

🚀 Quick Start

CLI Tools / Skills

# Install the EMTA CLI
go install github.com/stefanoamorelli/estonia-ai-kit/cli/emta@latest

# Install the LHV CLI
go install github.com/stefanoamorelli/estonia-ai-kit/cli/lhv@latest

EMTA (Tax & Customs):

emta-cli login                     # Login via Smart-ID QR code
emta-cli tsd list                  # List your TSD declarations
emta-cli tsd show <declaration-id> # Show declaration details

LHV Bank:

lhv auth --interactive             # Authenticate via Smart-ID
lhv get-accounts                   # List accounts
lhv get-transactions               # View transactions
lhv pay --help                     # SEPA payment options

MCP Servers

# Install dependencies
bun install

# Build all packages
bun run build

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "estonia-rik": {
      "command": "node",
      "args": ["/path/to/estonia-ai-kit/mcp/rik/dist/index.js"]
    },
    "estonia-open-data": {
      "command": "node",
      "args": ["/path/to/estonia-ai-kit/mcp/open-data/dist/index.js"]
    }
  }
}

Claude Code Plugins

This repository includes a Claude Code plugin marketplace with ready-to-use skills for AI-assisted workflows.

# Add the marketplace (one-time setup)
/plugin marketplace add stefanoamorelli/estonia-ai-kit

# Install a plugin (e.g., LHV Bank or EMTA)
/plugin install lhv@estonia-ai-kit
/plugin install emta@estonia-ai-kit

Each plugin bundles a skill file that teaches Claude Code how to use the corresponding CLI tool. The CLI binary must be installed separately (see Quick Start above).

🛠️ Project Structure

estonia-ai-kit/
├── cli/                       # CLI tools / skills (authenticated services)
│   ├── emta/                  # EMTA Tax & Customs CLI (Go)
│   └── lhv/                   # LHV Bank CLI (Go)
├── mcp/                       # MCP servers
│   ├── rik/                   # Business Register
│   └── open-data/             # Statistics Estonia
├── plugins/                   # Claude Code plugin marketplace
│   ├── emta/                  # EMTA plugin + skill
│   └── lhv/                   # LHV plugin + skill
├── packages/                  # Shared TypeScript libraries
│   ├── shared/                # Common utilities
│   └── riigiteataja-api-client/
├── rag/                       # RAG pipelines
│   └── riigiteataja/          # Legal documents
└── tests/                     # E2E tests

⚡ Technical Stack

Component	Technology	Purpose
MCP Servers	TypeScript, @modelcontextprotocol/sdk	AI assistant integration
CLI Tools / Skills	Go, Cobra	Terminal access and AI agent skills
API Clients	Axios, native fetch, net/http	HTTP/REST communication
Data Processing	CSV parsing, HTML parsing, JSON	Handle various data formats
Monorepo	Nx workspace	Consistent tooling and code sharing

🧑‍💻 Development

Prerequisites

• Node.js 20+ and Bun 1.0+ — for MCP servers and TS packages
• Go 1.21+ — for CLI tools

Setup

git clone https://github.com/stefanoamorelli/estonia-ai-kit.git
cd estonia-ai-kit

# TypeScript packages
bun install
bun run build

# Go CLI tools
cd cli/emta && go build -o emta-cli .
cd cli/lhv && make install

Testing

# TypeScript packages
bun run test
npx nx test rik-mcp-server
npx nx test open-data-mcp-server
npx nx test shared

🔗 Estonian Government Resources

• 🏛️ e-Business Register - Official business registry portal
• 💼 EMTA (Tax & Customs) - Estonian Tax and Customs Board
• 📊 Open Data Portal - Estonian government open data
• 🔐 X-Road - Estonian data exchange platform
• 🇪🇪 e-Estonia - Digital society overview
• 📚 RIK Developer Portal - Business registry API documentation

🤝 Contributing

PRs and issues welcome.

Fork → Branch → Commit → Push → PR

⚖️ License

This open-source project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). This means:

• ✅ You can use, modify, and distribute this software
• ✅ If you modify and distribute it, you must release your changes under AGPL-3.0
• ✅ If you run a modified version on a server, you must provide the source code to users
• 📄 See the LICENSE file for full details

For commercial licensing options or other licensing inquiries, please contact stefano@amorelli.tech.

---

Copyright © 2025 Stefano Amorelli
Released under the GNU Affero General Public License v3.0
amorelli.tech • stefano@amorelli.tech

Made with ❤️ in Tallinn for Estonia's digital future 🇪🇪
Enjoy! 🎉