Merit Aktiva MCP by usefulapi
Server Details
Read Merit Aktiva invoices, customers, vendors, items, payments and reports; create a customer.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
26 toolsmerit_balance_sheetBalance sheetRead-onlyInspect
The balance sheet: one row per report line (assets, liabilities, equity) with balances for per_count months counting back from end_date. POST /api/v1/getbalancerep.
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | Yes | Balance date, yyyy-mm-dd. | |
| per_count | No | Number of monthly periods, counting back from end_date (default 1). |
merit_create_customerCreate a customerInspect
WRITE: creates ONE new customer record in the Merit company (name must be unique; an existing customer is never overwritten, Merit answers with an error). Nothing is invoiced, sent or paid. In Estonia not_td_customer must be true for private persons and foreign companies; city is required in Estonia for a non-EE country. Returns the new customer id. POST /api/v2/sendcustomer.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City. | |
| name | Yes | Customer name (unique in the company). | |
| No | E-mail address (stored only; Merit sends nothing). | ||
| county | No | County. | |
| reg_no | No | Registry or personal id code. | |
| address | No | Street address. | |
| contact | No | Contact person. | |
| phone_no | No | Phone number. | |
| home_page | No | Web page. | |
| vat_reg_no | No | VAT number. | |
| postal_code | No | Postal code. | |
| bank_account | No | Customer bank account (IBAN). | |
| country_code | Yes | 2-letter ISO country code, e.g. EE, PL. | |
| currency_code | No | Default currency, e.g. EUR. | |
| not_td_customer | Yes | true for private persons and foreign companies (Estonia), true for private persons (Poland); false for a local company. | |
| payment_deadline_days | No | Payment term in days (default from company settings). | |
| sales_invoice_language | No | Invoice language for this customer (Estonia: ET, EN, RU, FI; Poland: PL, EN, RU). |
merit_customer_debts_reportCustomer debts reportRead-onlyInspect
Open customer receivables: for each unpaid document the customer, date, due date, total, paid and unpaid amount. Give a customer name (empty string = all customers) or a customer id; over_due_days keeps only documents overdue by at least that many days. POST /api/v1/getcustdebtrep.
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Debt as of this date (default today). | |
| customer_id | No | Customer id. | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| customer_name | No | Customer name; an empty string or omitting it with no customer_id selects ALL customers. | |
| over_due_days | No | Only documents overdue by at least this many days. |
merit_customer_payments_reportCustomer payments reportRead-onlyInspect
Customer invoices with their unpaid amount and overdue flag for a period, for one customer (name or id). Only the FIRST page is returned: if has_more is true, narrow the period or the customer (the continuation endpoint is not supported). POST /api/v2/getcustpaymrep.
| Name | Required | Description | Default |
|---|---|---|---|
| period_end | Yes | Period end, yyyy-mm-dd. | |
| customer_id | No | Customer id. | |
| period_start | Yes | Period start, yyyy-mm-dd. | |
| currency_code | No | Currency, e.g. EUR. | |
| customer_name | No | Customer name. |
merit_get_gl_batchGet a general ledger transactionRead-onlyInspect
One general ledger batch with all its debit and credit lines (account, memo, department, tax, amounts). The attachment is never requested. POST /api/v1/getglbatch.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Batch id (GLBId from merit_list_gl_batches). |
merit_get_purchase_invoiceGet a purchase invoiceRead-onlyInspect
One purchase invoice in full: header, lines, payments. The attachment is never requested. POST /api/v2/getpurchorder.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Purchase invoice id (PIHId from merit_list_purchase_invoices). |
merit_get_sales_invoiceGet a sales invoiceRead-onlyInspect
One sales invoice in full: header, lines (items, quantities, VAT, accounts), payments and dimension allocations. The PDF attachment is never requested. POST /api/v2/getinvoice.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Invoice id (SIHId from merit_list_sales_invoices). |
merit_income_statementIncome statement (profit and loss)Read-onlyInspect
The profit and loss report: one row per report line, with balances for per_count months counting back from end_date (newest first). Optional department filter. POST /api/v1/getprofitrep.
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | Yes | Last day of the newest month, yyyy-mm-dd. | |
| per_count | No | Number of monthly periods, counting back from end_date (default 1). | |
| department_code | No | Only this department (code from merit_list_departments). |
merit_list_accountsList the chart of accountsRead-onlyInspect
The general ledger chart of accounts (code, names, VAT, parent flag, active flag). GET /api/v2/accounts.
| Name | Required | Description | Default |
|---|---|---|---|
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. |
merit_list_bank_paymentsList income or expense payments of a bank accountRead-onlyInspect
List the income payments (money received) or expense payments (money paid out) booked on one bank account for a document-date period, with the documents each paid. The period may span at most 3 months (Merit limit); for longer spans make several calls. GET /api/v2/Banks/{bankId}/IncomePayments or /ExpensePayments.
| Name | Required | Description | Default |
|---|---|---|---|
| bank_id | Yes | BankId from merit_list_banks. | |
| direction | Yes | income = payments received, expense = payments made. | |
| doc_date_to | Yes | Document date to, yyyy-mm-dd (max 3 months after doc_date_from). | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| doc_date_from | Yes | Document date from, yyyy-mm-dd. |
merit_list_banksList bank accountsRead-onlyInspect
The company's bank and cash accounts (BankId, name, IBAN, currency, ledger account). BankId feeds the payment tools. GET /api/v2/banks.
| Name | Required | Description | Default |
|---|---|---|---|
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. |
merit_list_customersSearch customersRead-onlyInspect
Search customers by name (partial match), registry number or VAT number (exact), id, or changed since a date. At least one filter is required: Merit cannot return the whole customer list in one reply. POST /api/v1/getcustomers.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Customer id. | |
| name | No | Part of the customer name. | |
| reg_no | No | Registry number, exact. | |
| vat_reg_no | No | VAT number, exact. | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| changed_since | No | Only customers created or changed on or after this date. |
merit_list_departmentsList departmentsRead-onlyInspect
Departments (code, name, active flag). GET /api/v2/departments.
| Name | Required | Description | Default |
|---|---|---|---|
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. |
merit_list_dimensionsList dimensionsRead-onlyInspect
Accounting dimensions and their values (DimId, name, value code, expiry). all_values = true also lists expired values. POST /api/v2/getdimensions.
| Name | Required | Description | Default |
|---|---|---|---|
| all_values | No | true = include expired dimension values (default false). | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. |
merit_list_financial_yearsList financial yearsRead-onlyInspect
Accounting periods (financial years) with start, end and active flag. POST /api/v2/getaccperiods.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
merit_list_gl_batchesList general ledger transactionsRead-onlyInspect
List general ledger batches (journal entries, also those created from invoices and payments) of a period: batch code, number, date, total. The period may span at most 3 months (Merit limit); for longer spans make several calls. POST /api/v1/getglbatches.
| Name | Required | Description | Default |
|---|---|---|---|
| date_type | No | Which date the period filters: 0 = document date (default), 1 = date of last change. | |
| period_end | Yes | Last day of the period, yyyy-mm-dd (max 3 months after the start). | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| period_start | Yes | First day of the period, yyyy-mm-dd. |
merit_list_itemsList items (articles)Read-onlyInspect
List items, services and stock articles with price, unit, VAT and accounts. Optional filters: code or description (partial), type, id. With location_code the reply adds stock quantity and cost of that warehouse. POST /api/v1/getitems.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Item id. | |
| code | No | Part of the item code. | |
| type | No | 1 = stock item, 2 = service, 3 = item. | |
| description | No | Part of the item description. | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| location_code | No | Warehouse code: adds goods on hand quantity and cost. |
merit_list_paymentsList paymentsRead-onlyInspect
List payments (customer and vendor receipts and payouts) of a period, with the documents they paid. The period may span at most 3 months (Merit limit); for longer spans make several calls. POST /api/v2/getpayments.
| Name | Required | Description | Default |
|---|---|---|---|
| bank_id | No | Only this bank account (BankId from merit_list_banks). | |
| date_type | No | Which date the period filters: 0 = document date (default), 1 = date of last change. | |
| period_end | Yes | Last day of the period, yyyy-mm-dd (max 3 months after the start). | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| payment_type | No | Merit payment type filter (see merit_list_payment_types). | |
| period_start | Yes | First day of the period, yyyy-mm-dd. |
merit_list_payment_typesList payment typesRead-onlyInspect
Payment methods and sources (cash, banks, reporting entities, ledger accounts) usable for purchases, expense reports or sales. POST /api/v2/getpaymenttypes.
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 1 = purchases, 2 = expense reports, 3 = sales. | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. |
merit_list_purchase_invoicesList purchase invoicesRead-onlyInspect
List purchase invoices (vendor bills) of a period: bill number, vendor, dates, totals, paid flag. The period may span at most 3 months (Merit limit); for longer spans make several calls. POST /api/v2/getpurchorders.
| Name | Required | Description | Default |
|---|---|---|---|
| date_type | No | Which date the period filters: 0 = document date (default), 1 = date of last change. | |
| period_end | Yes | Last day of the period, yyyy-mm-dd (max 3 months after the start). | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| unpaid_only | No | true = only unpaid bills. | |
| period_start | Yes | First day of the period, yyyy-mm-dd. |
merit_list_sales_invoicesList sales invoicesRead-onlyInspect
List sales invoices (header level: number, customer, dates, totals, paid flag) of a period. The period may span at most 3 months (Merit limit); for longer spans make several calls. Use merit_get_sales_invoice for the lines. POST /api/v2/getinvoices.
| Name | Required | Description | Default |
|---|---|---|---|
| date_type | No | Which date the period filters: 0 = document date (default), 1 = date of last change. | |
| period_end | Yes | Last day of the period, yyyy-mm-dd (max 3 months after the start). | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| unpaid_only | No | true = only unpaid invoices. | |
| period_start | Yes | First day of the period, yyyy-mm-dd. |
merit_list_taxesList VAT ratesRead-onlyInspect
All VAT rates of the company (TaxId, code, name, percent, active flag). The TaxId is what invoice rows refer to. GET /api/v2/taxes.
| Name | Required | Description | Default |
|---|---|---|---|
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. |
merit_list_vendorsSearch vendorsRead-onlyInspect
Search vendors (suppliers) by name (partial match), registry number or VAT number (exact), id, or changed since a date. At least one filter is required: Merit cannot return the whole vendor list in one reply. POST /api/v1/getvendors.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Vendor id. | |
| name | No | Part of the vendor name. | |
| reg_no | No | Registry number, exact. | |
| vat_reg_no | No | VAT number, exact. | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| changed_since | No | Only vendors created or changed on or after this date. |
merit_purchase_reportPurchase reportRead-onlyInspect
Purchase totals for a period, grouped by invoice, vendor, item or fixed asset. POST /api/v2/getpurchrep.
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | Yes | Period end, yyyy-mm-dd. | |
| start_date | Yes | Period start, yyyy-mm-dd. | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| report_type | Yes | 1 = by invoices, 2 = by vendors, 3 = by items, 4 = by fixed assets. |
merit_sales_reportSales reportRead-onlyInspect
Sales totals for a period, grouped by invoice, customer, item or country. POST /api/v2/getsalesrep.
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | Yes | Period end, yyyy-mm-dd. | |
| start_date | Yes | Period start, yyyy-mm-dd. | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| report_type | Yes | 1 = by invoices, 2 = by customers, 3 = by items, 4 = by countries, 5 = by countries (general). |
merit_search_sales_invoicesFind sales invoices by number or customerRead-onlyInspect
Find sales invoices by invoice number, customer name or customer id (give at least one). POST /api/v2/getinvoices2.
| Name | Required | Description | Default |
|---|---|---|---|
| invoice_no | No | Invoice number. | |
| customer_id | No | Customer id (from merit_list_customers). | |
| max_results | No | Show at most this many rows (default 100, max 1000); the reply says how many there are in total. | |
| customer_name | No | Customer name. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
26 tool updates
- First observed
merit_balance_sheet - First observed
merit_create_customer - First observed
merit_customer_debts_report - First observed
merit_customer_payments_report - First observed
merit_get_gl_batch - First observed
merit_get_purchase_invoice - First observed
merit_get_sales_invoice - First observed
merit_income_statement - First observed
merit_list_accounts - First observed
merit_list_bank_payments - First observed
merit_list_banks - First observed
merit_list_customers - First observed
merit_list_departments - First observed
merit_list_dimensions - First observed
merit_list_financial_years - First observed
merit_list_gl_batches - First observed
merit_list_items - First observed
merit_list_payment_types - First observed
merit_list_payments - First observed
merit_list_purchase_invoices - First observed
merit_list_sales_invoices - First observed
merit_list_taxes - First observed
merit_list_vendors - First observed
merit_purchase_report - First observed
merit_sales_report - First observed
merit_search_sales_invoices
Related MCP Connectors
Read SmartAccounts clients, vendors, invoices, payments, ledger, accounts; create and book records.
181Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.
201Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices.
151Read CashCtrl accounts, journal, orders, people, articles, salaries and reports; book and create.
281
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
- AlicenseBqualityBmaintenanceEnables read-only access to Merit Aktiva accounting data, including customers, vendors, sales invoices, accounts, payments, and taxes, through natural language MCP tools.77MIT
- MIT
- AlicenseNot gradedqualityBmaintenanceEnables read-only querying of Invoice4U accounting data, including documents, customers, branches, tax rates, and Israeli invoice allocation statuses.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.