# Merit Aktiva MCP by usefulapi

> Merit Aktiva MCP by usefulapi is an MCP server. Read Merit Aktiva invoices, customers, vendors, items, payments and reports; create a customer. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/merit-aktiva/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/merit-aktiva
- **MCP Registry name:** io.usefulapi/merit-aktiva
- **Listing updated:** 2026-11-13

## About

Read Merit Aktiva invoices, customers, vendors, items, payments and reports; create a customer.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http merit-aktiva https://merit-aktiva.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://merit-aktiva.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "merit-aktiva": {
      "url": "https://merit-aktiva.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "merit-aktiva": {
      "type": "http",
      "url": "https://merit-aktiva.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "merit-aktiva": {
      "serverUrl": "https://merit-aktiva.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "merit-aktiva": {
      "type": "http",
      "url": "https://merit-aktiva.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `merit_list_sales_invoices`: 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.
- `merit_search_sales_invoices`: Find sales invoices by invoice number, customer name or customer id (give at least one). POST /api/v2/getinvoices2.
- `merit_get_sales_invoice`: 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.
- `merit_list_purchase_invoices`: 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.
- `merit_get_purchase_invoice`: One purchase invoice in full: header, lines, payments. The attachment is never requested. POST /api/v2/getpurchorder.
- `merit_list_customers`: 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.
- `merit_list_vendors`: 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.
- `merit_list_items`: 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.
- `merit_list_accounts`: The general ledger chart of accounts (code, names, VAT, parent flag, active flag). GET /api/v2/accounts.
- `merit_list_taxes`: All VAT rates of the company (TaxId, code, name, percent, active flag). The TaxId is what invoice rows refer to. GET /api/v2/taxes.
- `merit_list_departments`: Departments (code, name, active flag). GET /api/v2/departments.
- `merit_list_banks`: The company's bank and cash accounts (BankId, name, IBAN, currency, ledger account). BankId feeds the payment tools. GET /api/v2/banks.
- `merit_list_financial_years`: Accounting periods (financial years) with start, end and active flag. POST /api/v2/getaccperiods.
- `merit_list_dimensions`: Accounting dimensions and their values (DimId, name, value code, expiry). all_values = true also lists expired values. POST /api/v2/getdimensions.
- `merit_list_payment_types`: Payment methods and sources (cash, banks, reporting entities, ledger accounts) usable for purchases, expense reports or sales. POST /api/v2/getpaymenttypes.
- `merit_list_payments`: 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.
- `merit_list_bank_payments`: 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.
- `merit_list_gl_batches`: 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.
- `merit_get_gl_batch`: 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.
- `merit_customer_debts_report`: 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.
- `merit_customer_payments_report`: 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.
- `merit_income_statement`: 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.
- `merit_balance_sheet`: 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.
- `merit_sales_report`: Sales totals for a period, grouped by invoice, customer, item or country. POST /api/v2/getsalesrep.
- `merit_purchase_report`: Purchase totals for a period, grouped by invoice, vendor, item or fixed asset. POST /api/v2/getpurchrep.
- `merit_create_customer`: 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.

## FAQ

### How do I add Merit Aktiva MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http merit-aktiva https://merit-aktiva.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/merit-aktiva-mcp-by-usefulapi
