E-Arveldaja MCP Server
by
Provides an MCP server that interfaces with the Estonian e‑arveldaja (RIK e‑Financials) REST API, enabling AI assistants to create, modify, and query accounting records automatically.
E-Arveldaja MCP Server Overview
What is E‑Arveldaja MCP Server about?
The project offers an MCP server that connects AI assistants to the official e‑arveldaja API used by Estonian businesses for bookkeeping, invoicing, bank reconciliation, VAT filing and other accounting operations. It is experimental, unofficial and operates without any endorsement from RIK.
How to use E‑Arveldaja MCP Server?
- Obtain an API key from the e‑arveldaja portal and place the downloaded
apikey.txtin the working directory (or export the related environment variables). - Add the MCP server to your AI assistant configuration, e.g. with:
{ "mcpServers": { "e-arveldaja": { "command": "npx", "args": ["-y", "e-arveldaja-mcp"] } } } - Start your AI assistant (Claude Code, Cursor, Gemini CLI, etc.). The server will automatically read the key file.
- Interact in natural language, for example:
- "Book this invoice PDF into e‑arveldaja and match it to the bank payment."
- "Generate a P&L and balance sheet as of 28.02.2026." The assistant will invoke the appropriate workflow prompts.
Key features of E‑Arveldaja MCP Server
- 85 tools and 12 resources covering the full e‑arveldaja API.
- 7 built‑in multi‑step workflows (invoice booking, bank reconciliation, month‑end close, new supplier creation, company overview, quarterly VAT, Lightyear investment booking).
- Works with any MCP‑compatible client (Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Cline, etc.).
- Supports multiple company connections via separate
apikey*.txtfiles. - Option to configure API credentials via environment variables.
- Open‑source under The Unlicense (public domain).
Use cases of E‑Arveldaja MCP Server
- Automating the entry of purchase invoices from PDFs.
- Reconciling bank statements (e.g., Wise, local banks) with existing invoices.
- Running month‑end or quarter‑end checklists and generating financial statements.
- Creating new suppliers by looking up the Estonian business registry.
- Preparing VAT return data for a given quarter.
- Importing investment trade data (Lightyear CSV) into the accounting system.
FAQ from the E‑Arveldaja MCP Server
Q: Is this software officially supported by RIK? A: No. It is an unofficial, community‑driven project and should be used at your own risk.
Q: How do I test without affecting real data?
A: Set the environment variable EARVELDAJA_SERVER=demo to point the server at the public demo instance.
Q: What should I do if my IP address changes? A: Update the allowed IP list in the e‑arveldaja token settings or use a static IP.
Q: Can I use this with multiple companies?
A: Yes. Place separate key files (e.g., apikey-company2.txt) and switch connections via the list_connections / switch_connection prompts.
Q: How do I install the server locally?
A: Run npx -y e-arveldaja-mcp or clone the repo and execute npm install && npm run build followed by node dist/index.js.
E-Arveldaja MCP Server's README
e-arveldaja MCP Server
MCP server for the Estonian e-arveldaja (RIK e-Financials) REST API. 85 tools, 7 workflow prompts, 12 resources. Works with any MCP client — Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Cline, and others.
Disclaimer
This is an experimental, unofficial project. It is not affiliated with, endorsed by, or in any way officially connected to RIK (Registrite ja Infosüsteemide Keskus) or the e-arveldaja / e-Financials service.
Use entirely at your own risk. This software interacts with live financial data and can create, modify, confirm, and delete accounting records (invoices, journal entries, transactions, etc.). The authors accept no responsibility for any data loss, incorrect bookings, or other damages resulting from the use of this software.
By using this software you acknowledge that:
- You are solely responsible for verifying all data and operations
- You should test thoroughly on the demo server before using with live data
- This is experimental software with no warranty of any kind
Getting an API Key
- Log in to e-arveldaja
- Go to Seadistused → Üldised seadistused → Lisa uus juurdepääsuluba (Settings → General settings → Add new access token)
- Enter any name for the token
- Find your public IP address (e.g. at whatismyipaddress.com) and enter it in the allowed IP field. Multiple IPs can be separated by
; - Save — download the
apikey.txtfile and place it in the working directory where you run your AI assistant
If you don't have a static IP address, you will need to update the allowed IP in e-arveldaja settings whenever your IP changes.
Never commit the apikey.txt file to git.
For the demo server, set the environment variable EARVELDAJA_SERVER=demo.
Setup
1. Add the MCP server
Most AI assistants can set this up for you — just ask:
"Add the e-arveldaja-mcp npm package as an MCP server"
If you prefer to do it manually:
Claude Code:
claude mcp add e-arveldaja -- npx -y e-arveldaja-mcp
Other tools (Cursor, Windsurf, Cline, Gemini CLI, Codex CLI, Antigravity) — add to your MCP config:
{
"mcpServers": {
"e-arveldaja": {
"command": "npx",
"args": ["-y", "e-arveldaja-mcp"]
}
}
}
| Tool | Config file |
|---|---|
| Claude Code | ~/.claude/settings.json or project .claude/settings.json |
| Codex CLI | ~/.codex/config.toml (TOML format) |
| Gemini CLI | ~/.gemini/settings.json |
| Google Antigravity | MCP Store UI → Manage MCP Servers → raw config |
| Cursor | .cursor/mcp.json in your project |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Cline | VS Code settings under cline.mcpServers |
2. Place your API key
Put the downloaded apikey.txt in the working directory where you run your AI assistant. That's it — the server finds it automatically.
For multiple companies, place multiple files (apikey.txt, apikey-company2.txt, etc.) and use list_connections / switch_connection to switch between them.
export EARVELDAJA_API_KEY_ID=...
export EARVELDAJA_API_PUBLIC_VALUE=...
export EARVELDAJA_API_PASSWORD=...
git clone https://github.com/iseppo/e-arveldaja-mcp.git
cd e-arveldaja-mcp
npm install && npm run build
# Then use: "node", "/path/to/e-arveldaja-mcp/dist/index.js" instead of npx
Workflows (MCP Prompts)
The server includes 7 built-in workflow prompts that any MCP client can discover and use. These guide the AI assistant through multi-step accounting tasks:
| Prompt | Description |
|---|---|
book-invoice |
Book a purchase invoice from PDF: extract, validate, resolve supplier, create, upload, confirm |
reconcile-bank |
Match bank transactions to invoices, auto-confirm or review manually |
month-end-close |
Blockers, missing docs, duplicates, trial balance, P&L, balance sheet |
new-supplier |
Create supplier with Estonian business registry lookup |
company-overview |
Financial dashboard: balance sheet, P&L, receivables, payables |
quarterly-vat |
Prepare KMD (VAT return) data for a quarter |
lightyear-booking |
Book Lightyear investment trades and distributions from CSV |
Claude Code also has these as slash commands: /book-invoice, /reconcile-bank, /month-end, /new-supplier.
Usage Examples
Once the MCP server is connected, just talk to your AI assistant in natural language:
Enter purchase invoices from PDF files
"Book this invoice PDF into e-arveldaja and match it to the bank payment"
The assistant will extract invoice data from the PDF, create a purchase invoice with the correct accounts and VAT rates, and match it to existing bank transactions.
Book Lightyear investment trades
Download your Lightyear account statement CSV and capital gains report, then:
"Create e-arveldaja journal entries from these Lightyear CSVs"
The assistant will parse the trades, pair foreign currency conversions, calculate capital gains from the FIFO report, and create journal entries with the correct securities accounts.
Import Wise bank transactions
Download your Wise transaction history CSV (Account → Statements → CSV), then:
"Import my Wise transactions from transaction-history.csv into e-arveldaja"
The assistant will parse the CSV, create bank transactions with correct amounts, and separate Wise fees into their own entries for proper expense accounting. Supports EUR and foreign currency card payments (USD etc.).
Generate financial reports
"Generate a P&L and balance sheet as of 28.02.2026"
Reconcile bank transactions
"Match unconfirmed bank transactions to invoices"
Month-end close
"Run the month-end close checklist for February 2026"
License
The Unlicense — public domain. Do whatever you want with it.
E-Arveldaja MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Similar MCP Servers like E-Arveldaja MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Stripe AI
Officialby stripe
Provides SDKs and tools to integrate Stripe's billing and API services with large language models, agent frameworks, and token‑metering for AI‑powered products and businesses.
Goat
by goat-sdk
Enables AI agents to send and receive payments, purchase goods and services, execute investment strategies, tokenize assets, and obtain financial insights by leveraging blockchains, stablecoins, and wallets.
Financial Datasets MCP Server
by financial-datasets
Provides access to income statements, balance sheets, cash flow statements, stock prices, market news, and cryptocurrency data through MCP tools for AI assistants.
Alpaca MCP Server
Officialby alpacahq
Enables large language models to trade stocks and options, retrieve real‑time and historical market data, and manage portfolios using plain English commands through a local or remote MCP server.
Sec Edgar Mcp
by stefanoamorelli
Provides an MCP server that connects AI models to SEC EDGAR filings, enabling real‑time retrieval of company filings, financial statements, and insider‑trading data with exact XBRL precision and verifiable filing references.
Financial Modeling Prep MCP Server
by imbenrabi
Provides AI assistants with direct access to Financial Modeling Prep data, including real‑time stock quotes, company fundamentals, financial statements, market indexes, news, and alternative data sets via the Model Context Protocol.
MetaTrader MCP Server
by ariadng
Enables AI LLMs to execute trades on the MetaTrader 5 platform through the Model Context Protocol.
Xero MCP Server
by XeroAPI
Provides a bridge between the Model Context Protocol and Xero's API, enabling standardized access to Xero accounting and business features.
Crypto Indicators MCP Server
by kukapay
Provides a comprehensive set of cryptocurrency technical analysis indicators and ready‑to‑use trading strategies through an MCP interface, enabling AI agents and applications to generate buy, hold, or sell signals.