Skip to main content
Glama
werkstatt-jasper

merit-aktiva-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNopino level; logs go to stderr onlyinfo
MERIT_API_IDYesApi ID from Merit Aktiva > Settings > API Settings
MERIT_API_KEYYesApi Key (HMAC-SHA256 shared secret)
MERIT_BASE_URLNoBase URL for the Merit API. Use https://program.360ksiegowosc.pl for Poland.https://aktiva.merit.ee
MERIT_HTTP_MAX_RETRIESNoExtra attempts on 429/5xx/network errors0
MERIT_HTTP_RETRY_BASE_MSNoExponential backoff base delay500
MERIT_REQUEST_TIMEOUT_MSNoOutbound HTTP timeout30000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

merit_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 }.

merit_update_customerA

Update a Merit Aktiva customer (POST /api/v1/updatecustomer). id is required; other fields are optional patches.

merit_list_customer_groupsA

List Merit Aktiva customer groups (POST /api/v2/getcustomergroups). No filters.

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.

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.

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 }.

merit_update_vendorA

Update a Merit Aktiva vendor (POST /api/v2/updatevendor). id is required; other fields are optional patches. v2 supports Dimensions.

merit_list_vendor_groupsA

List Merit Aktiva vendor groups (POST /api/v2/getvendorgroups). No filters.

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.

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.

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).

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).

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.

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.

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.

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.

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.

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.

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.

merit_list_payment_typesA

List Merit Aktiva payment types (POST /api/v2/getpaymenttypes). type is required: 1 = purchases, 2 = expense reports, 3 = sales.

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.

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).

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).

merit_delete_paymentA

DESTRUCTIVE: delete a Merit Aktiva payment (POST /api/v1/deletepayment). id is the payment GUID. There is no undo.

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.

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).

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).

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.

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.

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.

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.

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.

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.

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.

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.

merit_list_item_groupsA

List Merit Aktiva item groups (POST /api/v2/getitemgroups). No filters.

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 }].

merit_update_itemA

Update a Merit Aktiva item (POST /api/v1/updateitem). id is required; other fields are optional patches.

merit_create_item_groupsA

Create Merit Aktiva item groups (POST /api/v2/senditemgroups). Each group needs code and name.

merit_list_projectsA

List Merit Aktiva projects (POST /api/v1/getprojects). No filters. Returns Code, Name, EndDate.

merit_list_cost_centersA

List Merit Aktiva cost centers (POST /api/v1/getcostcenters). No filters.

merit_list_dimensionsA

List Merit Aktiva dimensions and their values (POST /api/v2/getdimensions). Set allValues to include inactive/ended values.

merit_list_departmentsA

List Merit Aktiva departments (POST /api/v1/getdepartments). No filters.

merit_list_unitsA

List Merit Aktiva units of measure (POST /api/v1/getunits). No filters.

merit_list_banksA

List Merit Aktiva banks / payment methods (POST /api/v1/getbanks). No filters.

merit_list_financial_yearsA

List Merit Aktiva accounting periods / financial years (POST /api/v2/getaccperiods). No filters.

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.

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.

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.

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.

merit_get_inventory_reportC

Inventory report (POST /api/v2/getinventoryreport). reportDate is ISO YYYY-MM-DD.

merit_get_sales_reportC

Sales report (POST /api/v2/getsalesrep). reportType: 1 = invoices, 2 = customers, 3 = articles, 4 = countries, 5 = countries general.

merit_get_purchase_reportC

Purchase report (POST /api/v2/getpurchrep). reportType: 1 = invoices, 2 = vendors, 3 = articles, 4 = fixed assets.

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.

merit_get_sales_offerA

Get one Merit Aktiva sales offer with rows (POST /api/v2/getoffer). id is the offer GUID.

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.

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.

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.

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.

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.

merit_get_recurring_invoiceA

Get one Merit Aktiva recurring invoice with rows (POST /api/v2/getperinvoice). id is the recurring-invoice GUID.

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.

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.

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.

merit_list_locationsA

List Merit Aktiva stock locations (POST /api/v2/getlocations). No filters. Returns Code, Name, and next document numbers per movement type.

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.

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.

merit_list_fixed_asset_locationsA

List Merit Aktiva fixed-asset locations (POST /api/v2/getfalocations). No filters.

merit_list_fixed_asset_employeesA

List Merit Aktiva fixed-asset responsible employees (POST /api/v2/getfaresppersons). No filters.

merit_list_fixed_assetsA

List Merit Aktiva fixed assets (POST /api/v2/getfixassets). No filters.

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).

merit_list_pricesA

List Merit Aktiva sales prices (POST /api/v2/getprices). No filters.

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.

merit_send_pricesA

Create or replace Merit Aktiva sales prices (POST /api/v2/sendprices). targetGroup: 0 = campaign, 1 = customer, 2 = customer group.

merit_list_discountsA

List Merit Aktiva sales discounts (POST /api/v2/getdiscounts). No filters.

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.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/werkstatt-jasper/merit-aktiva-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server