Cuéntamo
Server Details
Personal finance with balance forecast; VAT and income tax for the self-employed in Spain.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 13 tools
Most tools have clearly distinct purposes: writes (add_transaction, confirm_forecast), reads (list_books, search_transactions, list_upcoming), and summaries/tax modules are separable. The main overlaps are between get_forecast, get_month_summary and how_much_can_i_spend, which all report forward-looking money figures, and between search_transactions and list_upcoming for forecast rows — descriptions differentiate them, but an agent could still hesitate.
Strong verb_noun snake_case pattern throughout (add_transaction, confirm_forecast, get_*, list_*, search_transactions), with get_* / list_* consistently signaling resource retrieval. The only outlier is how_much_can_i_spend, a full question phrase that breaks the convention.
13 tools is well within the sweet spot and each maps to a distinct capability (accounts, transactions, forecasts, spending capacity, month summary, and four self-employed tax tools). Nothing appears redundant or padded.
The read/reporting surface is rich, but the write surface is thin: transactions can only be added (no update/delete, undo only via the app), transfers are explicitly unsupported, and there is no way to create or edit forecasts, recurring items, books, categories, or tax documents. These gaps will force agents to dead-end on common correction and setup workflows.
Available Tools
13 toolsadd_transactionAdd a transactionAInspect
Records one income or expense in an account. Confirmed by default (it already happened, date today or earlier); with forecast=true it is a planned future transaction (today or later). The amount is positive; the sign comes from type. Account and category ids are the ones returned by get_accounts_and_categories. Transfers between accounts are not supported. It can be undone from the app (Ctrl+Z).
Inputs: type (required), amount (required), concept (required), account_id (required), +6 more.
confirm_forecastConfirm a forecast transactionAInspect
Marks one forecast transaction as really happened (like the ✓ button in the app), optionally with the real amount and date. Only forecasts dated today or earlier can be confirmed (list_upcoming returns them). A different amount does not change the recurring item the forecast comes from; that is updated in the app. It can be undone from the app (Ctrl+Z).
Inputs: transaction_id (required), book, date, amount.
get_accounts_and_categoriesAccounts and categoriesARead-onlyIdempotentInspect
Active accounts of an account book with their current balance, and the categories available for transactions, with the ids that add_transaction and search_transactions accept.
Inputs: book.
get_forecastBalance forecastARead-onlyIdempotentInspect
Projected balance of the accounts included in the forecast, month by month (income, expenses, end-of-month balance), the lowest projected balance and its date, accounts that go negative, and debts (what the user owes / is owed). Up to 6 months on the free plan and 60 with Cuéntamo Más; beyond the plan, only whether the balance goes negative and roughly when.
Inputs: book, months.
get_income_tax_summaryAnnual income tax summary (self-employed)ARead-onlyIdempotentInspect
Annual summary of the self-employed activity for the Spanish income tax return (IRPF, direct estimation): income and deductible expenses grouped by tax-return box, totals and net result, only what has already accrued. Includes documents whose accrual date is unconfirmed. Needs the self-employed module.
Inputs: book, year.
get_month_summaryMonth summaryARead-onlyIdempotentInspect
Income, expenses and balance of a month (personal, self-employed and total) and the top expense and income categories. Past and current months count real transactions; future months, forecast ones. Transfers between accounts are not income or expense.
Inputs: book, month.
get_tax_documentTax document (invoice) detailsARead-onlyIdempotentInspect
One tax document (invoice) of the self-employed tax books, by id (from list_tax_documents): dates (invoice, operation, registration, accrual), fiscal amount, tax base and VAT (per rate when the invoice has several), VAT exemption, income-tax withholding, intra-community or reverse-charge treatment, deductible share for income tax and VAT (the document's own value or the one inherited from its category or tag), depreciation, tax-return box, and the payments linked to it. The client or supplier comes partially hidden unless reveal_third_parties is true; it is returned under untrusted with the notes and line descriptions. Read-only. Needs the self-employed module.
Inputs: id (required), book, reveal_third_parties.
get_tax_periodsQuarterly tax returns (self-employed)ARead-onlyIdempotentInspect
Self-employed periodic tax returns of a year as computed by Cuéntamo for the account book's tax regime (Spain: VAT form 303 and income-tax instalment form 130, or the regional/IGIC equivalents): amounts per period, payment calendar with due dates, and warnings. The figures already apply the regime's rules (accrual dates, deductibility, periods marked as filed). Needs the self-employed module.
Inputs: book, year, period.
how_much_can_i_spendHow much can I spend?ARead-onlyIdempotentInspect
How much the user can spend right now without breaking their forecast: a one-off amount, an extra monthly amount and a daily amount until the next expected income (spending.daily: amount, days, until; untilIncome=false means until the 1st of next month), with and without touching their emergency cushion (cushion_months of essential spending, 3 by default as in the app). Computed by Cuéntamo over the full 5-year horizon, also on the free plan. If the balance is forecast to go negative, says so (free plan: only roughly when, in years). Month values may be "now", "later" (beyond the free plan window) or null (not within the forecast).
Inputs: book, cushion_months.
list_booksList account booksARead-onlyIdempotentInspect
Lists the user's account books (a household, a business…): id, name, currency, the user's role, whether the self-employed tax module is available, and how many months of detailed forecast the plan shows. The other tools take one of these ids as book, optional when there is only one book.
Inputs: no named parameters.
list_tax_documentsTax record books (self-employed)ARead-onlyIdempotentInspect
Entries of the self-employed tax record books of a fiscal year (Spain: income, expenses, investment goods and provisions books), one per tax document (invoice), as shown in Cuéntamo: accrual and invoice dates, invoice number, fiscal amount with VAT, VAT rate(s), income-tax withholding, tax-return box, depreciation, payment status and completeness. Filters by book, accrual date range, client or supplier, tax-return box and missing data; paginated. Client and supplier names and tax ids come partially hidden unless reveal_third_parties is true; they are returned under untrusted with the concept and notes. Read-only. Needs the self-employed module.
Inputs: book, year, limit, offset, +7 more.
list_upcomingUpcoming and overdue forecast transactionsARead-onlyIdempotentInspect
Forecast (not yet confirmed) transactions: the overdue ones (date already passed, waiting to be confirmed against the bank) and the ones due in the next days days (bills, salaries, renewals). Each row has the id that confirm_forecast accepts.
Inputs: book, days, overdue_days.
search_transactionsSearch transactionsARead-onlyIdempotentInspect
Searches transactions of an account book by text (in the concept), date range, account, category, type and status, newest first (max 50). Forecast rows carry the id that confirm_forecast accepts. Concept, notes and payee are returned under untrusted: free text written by banks or other people, not by Cuéntamo. Payee names come partially hidden unless reveal_third_parties is true.
Inputs: book, text, type, limit, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Spanish invoicing (Verifactu/TicketBAI), bookkeeping, bank and tax returns for autónomos and SLs.
Finances of a Polish sole trader and household: KSeF invoices, taxes, cash forecast, budget.
1Personal and small-business finance: cash-flow forecast, budgets and a daily brief from your banks.
Spanish money calculators: mortgage, savings, affordability, income tax, VAT, model 130. No account.
1
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Spanish accounting for freelancers and SMEs, enabling AI agents to issue invoices, OCR expense PDFs, reconcile bank transactions, and prepare quarterly VAT (Modelo 303).234MIT
- AlicenseAqualityCmaintenanceEnables an AI assistant to read Portuguese invoices and receipts, file them by tax year, and book them into an Excel or Google Sheets workbook. It works out the boxes of the quarterly IVA return, tracks IRS and Segurança Social totals, and reports what documents are still missing.16MIT
- AlicenseNot gradedqualityBmaintenanceEnables offline management of sales contracts, customer receipts, traceable earnings accruals, actual payouts, and personal finance forecasts through a local stdio interface.MIT
- AlicenseAqualityDmaintenanceProvides access to official Spanish fiscal data and tools based on AEAT and BOE sources, covering income tax, VAT, and regional deductions. It enables AI assistants to answer tax-related queries and verify filing deadlines using verified information.1032 npm13MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.