merit-aktiva-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | pino level; logs go to stderr only | info |
| MERIT_API_ID | Yes | Api ID from Merit Aktiva > Settings > API Settings | |
| MERIT_API_KEY | Yes | Api Key (HMAC-SHA256 shared secret) | |
| MERIT_BASE_URL | No | Base URL for the Merit API. Use https://program.360ksiegowosc.pl for Poland. | https://aktiva.merit.ee |
| MERIT_HTTP_MAX_RETRIES | No | Extra attempts on 429/5xx/network errors | 0 |
| MERIT_HTTP_RETRY_BASE_MS | No | Exponential backoff base delay | 500 |
| MERIT_REQUEST_TIMEOUT_MS | No | Outbound HTTP timeout | 30000 |
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
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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