Skip to content

SmartAccounts MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.3.4 · published by io.usefulapi

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

Deletes · 4Final · 1Changes · 1
CompareRegistry entry

18 tools: 4 can delete or cancel things, 1 do something that can't be undone, 1 change things and 12 only read.

Scanned Oct 22, 2026

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http smartaccounts https://smartaccounts.usefulapi.io/mcp

Findings

Matches of fixed checks, with the text they matched.

2 warn
  • Warnsmartaccounts_list_articles

    The server marks "smartaccounts_list_articles" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true}; The name "smartaccounts_list_articles" says "list": a word for reading.

    What this check looks for
  • Warnsmartaccounts_list_purchase_invoices

    The server marks "smartaccounts_list_purchase_invoices" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

    annotations: {"readOnlyHint":true}; The name "smartaccounts_list_purchase_invoices" says "list": a word for reading.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

18 tools

Deletes or cancels 4Claude Code: deny
  • smartaccounts_create_clientAdd a new client (purchasesales/clients:add).No findings

    Why it is in this group

    • The name "smartaccounts_create_client" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Create a client
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
  • smartaccounts_create_ledger_entryPost a manual general ledger entry (journal entry, general/entries:add) in EUR.No findings

    Why it is in this group

    • The name "smartaccounts_create_ledger_entry" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Create a manual ledger entry
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
  • smartaccounts_create_paymentRecord 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.No findings

    Why it is in this group

    • The name "smartaccounts_create_payment" says "create": a word for a change.
    • The name "smartaccounts_create_payment" also says "payment": a word that usually means money moves, which cannot be taken back.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Create a payment
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
  • smartaccounts_create_sales_invoicePost a new sales (client) invoice (purchasesales/clientinvoices:add).No findings

    Why it is in this group

    • The name "smartaccounts_create_sales_invoice" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Create a sales invoice
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
Can't be undone 1Claude Code: ask
  • smartaccounts_list_purchase_invoicesPurchase (vendor) invoices (purchasesales/vendorinvoices:get): number, vendor, dates, amounts, VAT, outstanding amount, optionally the rows.1 finding

    Why it is in this group

    • The name "smartaccounts_list_purchase_invoices" says "list": a word for reading.
    • The description's first verb is "purchase": a word that usually means money moves, which cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "smartaccounts_list_purchase_invoices" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

      Matched text

      annotations: {"readOnlyHint":true}; The name "smartaccounts_list_purchase_invoices" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List purchase invoices
    • readOnlyHint: true
Changes things 1Claude Code: ask
  • smartaccounts_list_articlesProducts, services and warehouse items (purchasesales/articles:get): code, description, type, unit, VAT code, sales and purchase prices, accounts.1 finding

    Why it is in this group

    • The name "smartaccounts_list_articles" says "list": a word for reading.
    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "smartaccounts_list_articles" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true}; The name "smartaccounts_list_articles" says "list": a word for reading.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List or search articles
    • readOnlyHint: true
Only reads 12Claude Code: allow
  • smartaccounts_get_client_balanceThe outstanding balance of one client (purchasesales/clients:getbalance), optionally on a past date and with the open documents.Reads private dataNo findings

    Why it is in this group

    • The name "smartaccounts_get_client_balance" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "document": it reads documents.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get a client's outstanding balance
    • readOnlyHint: true
  • smartaccounts_get_vendor_balanceThe outstanding balance owed to one vendor (purchasesales/vendors:getbalance), optionally on a past date and with the open documents.Reads private dataNo findings

    Why it is in this group

    • The name "smartaccounts_get_vendor_balance" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "document": it reads documents.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get a vendor's outstanding balance
    • readOnlyHint: true
  • smartaccounts_list_accountsThe chart of accounts: code, type (ASSET, LIABILITY, INCOME, EXPENSE), Estonian and English description.No findings

    Why it is in this group

    • The name "smartaccounts_list_accounts" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List the chart of accounts
    • readOnlyHint: true
  • smartaccounts_list_bank_accountsThe company's bank accounts: name (used as accountName in payments), ledger account, currency, IBAN, SWIFT.No findings

    Why it is in this group

    • The name "smartaccounts_list_bank_accounts" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List bank accounts
    • readOnlyHint: true
  • smartaccounts_list_cash_accountsThe company's cash registers: name (used as accountName in payments), ledger account, currency.No findings

    Why it is in this group

    • The name "smartaccounts_list_cash_accounts" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List cash accounts
    • readOnlyHint: true
  • smartaccounts_list_clientsCustomers of the company (purchasesales/clients:get): id, name, regCode, vatNumber, bank account, due days, discount, VAT code.No findings

    Why it is in this group

    • The name "smartaccounts_list_clients" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List or search clients
    • readOnlyHint: true
  • smartaccounts_list_ledger_entriesGeneral ledger entries of every type (general/entries:get): manual entries, invoices, payments, VAT returns, depreciation.No findings

    Why it is in this group

    • The name "smartaccounts_list_ledger_entries" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List general ledger entries
    • readOnlyHint: true
  • smartaccounts_list_payment_methodsPayment methods: name, ledger account, whether cash.No findings

    Why it is in this group

    • The name "smartaccounts_list_payment_methods" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List payment methods
    • readOnlyHint: true
  • smartaccounts_list_paymentsBank and cash payments from clients and to vendors (purchasesales/payments:get): date, partner, account, currency, amount, optionally the rows (which invoices were paid).No findings

    Why it is in this group

    • The name "smartaccounts_list_payments" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List payments
    • readOnlyHint: true
  • smartaccounts_list_sales_invoicesSales (client) invoices (purchasesales/clientinvoices:get): number, client, dates, amounts, VAT, outstanding amount, optionally the rows.No findings

    Why it is in this group

    • The name "smartaccounts_list_sales_invoices" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List sales invoices
    • readOnlyHint: true
  • smartaccounts_list_vat_ratesVAT codes: vatPc code, percentage, descriptions, whether active for sales or purchases, accounts.No findings

    Why it is in this group

    • The name "smartaccounts_list_vat_rates" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List VAT rates
    • readOnlyHint: true
  • smartaccounts_list_vendorsSuppliers of the company (purchasesales/vendors:get): id, name, regCode, vatNumber, bank account, VAT code.No findings

    Why it is in this group

    • The name "smartaccounts_list_vendors" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: List or search vendors
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged untrusted-input or outbound.

Reads private data2
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write0
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Looked at Oct 22, 2026, 15:30 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
6
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
none
RFC 9728 protected resource metadata
https://smartaccounts.usefulapi.io/.well-known/oauth-protected-resource/mcp
Authorization servers
https://smartaccounts.usefulapi.io
Legacy HTTP+SSE transport
no
Dynamic client registration
yes
Client ID metadata documents
no
  • HighThe whole server

    The endpoint served tools/list without credentials, and the list has 6 tools that change things (4 destructive, 1 irreversible, 1 write). Whether a call also works without credentials was not tested: tools are never called.

    Matched text

    https://smartaccounts.usefulapi.io/mcp: tools/list returned 18 tools to an anonymous client, including smartaccounts_create_client (destructive), smartaccounts_create_sales_invoice (destructive), smartaccounts_create_payment (destructive), smartaccounts_create_ledger_entry (destructive), smartaccounts_list_purchase_invoices (irreversible) and 1 more

    What this check looks for

Install

Pinned to version 1.3.4. Values in angle brackets are yours to fill in.

claude mcp add --transport http smartaccounts https://smartaccounts.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__smartaccounts__smartaccounts_list_clients",
      "mcp__smartaccounts__smartaccounts_get_client_balance",
      "mcp__smartaccounts__smartaccounts_list_vendors",
      "mcp__smartaccounts__smartaccounts_get_vendor_balance",
      "mcp__smartaccounts__smartaccounts_list_sales_invoices",
      "mcp__smartaccounts__smartaccounts_list_payments",
      "mcp__smartaccounts__smartaccounts_list_ledger_entries",
      "mcp__smartaccounts__smartaccounts_list_accounts",
      "mcp__smartaccounts__smartaccounts_list_vat_rates",
      "mcp__smartaccounts__smartaccounts_list_bank_accounts",
      "mcp__smartaccounts__smartaccounts_list_cash_accounts",
      "mcp__smartaccounts__smartaccounts_list_payment_methods"
    ],
    "ask": [
      "mcp__smartaccounts__smartaccounts_list_articles",
      "mcp__smartaccounts__smartaccounts_list_purchase_invoices"
    ],
    "deny": [
      "mcp__smartaccounts__smartaccounts_create_client",
      "mcp__smartaccounts__smartaccounts_create_sales_invoice",
      "mcp__smartaccounts__smartaccounts_create_payment",
      "mcp__smartaccounts__smartaccounts_create_ledger_entry"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as smartaccounts. Review it before you use it.

Capability tags behind 2 rules
  • mcp__smartaccounts__smartaccounts_get_client_balance private-data
  • mcp__smartaccounts__smartaccounts_get_vendor_balance private-data