SmartAccounts MCP by usefulapi
Server Details
Read SmartAccounts clients, vendors, invoices, payments, ledger, accounts; create and book records.
- 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
18 toolssmartaccounts_create_clientCreate a clientDestructiveInspect
Add a new client (purchasesales/clients:add). Search first with smartaccounts_list_clients so a client is not created twice. Returns clientId and the generated referenceNumber. This creates a real accounting record in the company's books. This server cannot edit or delete it; correct it in SmartAccounts. It never retries: if a reply is unclear, look in SmartAccounts before calling again. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| name | Yes | Client name. | |
| No | Contact email. | ||
| phone | No | Contact phone. | |
| county | No | ||
| vat_pc | Yes | The client's default VAT code (the vatPc of smartaccounts_list_vat_rates), for example 20. | |
| comment | No | Internal comment. | |
| country | No | 2-letter ISO country code, for example EE. | |
| address1 | No | ||
| address2 | No | ||
| reg_code | No | Company registry code. | |
| vat_number | No | VAT registration number. | |
| postal_code | No | ||
| bank_account | No | Bank account number (IBAN). | |
| invoice_due_days | No | Default invoice due date in days. |
smartaccounts_create_ledger_entryCreate a manual ledger entryDestructiveInspect
Post a manual general ledger entry (journal entry, general/entries:add) in EUR. Debits must equal credits. Account codes come from smartaccounts_list_accounts. Fails if the period is locked. Returns id, number and amount. This creates a real accounting record in the company's books. This server cannot edit or delete it; correct it in SmartAccounts. It never retries: if a reply is unclear, look in SmartAccounts before calling again. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Entry date, yyyy-mm-dd. | |
| rows | Yes | Entry rows; total debit must equal total credit. | |
| comment | No | Internal comment. | |
| document | No | Document number text. |
smartaccounts_create_paymentCreate a paymentDestructiveInspect
Record a bank or cash payment against one or more invoices (purchasesales/payments:add): a client paying a sales invoice, or a payment to a vendor for a purchase invoice. Use smartaccounts_list_bank_accounts or _list_cash_accounts for account_name, and the invoice ids from the invoice lists. The currency must match the account's currency. Returns paymentId, number and amount. This creates a real accounting record in the company's books. This server cannot edit or delete it; correct it in SmartAccounts. It never retries: if a reply is unclear, look in SmartAccounts before calling again. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Payment date, yyyy-mm-dd. | |
| rows | Yes | The invoices this payment settles. | |
| comment | No | Internal comment. | |
| currency | Yes | Currency code, for example EUR; must match the account's currency. | |
| document | No | Document number text. | |
| partner_id | Yes | The client id (partner_type CLIENT) or vendor id (VENDOR). | |
| account_name | Yes | The name of the bank or cash account. | |
| account_type | Yes | BANK or CASH. | |
| partner_type | Yes | CLIENT = money received from a client; VENDOR = money paid to a vendor. | |
| exchange_rate | No | Exchange rate; only for a currency without an ECB rate. |
smartaccounts_create_sales_invoiceCreate a sales invoiceDestructiveInspect
Post a new sales (client) invoice (purchasesales/clientinvoices:add). The invoice number is generated by SmartAccounts, totals and VAT are calculated from the rows, and the invoice is booked to the ledger at once (it is not a draft). The client must exist (smartaccounts_list_clients); each row's code must be an article code (smartaccounts_list_articles) and vat_pc a VAT code (smartaccounts_list_vat_rates). Fails if the period is locked. Returns invoiceId, number and the totals. This creates a real accounting record in the company's books. This server cannot edit or delete it; correct it in SmartAccounts. It never retries: if a reply is unclear, look in SmartAccounts before calling again. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Invoice date, yyyy-mm-dd. | |
| rows | Yes | Invoice rows. | |
| comment | No | Internal comment. | |
| currency | No | Currency code (default EUR). | |
| due_date | No | Due date, yyyy-mm-dd (default from the client's settings). | |
| client_id | Yes | The client id (from smartaccounts_list_clients). | |
| invoice_note | No | Additional text printed on the invoice PDF. | |
| exchange_rate | No | Exchange rate; only for a currency without an ECB rate. | |
| reference_number | No | Reference number for payment orders (default generated). |
smartaccounts_get_client_balanceGet a client's outstanding balanceRead-onlyInspect
The outstanding balance of one client (purchasesales/clients:getbalance), optionally on a past date and with the open documents. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The client id (from smartaccounts_list_clients). | |
| balance_date | No | Balance on this date, yyyy-mm-dd (default today). | |
| fetch_details | No | Include the documents that make up the balance. |
smartaccounts_get_vendor_balanceGet a vendor's outstanding balanceRead-onlyInspect
The outstanding balance owed to one vendor (purchasesales/vendors:getbalance), optionally on a past date and with the open documents. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The vendor id (from smartaccounts_list_vendors). | |
| balance_date | No | Balance on this date, yyyy-mm-dd (default today). | |
| fetch_details | No | Include the documents that make up the balance. |
smartaccounts_list_accountsList the chart of accountsRead-onlyInspect
The chart of accounts: code, type (ASSET, LIABILITY, INCOME, EXPENSE), Estonian and English description. Use the codes in ledger entries. (settings/accounts:get). Not paged. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
smartaccounts_list_articlesList or search articlesRead-onlyInspect
Products, services and warehouse items (purchasesales/articles:get): code, description, type, unit, VAT code, sales and purchase prices, accounts. Search by code or name, or by modification time. Paged (100 per page). The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | A specific article code. | |
| page | No | Page number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page). | |
| modified_to | No | Only articles modified before, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| modified_from | No | Only articles modified after, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| search_string | No | Filter by article code or name. |
smartaccounts_list_bank_accountsList bank accountsRead-onlyInspect
The company's bank accounts: name (used as accountName in payments), ledger account, currency, IBAN, SWIFT. (settings/bankaccounts:get). Not paged. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
smartaccounts_list_cash_accountsList cash accountsRead-onlyInspect
The company's cash registers: name (used as accountName in payments), ledger account, currency. (settings/cashaccounts:get). Not paged. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
smartaccounts_list_clientsList or search clientsRead-onlyInspect
Customers of the company (purchasesales/clients:get): id, name, regCode, vatNumber, bank account, due days, discount, VAT code. Filter by name or registry code, by id, or by modification time. Paged (100 per page). The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A specific client id. | |
| page | No | Page number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page). | |
| modified_to | No | Only clients modified until, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| modified_from | No | Only clients modified after, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| fetch_contacts | No | Include contacts (emails, phones). | |
| fetch_addresses | No | Include addresses. | |
| name_or_reg_code | No | Name or registry code to search for. |
smartaccounts_list_ledger_entriesList general ledger entriesRead-onlyInspect
General ledger entries of every type (general/entries:get): manual entries, invoices, payments, VAT returns, depreciation. Filter by date, type, text or payment status. Paged (100 per page). The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A specific entry id. | |
| page | No | Page number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page). | |
| date_to | No | Entries dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| doc_type | No | Only entries of this type (LEDGER_ENTRY = manual ledger entry). | |
| date_from | No | Entries dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| date_type | No | Which date the range filters: entry date (default) or added/modified time. | |
| fetch_rows | No | Include the entry rows (account, debit, credit). | |
| payment_status | No | unpaid or overdue invoices only. Omit for all. | |
| filter_description | No | Filter by document number or row description. |
smartaccounts_list_payment_methodsList payment methodsRead-onlyInspect
Payment methods: name, ledger account, whether cash. (settings/paymentmethods:get). Not paged. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
smartaccounts_list_paymentsList paymentsRead-onlyInspect
Bank and cash payments from clients and to vendors (purchasesales/payments:get): date, partner, account, currency, amount, optionally the rows (which invoices were paid). Paged (100 per page). The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A specific payment id. | |
| page | No | Page number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page). | |
| date_to | No | Payments dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| date_from | No | Payments dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| date_type | No | Which date the range filters: payment date (default) or modification time. | |
| fetch_rows | No | Include the payment rows. | |
| partner_id | No | Filter by client or vendor id. | |
| account_name | No | Filter by the bank or cash account name. | |
| account_type | No | Only bank or only cash payments. | |
| partner_name | No | Filter by client or vendor name. | |
| partner_type | No | Only client payments or only vendor payments. |
smartaccounts_list_purchase_invoicesList purchase invoicesRead-onlyInspect
Purchase (vendor) invoices (purchasesales/vendorinvoices:get): number, vendor, dates, amounts, VAT, outstanding amount, optionally the rows. Filter by date, vendor, number or payment status (unpaid, overdue). Paged (100 per page). The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A specific invoice id. | |
| page | No | Page number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page). | |
| date_to | No | Invoices dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| date_from | No | Invoices dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| date_type | No | Which date the range filters: invoice date (default), entry date, due date or modification time. | |
| vendor_id | No | Only this vendor's invoices. | |
| fetch_rows | No | Include the invoice rows. | |
| vendor_name | No | Filter by vendor name. | |
| invoice_number | No | Filter by invoice number. | |
| payment_status | No | unpaid = not fully paid; overdue = unpaid and past due. Omit for all. |
smartaccounts_list_sales_invoicesList sales invoicesRead-onlyInspect
Sales (client) invoices (purchasesales/clientinvoices:get): number, client, dates, amounts, VAT, outstanding amount, optionally the rows. Filter by date, client, number or payment status (unpaid, overdue). Paged (100 per page). The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A specific invoice id. | |
| page | No | Page number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page). | |
| date_to | No | Invoices dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| client_id | No | Only this client's invoices. | |
| date_from | No | Invoices dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| date_type | No | Which date the range filters: invoice date (default), entry date, due date or modification time. | |
| fetch_rows | No | Include the invoice rows. | |
| client_name | No | Filter by client name. | |
| invoice_number | No | Filter by invoice number. | |
| payment_status | No | unpaid = not fully paid; overdue = unpaid and past due. Omit for all. |
smartaccounts_list_vat_ratesList VAT ratesRead-onlyInspect
VAT codes: vatPc code, percentage, descriptions, whether active for sales or purchases, accounts. Use vatPc in client and invoice rows. (settings/vatpcs:get). Not paged. The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
smartaccounts_list_vendorsList or search vendorsRead-onlyInspect
Suppliers of the company (purchasesales/vendors:get): id, name, regCode, vatNumber, bank account, VAT code. Filter by name or registry code, by id, or by modification time. Paged (100 per page). The vendor limit is 60 requests per minute and 1000 per 24 hours; every call here is one request.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A specific vendor id. | |
| page | No | Page number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page). | |
| modified_to | No | Only vendors modified until, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| modified_from | No | Only vendors modified after, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time). | |
| fetch_contacts | No | Include contacts (emails, phones). | |
| fetch_addresses | No | Include addresses. | |
| name_or_reg_code | No | Name or registry code to search for. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
18 tool updates
- First observed
smartaccounts_create_client - First observed
smartaccounts_create_ledger_entry - First observed
smartaccounts_create_payment - First observed
smartaccounts_create_sales_invoice - First observed
smartaccounts_get_client_balance - First observed
smartaccounts_get_vendor_balance - First observed
smartaccounts_list_accounts - First observed
smartaccounts_list_articles - First observed
smartaccounts_list_bank_accounts - First observed
smartaccounts_list_cash_accounts - First observed
smartaccounts_list_clients - First observed
smartaccounts_list_ledger_entries - First observed
smartaccounts_list_payment_methods - First observed
smartaccounts_list_payments - First observed
smartaccounts_list_purchase_invoices - First observed
smartaccounts_list_sales_invoices - First observed
smartaccounts_list_vat_rates - First observed
smartaccounts_list_vendors
Related MCP Connectors
Read CashCtrl accounts, journal, orders, people, articles, salaries and reports; book and create.
281Read e-Boekhouden relations, invoices, ledgers, bookings and products; create relations, invoices.
251Read Merit Aktiva invoices, customers, vendors, items, payments and reports; create a customer.
261Read SuperFaktura invoices, clients, expenses, bank and stock; create clients, expenses and drafts.
251
Related MCP Servers
- AlicenseCqualityAmaintenanceEnables interaction with the Estonian e-arveldaja (RIK e-Financials) REST API to manage financial records like invoices and journal entries using natural language. It supports automating purchase invoice entry from PDFs, reconciling bank transactions, and generating financial reports.1301,329 npm37Apache 2.0
- FlicenseNot gradedqualityBmaintenanceEnables accountants to connect Xero, read accounting data, analyze, and execute controlled draft operations after explicit confirmation, with Xero as the source of truth.-
- FlicenseAqualityBmaintenanceEnables MCP clients to read local Kitsas bookkeeping files, including accounts, fiscal years, partners, and vouchers, and to create purchase invoice drafts from chat or PDFs without ever writing to the ledger.10-

epago MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceEnables MCP-capable clients to read and write directly in epago accounting, including chart of accounts, transactions, invoices, payments, receipts, and tax reports.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.