Skip to main content
Glama

SmartAccounts MCP by usefulapi

Server Details

Read SmartAccounts clients, vendors, invoices, payments, ledger, accounts; create and book records.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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 tools
smartaccounts_create_clientCreate a client
Destructive
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
cityNo
nameYesClient name.
emailNoContact email.
phoneNoContact phone.
countyNo
vat_pcYesThe client's default VAT code (the vatPc of smartaccounts_list_vat_rates), for example 20.
commentNoInternal comment.
countryNo2-letter ISO country code, for example EE.
address1No
address2No
reg_codeNoCompany registry code.
vat_numberNoVAT registration number.
postal_codeNo
bank_accountNoBank account number (IBAN).
invoice_due_daysNoDefault invoice due date in days.
smartaccounts_create_ledger_entryCreate a manual ledger entry
Destructive
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesEntry date, yyyy-mm-dd.
rowsYesEntry rows; total debit must equal total credit.
commentNoInternal comment.
documentNoDocument number text.
smartaccounts_create_paymentCreate a payment
Destructive
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesPayment date, yyyy-mm-dd.
rowsYesThe invoices this payment settles.
commentNoInternal comment.
currencyYesCurrency code, for example EUR; must match the account's currency.
documentNoDocument number text.
partner_idYesThe client id (partner_type CLIENT) or vendor id (VENDOR).
account_nameYesThe name of the bank or cash account.
account_typeYesBANK or CASH.
partner_typeYesCLIENT = money received from a client; VENDOR = money paid to a vendor.
exchange_rateNoExchange rate; only for a currency without an ECB rate.
smartaccounts_create_sales_invoiceCreate a sales invoice
Destructive
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesInvoice date, yyyy-mm-dd.
rowsYesInvoice rows.
commentNoInternal comment.
currencyNoCurrency code (default EUR).
due_dateNoDue date, yyyy-mm-dd (default from the client's settings).
client_idYesThe client id (from smartaccounts_list_clients).
invoice_noteNoAdditional text printed on the invoice PDF.
exchange_rateNoExchange rate; only for a currency without an ECB rate.
reference_numberNoReference number for payment orders (default generated).
smartaccounts_get_client_balanceGet a client's outstanding balance
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe client id (from smartaccounts_list_clients).
balance_dateNoBalance on this date, yyyy-mm-dd (default today).
fetch_detailsNoInclude the documents that make up the balance.
smartaccounts_get_vendor_balanceGet a vendor's outstanding balance
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe vendor id (from smartaccounts_list_vendors).
balance_dateNoBalance on this date, yyyy-mm-dd (default today).
fetch_detailsNoInclude the documents that make up the balance.
smartaccounts_list_accountsList the chart of accounts
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

smartaccounts_list_articlesList or search articles
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
codeNoA specific article code.
pageNoPage number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page).
modified_toNoOnly articles modified before, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
modified_fromNoOnly articles modified after, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
search_stringNoFilter by article code or name.
smartaccounts_list_bank_accountsList bank accounts
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

smartaccounts_list_cash_accountsList cash accounts
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

smartaccounts_list_clientsList or search clients
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idNoA specific client id.
pageNoPage number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page).
modified_toNoOnly clients modified until, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
modified_fromNoOnly clients modified after, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
fetch_contactsNoInclude contacts (emails, phones).
fetch_addressesNoInclude addresses.
name_or_reg_codeNoName or registry code to search for.
smartaccounts_list_ledger_entriesList general ledger entries
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idNoA specific entry id.
pageNoPage number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page).
date_toNoEntries dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
doc_typeNoOnly entries of this type (LEDGER_ENTRY = manual ledger entry).
date_fromNoEntries dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
date_typeNoWhich date the range filters: entry date (default) or added/modified time.
fetch_rowsNoInclude the entry rows (account, debit, credit).
payment_statusNounpaid or overdue invoices only. Omit for all.
filter_descriptionNoFilter by document number or row description.
smartaccounts_list_payment_methodsList payment methods
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

smartaccounts_list_paymentsList payments
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idNoA specific payment id.
pageNoPage number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page).
date_toNoPayments dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
date_fromNoPayments dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
date_typeNoWhich date the range filters: payment date (default) or modification time.
fetch_rowsNoInclude the payment rows.
partner_idNoFilter by client or vendor id.
account_nameNoFilter by the bank or cash account name.
account_typeNoOnly bank or only cash payments.
partner_nameNoFilter by client or vendor name.
partner_typeNoOnly client payments or only vendor payments.
smartaccounts_list_purchase_invoicesList purchase invoices
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idNoA specific invoice id.
pageNoPage number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page).
date_toNoInvoices dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
date_fromNoInvoices dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
date_typeNoWhich date the range filters: invoice date (default), entry date, due date or modification time.
vendor_idNoOnly this vendor's invoices.
fetch_rowsNoInclude the invoice rows.
vendor_nameNoFilter by vendor name.
invoice_numberNoFilter by invoice number.
payment_statusNounpaid = not fully paid; overdue = unpaid and past due. Omit for all.
smartaccounts_list_sales_invoicesList sales invoices
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idNoA specific invoice id.
pageNoPage number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page).
date_toNoInvoices dated to, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
client_idNoOnly this client's invoices.
date_fromNoInvoices dated from, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
date_typeNoWhich date the range filters: invoice date (default), entry date, due date or modification time.
fetch_rowsNoInclude the invoice rows.
client_nameNoFilter by client name.
invoice_numberNoFilter by invoice number.
payment_statusNounpaid = not fully paid; overdue = unpaid and past due. Omit for all.
smartaccounts_list_vat_ratesList VAT rates
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

smartaccounts_list_vendorsList or search vendors
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idNoA specific vendor id.
pageNoPage number, 1-based (default 1). Use next_page_number from the previous reply (100 objects per page).
modified_toNoOnly vendors modified until, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
modified_fromNoOnly vendors modified after, yyyy-mm-dd (or yyyy-mm-ddTHH:mm:ss, Estonian time).
fetch_contactsNoInclude contacts (emails, phones).
fetch_addressesNoInclude addresses.
name_or_reg_codeNoName or registry code to search for.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 18 tool updates
    • First observedsmartaccounts_create_client
    • First observedsmartaccounts_create_ledger_entry
    • First observedsmartaccounts_create_payment
    • First observedsmartaccounts_create_sales_invoice
    • First observedsmartaccounts_get_client_balance
    • First observedsmartaccounts_get_vendor_balance
    • First observedsmartaccounts_list_accounts
    • First observedsmartaccounts_list_articles
    • First observedsmartaccounts_list_bank_accounts
    • First observedsmartaccounts_list_cash_accounts
    • First observedsmartaccounts_list_clients
    • First observedsmartaccounts_list_ledger_entries
    • First observedsmartaccounts_list_payment_methods
    • First observedsmartaccounts_list_payments
    • First observedsmartaccounts_list_purchase_invoices
    • First observedsmartaccounts_list_sales_invoices
    • First observedsmartaccounts_list_vat_rates
    • First observedsmartaccounts_list_vendors

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    A
    maintenance
    Enables 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.
    130
    1,329 npm
    37
    Apache 2.0
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables accountants to connect Xero, read accounting data, analyze, and execute controlled draft operations after explicit confirmation, with Xero as the source of truth.
    -
  • F
    license
    A
    quality
    B
    maintenance
    Enables 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
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables MCP-capable clients to read and write directly in epago accounting, including chart of accounts, transactions, invoices, payments, receipts, and tax reports.
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.