merit-aktiva-mcp
An MCP server that exposes 77 merit_ tools for working with Merit Aktiva (Estonian accounting) and 360 Księgowość (Polish) companies, covering reads, writes, reports, and send/destructive actions.
Customers & vendors: search/list (by id, name, regNo, VAT no, changed date), create, update, and manage customer/vendor groups.
Sales invoices: list by period or by number/customer, get details/PDF, create, email, send as e-invoice, delete (no update — delete and recreate; credits via negative quantity).
Sales offers: list, get, create, update, set status, and convert an offer into a sales invoice.
Payments: list payments and payment types, record sales-invoice/purchase-invoice/sales-offer payments, delete payments.
Purchases: list purchase invoices and approval-pending purchase orders, get details, create booked purchase invoices, delete.
General ledger & accounts: list GL batches (plain or with entries/cost allocations), get a batch, create GL batches, list chart of accounts.
Items & inventory: list/search items and groups, create/update items and groups, list stock locations, list and create inventory movements (in/out/transfer).
Reference data: taxes/VAT rates, projects, cost centers, dimensions, departments, units, banks/payment methods, financial years.
Reports: customer debts, customer payments (auto-paginated), P&L, balance sheet, inventory, sales, and purchase reports.
Recurring invoices: list, get, create, list client addresses, and send meter/indication values.
Fixed assets: list asset locations, responsible employees, and assets; create fixed assets.
Prices & discounts: list prices/discounts, look up a valid customer price, create/replace prices and discounts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@merit-aktiva-mcp list sales invoices from the last 30 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
merit-aktiva-mcp
Open-source Model Context Protocol (MCP) server for
Merit Aktiva, the Estonian accounting software, via the
Merit Aktiva API (also serves
360 Księgowość in Poland via MERIT_BASE_URL).
It exposes customers, vendors, invoices, payments, ledger, reports, offers, recurring
invoices, inventory, fixed assets, and prices as merit_-prefixed MCP tools, so AI
assistants (Claude, ChatGPT, Cursor, etc.) can work with your Merit Aktiva company.
Hosted: werkzeug.ee
No install needed. Sign up at werkzeug.ee, get your personal MCP
endpoint (https://werkzeug.ee/mcp/c/<id>) and paste it into Claude, ChatGPT or Cursor as
a remote MCP server. Client-by-client steps: werkzeug.ee/docs.
Prefer to run it yourself over stdio? See Prerequisites and Quick start below.
Related MCP server: NuMetric MCP Server
Tools at a glance
77 tools. Click a group to expand it.
Tool | Description |
| List/search Merit Aktiva customers (POST /api/v1/getcustomers). |
| Create a Merit Aktiva customer (POST /api/v2/sendcustomer). |
| Update a Merit Aktiva customer (POST /api/v1/updatecustomer). id is required; other fields are optional patches. |
| List Merit Aktiva customer groups (POST /api/v2/getcustomergroups). |
| Create a Merit Aktiva customer group (POST /api/v2/sendcustomergroup). id (GUID), name (max 64), and code (max 20) are required. |
Tool | Description |
| List/search Merit Aktiva vendors (POST /api/v1/getvendors). |
| Create a Merit Aktiva vendor (POST /api/v2/sendvendor). |
| Update a Merit Aktiva vendor (POST /api/v2/updatevendor). id is required; other fields are optional patches. v2 supports Dimensions. |
| List Merit Aktiva vendor groups (POST /api/v2/getvendorgroups). |
| Create a Merit Aktiva vendor group (POST /api/v2/sendvendorgroup). id (GUID), name (max 64), and code (max 20) are required. |
Tool | Description |
| List Merit Aktiva sales invoices for a period (POST /api/v2/getinvoices). periodStart/periodEnd are ISO YYYY-MM-DD and may be at most 3 months apart (Merit… |
| List Merit Aktiva sales invoices filtered by invoice number and/or customer (POST /api/v2/getinvoices2). |
| Get one Merit Aktiva sales invoice with rows and payments (POST /api/v2/getinvoice). id is the invoice GUID (SIHId from the list tools). |
| Create a Merit Aktiva sales invoice (POST /api/v2/sendinvoice). |
| SENDS EMAIL: email a Merit Aktiva sales invoice to the customer (POST /api/v2/sendinvoicebyemail). id is the invoice GUID (SIHId). |
| SENDS E-INVOICE: send a Merit Aktiva sales invoice as an e-invoice (POST /api/v2/sendinvoiceaseinv). id is the invoice GUID (SIHId). |
| Get a Merit Aktiva sales invoice PDF as base64 (POST /api/v2/getsalesinvpdf). |
| DESTRUCTIVE: delete a Merit Aktiva sales invoice (POST /api/v1/deleteinvoice). id is the invoice GUID (SIHId). |
Tool | Description |
| List Merit Aktiva sales offers (POST /api/v2/getoffers). periodStart/periodEnd are ISO YYYY-MM-DD and may be at most 3 months apart. dateType: 0 = document… |
| Get one Merit Aktiva sales offer with rows (POST /api/v2/getoffer). id is the offer GUID. |
| Create a Merit Aktiva sales offer (POST /api/v2/sendoffer). offerNo, customer, offerRows, taxAmount[], and totalAmount (ex-VAT) are required. docType: 1 =… |
| Update a Merit Aktiva sales offer (POST /api/v2/updateoffer). offerNo identifies the offer; deliveryDate, hComment, and fComment are the writable fields. |
| Change a Merit Aktiva sales offer status (POST /api/v2/setofferstatus). newStatus: 1 = unsent, 2 = sent, 3 = confirmed, 4 = rejected, 5 = commented (comment… |
| Create a sales invoice from a Merit Aktiva sales offer (POST /api/v2/offer2inv). id is the offer GUID. |
Tool | Description |
| List Merit Aktiva payments for a period (POST /api/v2/getpayments). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. |
| List Merit Aktiva payment types (POST /api/v2/getpaymenttypes). type is required: 1 = purchases, 2 = expense reports, 3 = sales. |
| Record a payment against a sales invoice (POST /api/v2/sendpayment). |
| Record a payment for a purchase invoice (POST /api/v2/sendPaymentV). |
| Record a payment against a sales offer (POST /api/v2/sendPaymentO). |
| DESTRUCTIVE: delete a Merit Aktiva payment (POST /api/v1/deletepayment). id is the payment GUID. |
Tool | Description |
| List Merit Aktiva purchase invoices for a period (POST /api/v2/getpurchorders). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. dateType: 0 =… |
| Get one Merit Aktiva purchase invoice with rows and payments (POST /api/v2/getpurchorder). id is the purchase invoice GUID (PIHId). |
| List Merit Aktiva purchase orders waiting approval (POST /api/v2/GetPOrders). |
| Create a booked Merit Aktiva purchase invoice (POST /api/v2/sendpurchinvoice). |
| DESTRUCTIVE: delete a Merit Aktiva purchase invoice (POST /api/v1/deletepurchinvoice). id is the purchase invoice GUID (PIHId). |
Tool | Description |
| List Merit Aktiva general-ledger batches (POST /api/v1/getglbatches). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. dateType: 0 = document… |
| Get one Merit Aktiva GL batch with entries (POST /api/v1/getglbatch). id is the batch GUID (GLBId). |
| List Merit Aktiva GL batches with entries and cost allocations in one call (POST /api/v1/GetGLBatchesFull). |
| Create a Merit Aktiva general-ledger batch (POST /api/v1/sendglbatch). entryRows need accountCode plus debit and/or credit. batchDate is ISO YYYY-MM-DD. |
Tool | Description |
| List the Merit Aktiva chart of accounts (POST /api/v1/getaccounts). usageFilter: 0 or omitted = all accounts, 1 = cost accounts, 2 = cost contra-accounts, 3 =… |
Tool | Description |
| List Merit Aktiva tax (VAT) rates (POST /api/v1/gettaxes). |
Tool | Description |
| List/search Merit Aktiva items (POST /api/v1/getitems). id wins over other filters; code and description are broad (partial) matches. usage: 1 = sales, 2 =… |
| List Merit Aktiva item groups (POST /api/v2/getitemgroups). |
| Create Merit Aktiva items (POST /api/v2/senditems). |
| Update a Merit Aktiva item (POST /api/v1/updateitem). id is required; other fields are optional patches. |
| Create Merit Aktiva item groups (POST /api/v2/senditemgroups). |
Tool | Description |
| List Merit Aktiva projects (POST /api/v1/getprojects). |
| List Merit Aktiva cost centers (POST /api/v1/getcostcenters). |
| List Merit Aktiva dimensions and their values (POST /api/v2/getdimensions). |
| List Merit Aktiva departments (POST /api/v1/getdepartments). |
| List Merit Aktiva units of measure (POST /api/v1/getunits). |
| List Merit Aktiva banks / payment methods (POST /api/v1/getbanks). |
| List Merit Aktiva accounting periods / financial years (POST /api/v2/getaccperiods). |
Tool | Description |
| Customer debts report (POST /api/v1/getcustdebtrep). |
| Customer payments report (POST /api/v2/getcustpaymrep). |
| Income statement / P&L (POST /api/v1/getprofitrep). endDate is ISO YYYY-MM-DD; periodCount is the number of months back. |
| Balance sheet / statement of financial position (POST /api/v1/getbalancerep). endDate is ISO YYYY-MM-DD; periodCount is the number of months. |
| Inventory report (POST /api/v2/getinventoryreport). reportDate is ISO YYYY-MM-DD. |
| Sales report (POST /api/v2/getsalesrep). reportType: 1 = invoices, 2 = customers, 3 = articles, 4 = countries, 5 = countries general. |
| Purchase report (POST /api/v2/getpurchrep). reportType: 1 = invoices, 2 = vendors, 3 = articles, 4 = fixed assets. |
Tool | Description |
| List Merit Aktiva recurring invoices (POST /api/v2/getperinvoices). |
| Get one Merit Aktiva recurring invoice with rows (POST /api/v2/getperinvoice). id is the recurring-invoice GUID. |
| Create a Merit Aktiva recurring invoice (POST /api/v2/sendperinvoice). cycle: 1 = month, 2 = quarter, 3 = year, 4 = week. period: 2 = current, 3 = next, 4 =… |
| List client addresses for open Merit Aktiva recurring invoices (POST /api/v2/getpershaddress). |
| Send meter / indication values for recurring invoices (POST /api/v1/sendindvalues). artCode is the article; each value may set endValue or quantity (quantity… |
Tool | Description |
| List Merit Aktiva stock locations (POST /api/v2/getlocations). |
| List Merit Aktiva inventory movements (POST /api/v2/getinvmovements). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. dateType: 0 = document… |
| Create a Merit Aktiva inventory movement (POST /api/v2/SendInvMovement). type: 1 = in (itemUnitCost required on rows), 2 = out, 3 = between stocks… |
Tool | Description |
| List Merit Aktiva fixed-asset locations (POST /api/v2/getfalocations). |
| List Merit Aktiva fixed-asset responsible employees (POST /api/v2/getfaresppersons). |
| List Merit Aktiva fixed assets (POST /api/v2/getfixassets). |
| Create Merit Aktiva fixed assets (POST /api/v2/sendfixedassets). |
Tool | Description |
| List Merit Aktiva sales prices (POST /api/v2/getprices). |
| Get the valid sales price for a customer on a date (POST /api/v2/getprice). itemCode and docDate are required; provide customerId, or custName / custRegNo. |
| Create or replace Merit Aktiva sales prices (POST /api/v2/sendprices). targetGroup: 0 = campaign, 1 = customer, 2 = customer group. |
| List Merit Aktiva sales discounts (POST /api/v2/getdiscounts). |
| Create or replace Merit Aktiva sales discounts (POST /api/v2/senddiscounts). targetGroup: 1 = customer, 2 = customer group. groupType: 1 = item, 2 = item group. |
API paths and required arguments per tool: Tools.
Status: OSS stdio package is complete for GitLab issues M1–M6 (auth, reads, writes, extended domains). Bank import, settlements, expense/income/prepayments, and dimension/tax/unit mutations are deferred.
Endpoint → tool mapping and official-vs-seed quirks: docs/api-coverage.md.
Prerequisites
Node.js 20+ (see
package.jsonengines; nativefetch; CI uses Node 20 and 22).A Merit Aktiva company with Pro/Premium (API Settings is not on lower plans).
Merit has no sandbox. Use a free test company (Program Settings → API Settings) or a real company you control.
API credentials
Create keys as an admin in Merit Aktiva → Settings → API Settings:
Add an API client. Merit shows an Api ID and Api Key.
Copy them into
.envasMERIT_API_IDandMERIT_API_KEY(never commit.env).
Poland (360 Księgowość): set MERIT_BASE_URL=https://program.360ksiegowosc.pl.
Quick start
git clone https://github.com/werkstatt-jasper/merit-aktiva-mcp.git
cd merit-aktiva-mcp
cp .env.example .env # set MERIT_API_ID / MERIT_API_KEY
npm install
npm run build
npm start # MCP server on stdioEnvironment
Copy .env.example to .env and fill in values. The server loads .env via
dotenv with quiet: true so the banner cannot corrupt MCP stdio. Never commit
.env (it is gitignored).
Variable | Required | Default | Description |
| yes | — | Api ID from Settings → API Settings |
| yes | — | Api Key (HMAC-SHA256 shared secret; never sent on the wire) |
| no |
| Poland: |
| no |
| Extra attempts on 429/5xx/network errors |
| no |
| Exponential backoff base delay |
| no |
| Outbound HTTP timeout |
| no |
| pino level; logs go to stderr only |
Structured logs go to stderr only. stdout is reserved for MCP JSON-RPC.
MCP host configuration
Point your MCP client at the built server (dist/index.js). Use an absolute path.
Cursor (~/.cursor/mcp.json or project .cursor/mcp.json):
{
"mcpServers": {
"merit-aktiva": {
"command": "node",
"args": ["/absolute/path/to/merit-aktiva-mcp/dist/index.js"],
"env": {
"MERIT_API_ID": "your_api_id",
"MERIT_API_KEY": "your_api_key"
}
}
}
}Claude Desktop — same mcpServers shape in claude_desktop_config.json
(macOS: ~/Library/Application Support/Claude/; Linux: ~/.config/Claude/;
Windows: %APPDATA%\Claude\).
If .env is populated and the working directory is the project root, npm start
picks up credentials without duplicating them in the MCP client env block.
Architecture
flowchart LR
subgraph host [MCP_host]
Client[Cursor_or_Claude]
end
subgraph mcp [merit_aktiva_mcp]
Server[stdio_MCP_server]
HttpClient[MeritClient]
end
subgraph merit [Merit_Aktiva]
API[aktiva.merit.ee]
end
Client <-->|stdio_JSON_RPC| Server
Server --> HttpClient
HttpClient -->|"POST HMAC query auth"| APIAuthentication
Merit signs every request with HMAC-SHA256 query parameters (apiId, UTC
timestamp as yyyyMMddHHmmss, signature):
Body is
JSON.stringifyof the payload (compact — pretty-print will not match the official signing vector).Signature is HMAC-SHA256 over
utf8(apiId + timestamp + rawBody), then URL-encoded on the query string.On 429 / 5xx retries the client must mint a fresh timestamp and signature (reusing the first signature fails). See
src/auth.tsandsrc/client.ts.
The Api Key never leaves the process. URLs logged on error have the query string stripped.
Dates and periods
Tool date arguments accept ISO
YYYY-MM-DDand are converted to Merit'syyyymmdd.List filters (
periodStart/periodEnd) are capped by Merit at 3 months, except recurring-invoice lists (max 180 days; period = next-invoice date).Offer and purchase-invoice payments send
PaymentDateasyyyyMMddHHmm(ISO date or datetime in, midnight if date-only).Paginated reports continue via
HasMore/Id4More→POST /api/v2/getmoredata(merit_get_customer_payments_reportdoes this automatically).
Destructive and send-external tools
These tools mutate the company or send mail. Descriptions start with DESTRUCTIVE or SENDS …:
merit_delete_sales_invoice,merit_delete_purchase_invoice,merit_delete_paymentmerit_email_sales_invoice(SENDS EMAIL)merit_send_sales_invoice_einvoice(SENDS E-INVOICE; receiver not capable →api-noeinv)
Sales invoices cannot be updated — delete and recreate. Credit invoice: negative
quantity and totalAmount.
Tools
Each tool POSTs to the Merit API. Required columns are MCP argument names (camelCase);
the client maps them to PascalCase wire fields. Full path matrix:
docs/api-coverage.md.
Customers
Tool | API | Required |
|
| — |
|
|
|
|
|
|
|
| — |
|
|
|
Vendors
Tool | API | Required |
|
| — |
|
|
|
|
|
|
|
| — |
|
|
|
Sales invoices
Tool | API | Required |
|
|
|
|
| — |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Sales offers
Tool | API | Required |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DocType: 1 = quote, 2 = order, 3 = prepayment. DocStatus: 1–7 (7 = canceled).
Payments
Tool | API | Required |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Purchases
Tool | API | Required |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GetPOrders is purchase orders waiting for approval, not the booked purchase-invoice list.
sendpurchinvoice books immediately (bypasses approval).
General ledger
Tool | API | Required |
|
| — |
|
|
|
|
|
|
|
|
|
|
|
|
Items
Tool | API | Required |
|
| — |
|
| — |
|
|
|
|
|
|
|
|
|
Reference data
Tool | API | Required |
|
| — |
|
| — |
|
| — |
|
| — |
|
| — |
|
| — |
|
| — |
|
| — |
Reports
Tool | API | Required |
|
| — |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Recurring invoices
Tool | API | Required |
|
|
|
|
|
|
|
|
|
|
| — |
|
|
|
Inventory
Tool | API | Required |
|
| — |
|
|
|
|
|
|
Type: 1 = in, 2 = out, 3 = between stocks.
Fixed assets
Tool | API | Required |
|
| — |
|
| — |
|
| — |
|
|
|
Prices and discounts
Tool | API | Required |
|
| — |
|
|
|
|
|
|
|
| — |
|
|
|
Development
npm run lint # Biome
npm run test:coverage # Vitest, 100% coverage thresholds on src/
npm run build # tsc
npm run test:integration # live API tests; skip cleanly without credentialsSee CONTRIBUTING.md for the pre-push checklist.
API reference: Merit AKTIVA Reference Manual
Acknowledgements
The endpoint map (paths, request-body fields, and behavioural quirks) was seeded from
roosa-dev/merit-aktiva-mcp
(src/server.ts ENDPOINTS table), used under the MIT License:
MIT License — Copyright (c) 2026 Roosa
This project is an independent implementation (typed schemas, retrying signed client, test suite) and is not affiliated with Merit Software or roosa-dev.
License
MIT — Copyright (c) 2026 Werkstatt OÜ
Available Tools
77 toolsmerit_create_customerA
Create a Merit Aktiva customer (POST /api/v2/sendcustomer). Name must be unique (max 150). notTDCustomer is required (true for physical persons / foreign companies in EE). countryCode is required (2 chars). Returns { Id, Name }.
Inputs: name (required), countryCode (required), notTDCustomer (required), city, +13 more.
merit_create_customer_groupA
Create a Merit Aktiva customer group (POST /api/v2/sendcustomergroup). id (GUID), name (max 64), and code (max 20) are required.
Inputs: id (required), code (required), name (required).
merit_create_fixed_assetsA
Create Merit Aktiva fixed assets (POST /api/v2/sendfixedassets). Each asset needs inventoryNo and name. deprCalcMethod: 1 = linear, 3 = residual, 4 = one-copy (PL). Wire fields keep Merit's documented spellings (InventaryNo, FAFroupName).
Inputs: fixedAssets (required).
merit_create_gl_batchA
Create a Merit Aktiva general-ledger batch (POST /api/v1/sendglbatch). entryRows need accountCode plus debit and/or credit. batchDate is ISO YYYY-MM-DD.
Inputs: docNo (required), batchDate (required), entryRows (required), currencyCode.
merit_create_inventory_movementA
Create a Merit Aktiva inventory movement (POST /api/v2/SendInvMovement). type: 1 = in (itemUnitCost required on rows), 2 = out, 3 = between stocks (location2Code is the destination). Dates are ISO YYYY-MM-DD.
Inputs: rows (required), type (required), docDate (required), docNo, +3 more.
merit_create_invoice_from_sales_offerA
Create a sales invoice from a Merit Aktiva sales offer (POST /api/v2/offer2inv). id is the offer GUID. Returns InvoiceId / InvoiceNo.
Inputs: id (required).
merit_create_item_groupsA
Create Merit Aktiva item groups (POST /api/v2/senditemgroups). Each group needs code and name.
Inputs: itemGroups (required).
merit_create_itemsA
Create Merit Aktiva items (POST /api/v2/senditems). Each item needs type (1 stock, 2 service, 3 item), usage (1 sales, 2 purchases, 3 both), code, and description. uomName is required for stock items. Returns [{ ItemId, Code }].
Inputs: items (required).
merit_create_purchase_invoiceA
Create a booked Merit Aktiva purchase invoice (POST /api/v2/sendpurchinvoice). Creates the document and GL entry immediately — bypasses the approval flow (use sendpurchorder for that; not in this package yet). vendor is existing Id or new record. invoiceRows, taxAmount[], and totalAmount (ex-VAT) are required.
Inputs: billNo (required), vendor (required), docDate (required), taxAmount (required), +9 more.
merit_create_purchase_invoice_paymentA
Record a payment for a purchase invoice (POST /api/v2/sendPaymentV). Identify the bill with vendorName + billNo. paymentDate is ISO date or datetime and is sent as yyyyMMddHHmm (Merit's documented format for this endpoint).
Inputs: amount (required), billNo (required), vendorName (required), paymentDate (required), +4 more.
merit_create_recurring_invoiceB
Create a Merit Aktiva recurring invoice (POST /api/v2/sendperinvoice). cycle: 1 = month, 2 = quarter, 3 = year, 4 = week. period: 2 = current, 3 = next, 4 = for the next, 5 = previous, 6 = current less cycles. Dates are ISO YYYY-MM-DD.
Inputs: cycle (required), period (required), customer (required), nextDate (required), +8 more.
merit_create_sales_invoiceA
Create a Merit Aktiva sales invoice (POST /api/v2/sendinvoice). Invoices cannot be updated — delete and recreate. Credit invoice: use negative quantity and totalAmount. customer may be an existing Id or a new record (name + notTDCustomer + countryCode). invoiceRows, taxAmount[], and totalAmount (ex-VAT) are required. Dates are ISO YYYY-MM-DD.
Inputs: docDate (required), customer (required), invoiceNo (required), taxAmount (required), +9 more.
merit_create_sales_invoice_paymentA
Record a payment against a sales invoice (POST /api/v2/sendpayment). Identify the invoice with customerName + invoiceNo. Provide bankId or IBAN (IBAN must match a payment method). paymentDate is ISO YYYY-MM-DD. Partial payments are allowed.
Inputs: amount (required), invoiceNo (required), paymentDate (required), customerName (required), +4 more.
merit_create_sales_offerB
Create a Merit Aktiva sales offer (POST /api/v2/sendoffer). offerNo, customer, offerRows, taxAmount[], and totalAmount (ex-VAT) are required. docType: 1 = quote, 2 = order, 3 = prepayment. Dates are ISO YYYY-MM-DD.
Inputs: docDate (required), offerNo (required), customer (required), offerRows (required), +14 more.
merit_create_sales_offer_paymentA
Record a payment against a sales offer (POST /api/v2/sendPaymentO). Identify the offer with customerName + offerNo. paymentDate is ISO date or datetime and is sent as yyyyMMddHHmm (Merit's documented format for this endpoint).
Inputs: amount (required), offerNo (required), paymentDate (required), customerName (required), +5 more.
merit_create_vendorA
Create a Merit Aktiva vendor (POST /api/v2/sendvendor). Name must be unique (max 150). vatAccountable and countryCode are required. Returns { Id, Name }.
Inputs: name (required), countryCode (required), vatAccountable (required), city, +13 more.
merit_create_vendor_groupA
Create a Merit Aktiva vendor group (POST /api/v2/sendvendorgroup). id (GUID), name (max 64), and code (max 20) are required.
Inputs: id (required), code (required), name (required).
merit_delete_paymentA
DESTRUCTIVE: delete a Merit Aktiva payment (POST /api/v1/deletepayment). id is the payment GUID. There is no undo.
Inputs: id (required).
merit_delete_purchase_invoiceA
DESTRUCTIVE: delete a Merit Aktiva purchase invoice (POST /api/v1/deletepurchinvoice). id is the purchase invoice GUID (PIHId). There is no undo.
Inputs: id (required).
merit_delete_sales_invoiceA
DESTRUCTIVE: delete a Merit Aktiva sales invoice (POST /api/v1/deleteinvoice). id is the invoice GUID (SIHId). There is no undo.
Inputs: id (required).
merit_email_sales_invoiceA
SENDS EMAIL: email a Merit Aktiva sales invoice to the customer (POST /api/v2/sendinvoicebyemail). id is the invoice GUID (SIHId). Set delivNote to send a delivery note without prices.
Inputs: id (required), delivNote.
merit_get_balance_reportB
Balance sheet / statement of financial position (POST /api/v1/getbalancerep). endDate is ISO YYYY-MM-DD; periodCount is the number of months.
Inputs: endDate (required), periodCount (required).
merit_get_customer_debts_reportA
Customer debts report (POST /api/v1/getcustdebtrep). Provide customerName (empty string = all customers) or customerId. overDueDays filters exceeded days; debtDate defaults to today when omitted.
Inputs: debtDate, customerId, overDueDays, customerName.
merit_get_customer_payments_reportA
Customer payments report (POST /api/v2/getcustpaymrep). Paginated via HasMore/Id4More; this tool follows getmoredata automatically. periodStart/periodEnd required. Note the wire typo CurrncyCode.
Inputs: periodEnd (required), periodStart (required), customerId, currencyCode, +1 more.
merit_get_gl_batchB
Get one Merit Aktiva GL batch with entries (POST /api/v1/getglbatch). id is the batch GUID (GLBId). Set addAttachment to include a file as base64.
Inputs: id (required), addAttachment.
merit_get_inventory_reportC
Inventory report (POST /api/v2/getinventoryreport). reportDate is ISO YYYY-MM-DD.
Inputs: reportDate (required), location, showZero, articleGroups, +1 more.
merit_get_priceC
Get the valid sales price for a customer on a date (POST /api/v2/getprice). itemCode and docDate are required; provide customerId, or custName / custRegNo.
Inputs: docDate (required), itemCode (required), uomName, custName, +3 more.
merit_get_profit_reportA
Income statement / P&L (POST /api/v1/getprofitrep). endDate is ISO YYYY-MM-DD; periodCount is the number of months back. Optional departmentFilter.
Inputs: endDate (required), periodCount (required), departmentFilter.
merit_get_purchase_invoiceA
Get one Merit Aktiva purchase invoice with rows and payments (POST /api/v2/getpurchorder). id is the purchase invoice GUID (PIHId). Set skipAttachment to omit the PDF (smaller response).
Inputs: id (required), skipAttachment.
merit_get_purchase_reportC
Purchase report (POST /api/v2/getpurchrep). reportType: 1 = invoices, 2 = vendors, 3 = articles, 4 = fixed assets.
Inputs: endDate (required), startDate (required), reportType (required).
merit_get_recurring_invoiceA
Get one Merit Aktiva recurring invoice with rows (POST /api/v2/getperinvoice). id is the recurring-invoice GUID.
Inputs: id (required).
merit_get_sales_invoiceA
Get one Merit Aktiva sales invoice with rows and payments (POST /api/v2/getinvoice). id is the invoice GUID (SIHId from the list tools). Set addAttachment to include the invoice PDF as base64 (large).
Inputs: id (required), addAttachment.
merit_get_sales_invoice_pdfA
Get a Merit Aktiva sales invoice PDF as base64 (POST /api/v2/getsalesinvpdf). Returns FileName + FileContent. Set delivNote for a delivery note without prices.
Inputs: id (required), delivNote.
merit_get_sales_offerA
Get one Merit Aktiva sales offer with rows (POST /api/v2/getoffer). id is the offer GUID.
Inputs: id (required).
merit_get_sales_reportC
Sales report (POST /api/v2/getsalesrep). reportType: 1 = invoices, 2 = customers, 3 = articles, 4 = countries, 5 = countries general.
Inputs: endDate (required), startDate (required), reportType (required).
merit_list_accountsA
List the Merit Aktiva chart of accounts (POST /api/v1/getaccounts). usageFilter: 0 or omitted = all accounts, 1 = cost accounts, 2 = cost contra-accounts, 3 = purchase VAT accounts.
Inputs: usageFilter.
merit_list_banksA
List Merit Aktiva banks / payment methods (POST /api/v1/getbanks). No filters.
Inputs: no named parameters.
merit_list_cost_centersA
List Merit Aktiva cost centers (POST /api/v1/getcostcenters). No filters.
Inputs: no named parameters.
merit_list_customer_groupsA
List Merit Aktiva customer groups (POST /api/v2/getcustomergroups). No filters.
Inputs: no named parameters.
merit_list_customersA
List/search Merit Aktiva customers (POST /api/v1/getcustomers). With no filters returns all customers — can be very large (Merit may even fail to serialize huge lists), so prefer a filter. id wins over all other filters; regNo/vatRegNo match exactly; name matches partially. Dates are ISO YYYY-MM-DD.
Inputs: id, name, regNo, vatRegNo, +3 more.
merit_list_departmentsA
List Merit Aktiva departments (POST /api/v1/getdepartments). No filters.
Inputs: no named parameters.
merit_list_dimensionsA
List Merit Aktiva dimensions and their values (POST /api/v2/getdimensions). Set allValues to include inactive/ended values.
Inputs: allValues.
merit_list_discountsA
List Merit Aktiva sales discounts (POST /api/v2/getdiscounts). No filters.
Inputs: no named parameters.
merit_list_financial_yearsA
List Merit Aktiva accounting periods / financial years (POST /api/v2/getaccperiods). No filters.
Inputs: no named parameters.
merit_list_fixed_asset_employeesA
List Merit Aktiva fixed-asset responsible employees (POST /api/v2/getfaresppersons). No filters.
Inputs: no named parameters.
merit_list_fixed_asset_locationsA
List Merit Aktiva fixed-asset locations (POST /api/v2/getfalocations). No filters.
Inputs: no named parameters.
merit_list_fixed_assetsA
List Merit Aktiva fixed assets (POST /api/v2/getfixassets). No filters.
Inputs: no named parameters.
merit_list_gl_batchesB
List Merit Aktiva general-ledger batches (POST /api/v1/getglbatches). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. dateType: 0 = document date, 1 = changed date.
Inputs: periodEnd (required), periodStart (required), dateType.
merit_list_gl_batches_fullA
List Merit Aktiva GL batches with entries and cost allocations in one call (POST /api/v1/GetGLBatchesFull). Period max 31 days. withLines/withCostAlloc default off when omitted.
Inputs: periodEnd (required), periodStart (required), dateType, withLines, +1 more.
merit_list_inventory_movementsA
List Merit Aktiva inventory movements (POST /api/v2/getinvmovements). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. dateType: 0 = document date, 1 = changed date. Type: 1 = in, 2 = out, 3 = between stocks.
Inputs: periodEnd (required), periodStart (required), dateType, withLines.
merit_list_item_groupsA
List Merit Aktiva item groups (POST /api/v2/getitemgroups). No filters.
Inputs: no named parameters.
merit_list_itemsA
List/search Merit Aktiva items (POST /api/v1/getitems). id wins over other filters; code and description are broad (partial) matches. usage: 1 = sales, 2 = purchases, 3 = both. type: 1 = stock, 2 = service, 3 = item. locationCode adds inventory qty.
Inputs: id, code, type, usage, +2 more.
merit_list_locationsA
List Merit Aktiva stock locations (POST /api/v2/getlocations). No filters. Returns Code, Name, and next document numbers per movement type.
Inputs: no named parameters.
merit_list_paymentsA
List Merit Aktiva payments for a period (POST /api/v2/getpayments). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. Response Direction: 1 = customer transactions, 2 = vendor, 3 = other income, 4 = other expenses. dateType: 0 = document date, 1 = changed date.
Inputs: periodEnd (required), periodStart (required), bankId, dateType, +1 more.
merit_list_payment_typesA
List Merit Aktiva payment types (POST /api/v2/getpaymenttypes). type is required: 1 = purchases, 2 = expense reports, 3 = sales.
Inputs: type (required).
merit_list_pricesA
List Merit Aktiva sales prices (POST /api/v2/getprices). No filters.
Inputs: no named parameters.
merit_list_projectsA
List Merit Aktiva projects (POST /api/v1/getprojects). No filters. Returns Code, Name, EndDate.
Inputs: no named parameters.
merit_list_purchase_invoicesA
List Merit Aktiva purchase invoices for a period (POST /api/v2/getpurchorders). periodStart/periodEnd are ISO YYYY-MM-DD, max 3 months apart. dateType: 0 = document date, 1 = changed date. Distinct from merit_list_purchase_orders (waiting-approval).
Inputs: periodEnd (required), periodStart (required), unPaid, dateType.
merit_list_purchase_ordersA
List Merit Aktiva purchase orders waiting approval (POST /api/v2/GetPOrders). Not the same as booked purchase invoices (getpurchorders). dateFilter: 0 = off, 1 = document date, 2 = created date. statusFilter: 0 = off.
Inputs: periodEnd (required), periodStart (required), dateFilter, statusFilter, +1 more.
merit_list_recurring_invoice_addressesA
List client addresses for open Merit Aktiva recurring invoices (POST /api/v2/getpershaddress). No filters. Empty when none are open.
Inputs: no named parameters.
merit_list_recurring_invoicesA
List Merit Aktiva recurring invoices (POST /api/v2/getperinvoices). The period is the next-invoice date and may be at most 180 days. dateType: 0 = next invoice date, 1 = changed date.
Inputs: periodEnd (required), periodStart (required), dateType.
merit_list_sales_invoicesA
List Merit Aktiva sales invoices for a period (POST /api/v2/getinvoices). periodStart/periodEnd are ISO YYYY-MM-DD and may be at most 3 months apart (Merit rejects longer periods). dateType: 0 = document date (default), 1 = changed date.
Inputs: periodEnd (required), periodStart (required), bankId, unPaid, +1 more.
merit_list_sales_invoices_by_number_or_customerA
List Merit Aktiva sales invoices filtered by invoice number and/or customer (POST /api/v2/getinvoices2). Provide invoiceNo, customerName, or customerId; no period needed. Useful for finding a specific invoice's GUID (SIHId).
Inputs: invoiceNo, customerId, customerName.
merit_list_sales_offersA
List Merit Aktiva sales offers (POST /api/v2/getoffers). periodStart/periodEnd are ISO YYYY-MM-DD and may be at most 3 months apart. dateType: 0 = document date, 1 = changed date. DocType: 1 = quote, 2 = order, 3 = prepayment. DocStatus: 1 = created, 2 = sent, 3 = approved, 4 = rejected, 5 = comment received, 6 = invoice created, 7 = canceled.
Inputs: periodEnd (required), periodStart (required), unPaid, dateType.
merit_list_taxesA
List all Merit Aktiva tax (VAT) rates (POST /api/v1/gettaxes). No filters. Returns Id (the TaxId GUID used on invoice rows), Code, Name, and TaxPct.
Inputs: no named parameters.
merit_list_unitsA
List Merit Aktiva units of measure (POST /api/v1/getunits). No filters.
Inputs: no named parameters.
merit_list_vendor_groupsA
List Merit Aktiva vendor groups (POST /api/v2/getvendorgroups). No filters.
Inputs: no named parameters.
merit_list_vendorsA
List/search Merit Aktiva vendors (POST /api/v1/getvendors). With no filters returns all vendors — can be very large, so prefer a filter. id wins over other filters; regNo/vatRegNo match exactly; name matches partially. Dates are ISO YYYY-MM-DD.
Inputs: id, name, regNo, vatRegNo, +1 more.
merit_send_discountsA
Create or replace Merit Aktiva sales discounts (POST /api/v2/senddiscounts). targetGroup: 1 = customer, 2 = customer group. groupType: 1 = item, 2 = item group.
Inputs: discounts (required).
merit_send_pricesA
Create or replace Merit Aktiva sales prices (POST /api/v2/sendprices). targetGroup: 0 = campaign, 1 = customer, 2 = customer group.
Inputs: prices (required).
merit_send_recurring_indication_valuesA
Send meter / indication values for recurring invoices (POST /api/v1/sendindvalues). artCode is the article; each value may set endValue or quantity (quantity wins) plus address or customerId.
Inputs: values (required), artCode (required).
merit_send_sales_invoice_einvoiceA
SENDS E-INVOICE: send a Merit Aktiva sales invoice as an e-invoice (POST /api/v2/sendinvoiceaseinv). id is the invoice GUID (SIHId). Receiver not capable returns api-noeinv. Set delivNote to send without prices.
Inputs: id (required), delivNote.
merit_set_sales_offer_statusA
Change a Merit Aktiva sales offer status (POST /api/v2/setofferstatus). newStatus: 1 = unsent, 2 = sent, 3 = confirmed, 4 = rejected, 5 = commented (comment required), 7 = canceled.
Inputs: id (required), newStatus (required), comment.
merit_update_customerA
Update a Merit Aktiva customer (POST /api/v1/updatecustomer). id is required; other fields are optional patches.
Inputs: id (required), city, name, email, +9 more.
merit_update_itemA
Update a Merit Aktiva item (POST /api/v1/updateitem). id is required; other fields are optional patches.
Inputs: id (required), code, taxId, eanCode, +4 more.
merit_update_sales_offerB
Update a Merit Aktiva sales offer (POST /api/v2/updateoffer). offerNo identifies the offer; deliveryDate, hComment, and fComment are the writable fields.
Inputs: offerNo (required), fComment, hComment, deliveryDate.
merit_update_vendorA
Update a Merit Aktiva vendor (POST /api/v2/updatevendor). id is required; other fields are optional patches. v2 supports Dimensions.
Inputs: id (required), city, name, email, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 77 tools
Tools are mostly organized around distinct resources and actions, and descriptions clearly identify endpoints and GUIDs. A few pairs require close reading—sales invoices by number/customer vs. period list, purchase invoices vs. purchase orders, and list_prices/get_price/send_prices—but the descriptions sufficiently disambiguish them.
All tools follow the merit_<verb>_<noun> snake_case pattern, using predictable list/get/create/update/delete/send verbs. Even compound nouns and pluralizations remain consistent, with no camelCase or mixed conventions.
77 tools is an extreme number for a single MCP server, far beyond even a heavy 25+ threshold. While Merit Aktiva is a broad ERP platform, this surface is too large to navigate effectively and would benefit from being split into focused domain servers.
Core workflows—customers/vendors, items, sales and purchase invoicing, payments, GL batches, reports, inventory, fixed assets, and pricing—have substantial coverage. However, many entities have list/get/create but no update or delete, the purchase-order approval flow is list-only, and several resources lack write operations, leaving notable gaps.
Maintenance
Related MCP Connectors
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
AI for Tally Prime and Tally ERP 9. Hosted MCP server to ask your accounts in any language.
Connect Exact Online to your AI assistant via MCP. Manage Exact Online with natural language.
AI accounting: ask about your live AccountsOS books in plain English. Read-only tools for transactions, cash balances, invoices, bills, VAT, filing deadlines and reports across 32 countries. OAuth sign-in; free 14-day trial at accounts-os.com.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceExposes ~60 tools for the Merit Aktiva accounting API, covering sales/purchase invoices, payments, customers, vendors, items, general ledger, offers, reference data, and reports with both read and write operations.8 npmMIT
- AlicenseNot gradedqualityCmaintenanceA read-only MCP server for the NuMetric.work accounting/POS/ERP platform, exposing 38 tools to query live business data such as financial statements, invoices, taxes, projects, inventory, and documents. It enables AI assistants to answer from real accounting data without any create, edit, or delete capabilities.MIT
- FlicenseNot gradedqualityDmaintenanceEnables read-only access to company data across PostgreSQL, MongoDB Atlas, and flat files through MCP tools, allowing AI assistants to query and retrieve information via natural language.-
- AlicenseNot gradedqualityDmaintenanceEnables read-only interaction with TallyPrime accounting data, letting users ask accounting questions and retrieve live company information, financial reports, and ledgers without altering anything in Tally.ISC