Merit MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MERIT_API_ID | Yes | Your Merit Aktiva API ID (required for full functionality) | |
| MERIT_API_KEY | Yes | Your Merit Aktiva API key (required for full functionality) | |
| MERIT_API_COUNTRY | No | Country code, either EE or PL, defaults to EE | EE |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_setup_instructionsA | Report whether MERIT_API_ID and MERIT_API_KEY are configured, and explain how to set them when they are not. |
| merit_read_master_dataC | Read-only tool. Read common master and reference data from Merit. Actions: customers_list: List customers with optional filters.; customer_groups_list: List customer groups.; vendors_list: List vendors with optional filters.; vendor_groups_list: List vendor groups.; items_list: List items with optional filters.; item_groups_list: List item groups.; taxes_list: List tax rates.; dimensions_list: List dimensions.; banks_list: List banks.; accounts_list: List accounts.; projects_list: List projects.; cost_centers_list: List cost centers.; departments_list: List departments.; units_list: List units of measure.; financial_years_list: List financial years. |
| merit_read_salesA | Read-only tool. Read sales invoices, offers, and recurring invoice data. Actions: invoices_list: List sales invoices.; invoice_get: Fetch one sales invoice by id.; invoice_pdf_get: Fetch one sales invoice PDF by id.; offers_list: List sales offers.; offer_get: Fetch one sales offer by id.; recurring_invoices_list: List recurring invoices.; recurring_invoice_get: Fetch one recurring invoice by id.; recurring_invoice_addresses_list: List recurring invoice addresses. |
| merit_read_purchasesA | Read-only tool. Read purchase invoices and purchase orders. Actions: invoices_list: List purchase invoices.; invoice_get: Fetch one purchase invoice by id.; orders_list: List purchase orders. |
| merit_read_financialB | Read-only tool. Read payments, banks, and GL information. Actions: payments_list: List payments.; payment_types_list: List payment types.; payment_imports_list: List payment imports for a bank.; expense_payments_list: List expense payments for a bank.; income_payments_list: List income payments for a bank.; gl_batches_list: List GL batches.; gl_batch_get: Fetch one GL batch by id.; gl_batches_full_list: List GL batches with full details. |
| merit_read_inventoryC | Read-only tool. Read inventory, fixed asset, and pricing data. Actions: locations_list: List inventory locations.; movements_list: List inventory movements.; fixed_asset_locations_list: List fixed asset locations.; fixed_asset_responsible_persons_list: List fixed asset responsible persons.; fixed_assets_list: List fixed assets.; prices_list: List prices.; discounts_list: List discounts.; price_get: Fetch an effective price. |
| merit_read_reportsC | Read-only tool. Read Merit reports and report continuations. Actions: customer_debts_get: Get customer debts report.; customer_payments_get: Get customer payment report.; more_data_get: Get continuation page for a report.; profit_report_get: Get statement of profit or loss.; balance_report_get: Get statement of financial position.; inventory_report_get: Get inventory report.; sales_report_get: Get sales report.; purchase_report_get: Get purchase report. |
| merit_write_customersA | Preview-only write tool. Does not execute changes; returns intended operation details and a confirmation_code for merit_write_customers_confirm. Create or update customers and vendors. Actions: customer_upsert: Create or update a customer.; vendor_upsert: Create or update a vendor.; vendor_update: Update an existing vendor by Id. Only Id is required; all other fields are optional. Typical use: after receiving a new purchase invoice (e.g. as PDF), verify and sync the vendor's BankAccount (IBAN) and SWIFT_BIC so future payments require no manual lookup. Payload fields: Id (guid, required), Name, CountryCode, Address, City, PostalCode, PhoneNo, PhoneNo2, Email, RegNo, VatRegNo, SalesInvLang, VatAccountable, BankAccount, ReferenceNo, VendGrCode, VendGrId, PayerReceiverName, Dimensions ([{DimId, DimValueId, DimCode}]). |
| merit_write_customers_confirmA | Confirmed mutating tool. Executes a previously previewed write operation from merit_write_customers when called with confirmation_code and confirmed=true. Create or update customers and vendors. Actions: customer_upsert: Create or update a customer.; vendor_upsert: Create or update a vendor.; vendor_update: Update an existing vendor by Id. Only Id is required; all other fields are optional. Typical use: after receiving a new purchase invoice (e.g. as PDF), verify and sync the vendor's BankAccount (IBAN) and SWIFT_BIC so future payments require no manual lookup. Payload fields: Id (guid, required), Name, CountryCode, Address, City, PostalCode, PhoneNo, PhoneNo2, Email, RegNo, VatRegNo, SalesInvLang, VatAccountable, BankAccount, ReferenceNo, VendGrCode, VendGrId, PayerReceiverName, Dimensions ([{DimId, DimValueId, DimCode}]). |
| merit_write_salesA | Preview-only write tool. Does not execute changes; returns intended operation details and a confirmation_code for merit_write_sales_confirm. Create, delete, and deliver sales invoices. Actions: sales_invoice_create: Create a draft sales invoice through Merit v1 /sendinvoice. The payload is passed through to Merit and must use the create schema, not the invoice_get response shape. Required shape: Customer.Id, DocDate, TransactionDate, and DueDate as YYYYMMDD strings, mandatory string InvoiceNo, CurrencyCode (usually EUR), PriceInclVat (usually false), optional FComment footer note, singular InvoiceRow list, TaxAmount list, and TotalAmount. Each InvoiceRow item must use Item={Code, Description, UOMName}, Quantity, Price, row-level TaxId GUID, and Account. Gotchas: use InvoiceRow (singular), not InvoiceRows; Merit will not auto-assign InvoiceNo, so read merit_read_sales action=invoices_list and use the next integer; UOMName belongs inside Item; use Account, not AccountCode; use TaxId GUID, not TaxName or TaxPct; TaxAmount is required even for zero VAT, e.g. [{'TaxId': '', 'Amount': 0}]; TotalAmount is required and should match the row Price x Quantity total. For Googolplex no-VAT 'Ei ole käive', the known TaxId is 7e170b45-fe96-4048-b824-39733c33e734; verify with merit_read_master_data action=taxes_list if it changes. Do not include DelivNote/delivnote=true in invoice creation payloads; invoices should remain undelivered drafts and delivery is handled manually in Merit.; sales_invoice_delete: Delete a sales invoice by id.; credit_invoice_create: Create a credit invoice.; sales_invoice_send_email: Send a sales invoice by email. This delivers the invoice; do not use it in the normal draft creation flow where delivery is handled manually in Merit. Keep delivnote=false unless the user explicitly asks for delivery note mode without prices.; sales_invoice_send_einvoice: Send a sales invoice as e-invoice. This delivers the invoice; do not use it in the normal draft creation flow where delivery is handled manually in Merit. Keep delivnote=false unless the user explicitly asks for delivery note mode without prices. |
| merit_write_sales_confirmA | Confirmed mutating tool. Executes a previously previewed write operation from merit_write_sales when called with confirmation_code and confirmed=true. Create, delete, and deliver sales invoices. Actions: sales_invoice_create: Create a draft sales invoice through Merit v1 /sendinvoice. The payload is passed through to Merit and must use the create schema, not the invoice_get response shape. Required shape: Customer.Id, DocDate, TransactionDate, and DueDate as YYYYMMDD strings, mandatory string InvoiceNo, CurrencyCode (usually EUR), PriceInclVat (usually false), optional FComment footer note, singular InvoiceRow list, TaxAmount list, and TotalAmount. Each InvoiceRow item must use Item={Code, Description, UOMName}, Quantity, Price, row-level TaxId GUID, and Account. Gotchas: use InvoiceRow (singular), not InvoiceRows; Merit will not auto-assign InvoiceNo, so read merit_read_sales action=invoices_list and use the next integer; UOMName belongs inside Item; use Account, not AccountCode; use TaxId GUID, not TaxName or TaxPct; TaxAmount is required even for zero VAT, e.g. [{'TaxId': '', 'Amount': 0}]; TotalAmount is required and should match the row Price x Quantity total. For Googolplex no-VAT 'Ei ole käive', the known TaxId is 7e170b45-fe96-4048-b824-39733c33e734; verify with merit_read_master_data action=taxes_list if it changes. Do not include DelivNote/delivnote=true in invoice creation payloads; invoices should remain undelivered drafts and delivery is handled manually in Merit.; sales_invoice_delete: Delete a sales invoice by id.; credit_invoice_create: Create a credit invoice.; sales_invoice_send_email: Send a sales invoice by email. This delivers the invoice; do not use it in the normal draft creation flow where delivery is handled manually in Merit. Keep delivnote=false unless the user explicitly asks for delivery note mode without prices.; sales_invoice_send_einvoice: Send a sales invoice as e-invoice. This delivers the invoice; do not use it in the normal draft creation flow where delivery is handled manually in Merit. Keep delivnote=false unless the user explicitly asks for delivery note mode without prices. |
| merit_write_purchasesA | Preview-only write tool. Does not execute changes; returns intended operation details and a confirmation_code for merit_write_purchases_confirm. Create purchase invoices. Actions: purchase_invoice_create: Create a purchase invoice. |
| merit_write_purchases_confirmB | Confirmed mutating tool. Executes a previously previewed write operation from merit_write_purchases when called with confirmation_code and confirmed=true. Create purchase invoices. Actions: purchase_invoice_create: Create a purchase invoice. |
| merit_write_financialA | Preview-only write tool. Does not execute changes; returns intended operation details and a confirmation_code for merit_write_financial_confirm. Create purchase payments and update related financial master data. Actions: purchase_invoice_payment_create: Create a payment for a purchase invoice. Payload fields: BankId (guid, required), VendorName (str, required), BillNo (invoice number, required), Amount (decimal, required), IBAN (str, auto-fetched from vendor BankAccount if omitted), PaymentDate (YYYYMMDD, defaults to invoice DueDate if omitted), CurrencyCode (str, only for non-EUR payments). Uses v1/sendPaymentV for EUR; v2/sendPaymentV when CurrencyCode is present. Returns the raw Merit API response. Raises error if IBAN or PaymentDate cannot be resolved automatically.; tax_upsert: Create or update a tax rate.; dimensions_add: Add dimensions.; items_add: Add items.; item_update: Update an item. |
| merit_write_financial_confirmA | Confirmed mutating tool. Executes a previously previewed write operation from merit_write_financial when called with confirmation_code and confirmed=true. Create purchase payments and update related financial master data. Actions: purchase_invoice_payment_create: Create a payment for a purchase invoice. Payload fields: BankId (guid, required), VendorName (str, required), BillNo (invoice number, required), Amount (decimal, required), IBAN (str, auto-fetched from vendor BankAccount if omitted), PaymentDate (YYYYMMDD, defaults to invoice DueDate if omitted), CurrencyCode (str, only for non-EUR payments). Uses v1/sendPaymentV for EUR; v2/sendPaymentV when CurrencyCode is present. Returns the raw Merit API response. Raises error if IBAN or PaymentDate cannot be resolved automatically.; tax_upsert: Create or update a tax rate.; dimensions_add: Add dimensions.; items_add: Add items.; item_update: Update an item. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| setup-merit-api | Explain how to configure Merit API credentials for the MCP server. |
| create-sales-invoice | Guide an assistant through creating a sales invoice with Merit API tools. |
| find-or-create-customer | Guide an assistant through finding or creating a customer. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| merit_server_info | Basic discovery information for the Merit API MCP server. |
| merit_tools_catalog | Catalog of all registered Merit API MCP tools. |
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/jaakla/merit_api'
If you have feedback or need assistance with the MCP directory API, please join our Discord server