MCP App Store
by KeenEthics
Saldin icon

Saldin MCP Server for ChatGPT

By Pedro Dias

Overview

Connect your Saldin account to understand balances, spending, card bills, installments, budgets, goals and cash-flow projections. With the permissions you choose, Saldin can also record or update supported financial records. Saldin never initiates bank transfers or payments, and you can revoke access at any time.

How to connect

  1. ChatGPT: Open the Saldin listing in the ChatGPT app directory and choose Connect. ChatGPT listing Saldin exposes 80 tools here.

Tools

add_goal_contribution

ChatGPT
Record money set aside for a goal tracked by contributions (negative to withdraw). It neither moves money between accounts nor counts as an expense.

adjust_tax_line

ChatGPT
Correct how one note (sourceKind invoice) or receipt (sourceKind receipt) counts as revenue: include or exclude it, its market (domestic or export), activity, amount in BRL or month. With clearId the correction is removed.

anticipate_installments

ChatGPT
Record that future installments of a card purchase were paid off early at the amount the bank quoted. The payoff becomes one charge on the target bill and the selected installments leave their bills; paying the target bill is a separate pay_card_bill.

confirm_invoice_issuance

ChatGPT
Legally issue the reviewed draft. Call only after the person explicitly approves the exact draft and environment. Supply its id and version. Replayed or changed drafts are refused.

confirm_tax_assessment

ChatGPT
Confirm the DAS of a month. Without amount it takes the estimate, plus late charges when overdue. It creates a pending expense on accountId (or the profile's payment account) due on dueDate, updates that expense on a revision, adds a supplementary expense when the first one was already paid, or links transactionId, an expense already recorded as the payment. Pass baseRevision from get_tax_period to avoid overwriting a newer revision.

confirm_transaction

ChatGPT
Mark a pending expense paid, expected income received, or a pending card charge confirmed. For a recurring occurrence it confirms only that occurrence.

create_category

ChatGPT
Create a category or, with parentId, a subcategory (one level). Check list_categories first to avoid duplicates.

create_goal

ChatGPT
Create a savings goal. progressMethod contributions tracks amounts recorded with add_goal_contribution; account_balance tracks the balance of accountId, which is then required.

create_invoice

ChatGPT
Record an invoice the business issued without its XML file. Prefer import_invoices when the person has the file. The customer is a saved customer (customerId from list_issuing_customers) or just a name; never ask for a customer's CPF, CNPJ or other identifier here.

create_invoice_upload

ChatGPT
Create a single-use link, valid for 15 minutes, to upload NF-e or NFS-e XML files from the person's computer for one persona: POST them as multipart form fields named files (curl -F 'files=@path' once per file, up to 200 files and 24 MB). The upload is kept for 24 hours; pass the returned uploadId to preview_invoice_import and import_invoices instead of the files.

create_monitor

ChatGPT
Have Saldin watch something and notify the person on their iPhone when it happens, checked every few minutes between 9:00 and 22:00 in their time zone without AI, so there is no need to poll. Kinds: category_spending (the month's spending in categoryId, a category or subcategory, reaches amount; once a month), balance_below (accountId's balance falls below amount; at most every 72 hours), large_expense (each new expense or card charge of at least amount, imports excluded), budget_overrun (committed spending, actual plus pending on the due-month basis, reaches percent of the persona's overall monthly budget, then the limit itself, for the current month and with includeNextMonth the next one; once per month and step; needs an overall budget from set_budget), projected_balance_below (the persona's projected balance in currency, the app's Home projection with pending income, pending expenses and card bills, goes below amount on any day from today through the end of the current month, the projection's horizon; amount may be zero or negative, such as -2000.00 for an overdraft limit; at most every 72 hours). Amounts are in the persona's currency, the account's for balance_below. There is one monitor per kind and target (category, account or currency); creating one that exists adjusts it and keeps it paused if it was, and creating one that was removed brings it back. At most 10 are active.

create_recurrence

ChatGPT
Create recurring income, expense or card charge: accountId for income and expense, cardId for card_charge. For a card charge billed from another currency, original is the amount and currency charged by the merchant; Saldin estimates amount in the card currency from the latest BCB PTAX closing sell quote until each occurrence is confirmed with its actual billed amount. Occurrences appear as pending transactions until confirmed. End it with endDate or count, or neither for an open-ended recurrence.

delete_budget

ChatGPT
Remove a budget limit (ids from list_budgets). A month-specific budget is removed. A recurring plan line stops from fromMonth (default: the current month) on, and earlier months keep it. Requires the delete scope.

delete_invoice

ChatGPT
Delete an invoice recorded by mistake, with its receipt links. Needs the delete scope.

delete_monitor

ChatGPT
Remove a monitor: it stops notifying, leaves the app's list, and Saldin's analyses never create it again. To stop it for a while, pause it with update_monitor instead. Requires the delete scope.

delete_transaction

ChatGPT
Delete a transaction and its linked entries: both sides of a transfer, or every installment of a purchase (pass any installment's id). Related transactions stay; delete each one separately when the person asks. A recurring occurrence needs recurrenceScope: this_occurrence removes only that one, this_and_future also ends the recurrence from there. Requires the delete scope.

end_recurrence

ChatGPT
End a recurrence from a date: removes the occurrence on from and every later one, keeping earlier occurrences. A recurrence with a set count keeps it, so occurrences stay numbered out of the original total (for example after paying the last installments in advance). Requires the delete scope.

find_matching_transactions

ChatGPT
Transactions with exactly this amount within some days of a date, across every persona unless scope is given, pending ones included, nearest first with daysFromDate. Use it before recording something a bank reported, to find the same movement already recorded (also as the other side of a transfer or as a pending item to confirm) instead of searching by hand.

get_budget_status

ChatGPT
Monthly budget limits, spending, pending commitments and remaining amounts for one persona in its default currency. Spending in other currencies is estimated with the latest BCB PTAX closing sell quote; estimate names the source, date and currencies left out. source says whether the month's own plan or the recurring plan applied.

get_card_bills

ChatGPT
Bills of one card, oldest first. Each bill has dueMonth (the billDueMonth other tools take), closingDate, dueDate, state (open, closed, partially_paid, paid or overdue), charges, credits, payments, carriedIn (unpaid balance brought from earlier bills), outstanding (what is left to pay) and pendingForecast (pending charges, not owed yet). With fromMonth it returns exactly the bills due from that month through toMonth; without fromMonth it starts twelve months ago and also includes any older bill that still has an outstanding amount.

get_cashflow_projection

ChatGPT
Day-by-day projection of one persona's cash in one currency from today through a date up to 400 days ahead, with the lowest point. It starts from the current balance of the accounts counted in totals (or includeAccountIds) and applies, in date order: pending income and expenses on those accounts (source pending_entry, or recurrence for recurrence occurrences), each card bill on its due date for what is left to pay plus its pending charges (card_bill; a balance carried in from an overdue bill is counted once, on the overdue bill), and the hypotheticals passed in (hypothetical), which are never stored. Overdue pending items and bills land on today. Events on one day list money coming in first, and balanceAfter is the running balance; lowest and floor use each day's closing balance, and lowest also considers today's starting balance. Recurrence occurrences exist through recurrencesGeneratedThrough (about twelve months ahead); later ones are not in the projection. Amounts are signed decimal strings: negative leaves the accounts.

get_directory

ChatGPT
Everything needed to resolve ids in one call: personas (with default currency), accounts and cards (closing and due days) with their persona, the category tree (parentId marks a subcategory, flow is expense or income) and tags. Call it once at the start instead of list_personas, list_accounts, list_cards, list_categories and list_tags; balances and bills are in get_overview and list_cards.

get_exchange_rates

ChatGPT
The latest PTAX selling rate of USD, EUR, GBP, CAD, AUD, CHF and JPY in reais per unit, published by the Banco Central do Brasil once per business day, with the date it closed. Use it to estimate conversions and say it is an estimate with the rate's date; never change a stored amount with it.

get_invoice

ChatGPT
One invoice with its parties, amounts, retentions and the receipts linked to it.

get_invoice_issuance_guide

ChatGPT
Read the curated versioned NFS-e guide before answering general or Saldin setup questions. Topics: index, basics, setup, certificate, service, export, customers, lifecycle, errors, limits. Choose export for export options, errors for save failures/rejections and setup for checklists; request independent topics together. No personal data or tax advice. Use the person's language.

get_invoice_overview

ChatGPT
For a persona and date range: invoices by competence date with what was received and is still open, and the receipts in BRL that still wait for an invoice (income in sales categories and reais credited by a currency exchange, minus what is linked or marked as needing no invoice).

get_issuing_profile

ChatGPT
Read the confirmed provider and reusable services for a business persona.

get_issuing_setup_status

ChatGPT
Read the business persona's setup readiness, missing codes and plain next steps. Uses cached municipal eligibility only, never refreshes it or accesses certificate secrets. Defaults competence to today and environment to this server's environment. Read before answering about the person's setup.

get_monthly_report

ChatGPT
Income and expense totals plus category breakdown for a month. Native amounts remain per currency; approximateTotals and each foreign category approximate use the persona default currency and the latest BCB PTAX closing sell quote, with source, date and missing currencies. basis "due_month" (default, how the app plans) counts card charges in the month their bill is due; "purchase_date" counts them in the month they were bought. Use the default unless the person asks about when purchases were made, and say which basis the answer uses. With scope "all" (the default) it returns one report per persona in personas and adds nothing across personas.

get_overview

ChatGPT
Current balance, projected month-end balance, this month's income and expenses (actual and pending, card charges counted in their bill's due month), every account with its balance, every card with its current and open bills, upcoming payments and goals, so list_accounts and list_cards are not needed after it. Balances in several currencies also get approximateTotal in the persona's default currency at the latest PTAX rate. asOf is today's date in the person's time zone. With a persona id it returns that persona; with scope "all" (the default) it returns one such section per persona in personas, plus the next upcoming items of every persona, and adds nothing across personas.

get_tax_overview

ChatGPT
A business persona's tax profile, activities, history overrides and payroll, plus every month from trackedFrom with its status and full DAS estimate, computed now from the current records. Filter with year.

get_tax_period

ChatGPT
One month's DAS estimate with every revenue line (included or excluded and why), the tax per segment, the due date and late charges, the assessments confirmed for it (revisions) and the tax expenses that could be its payment.

get_transaction

ChatGPT
One transaction with its version, its operation, the operation's linked entries (both transfer sides, every installment), related refunds and anticipation charges, relatedTransactions (other transactions related to it, such as the other side of a payment between personas) and attached receipts.

get_transfer_history

ChatGPT
How earlier movements between two accounts were recorded, newest first: transfers between them, and pairs of related transactions such as a withdrawal from a business account recorded as an expense there and an income in the personal account. Each item lists both sides with their kind, description and category. Use it to record a new movement between the same accounts the same way.

import_invoices

ChatGPT
Save the new documents in NF-e or NFS-e XML files and apply status changes, linking each new invoice to its preselected receipts (exact, explained or close). Invoices with only an approximate match or none are saved without links and listed in unmatched; link them with link_invoice once the person confirms.

list_accounts

ChatGPT
Bank, wallet and cash accounts with their current balance in their own currency.

list_budgets

ChatGPT
Stored budget limits: month-specific ones, and the recurring plan as one row per line and starting month, with fromMonth and untilMonth.

list_cards

ChatGPT
Credit cards with limit, credit used (including future installments) and available credit, plus two bills: currentBill, the next bill to pay (the first one not yet due and not paid), and openBill, the bill new purchases go on now. To pay a bill in full, pay its outstanding.

list_categories

ChatGPT
Category tree (one subcategory level) per persona, each with its flow (expense or income). Use ids when recording transactions and budgets.

list_goals

ChatGPT
Savings goals with native progress and, when the goal uses another currency, approximate target and progress in the persona's default currency with the latest BCB PTAX source and date.

list_invoice_issuances

ChatGPT
Read recent drafts and issued notes, provider rejection codes, bilingual guidance, cancellation and DANFSE states. Results are newest first. Only use returned note links.

list_invoices

ChatGPT
Invoices by competence date (the fiscal reference period), each with its net amount, how much of it is linked to receipts and what is still open.

list_issuing_customers

ChatGPT
Read a business persona's saved customers and confirmed last-note defaults.

list_monitors

ChatGPT
Monitors that send the person push notifications from the Saldin app: kind, params (thresholds as decimal strings and their currency), title, status (active or paused; removed ones only with includeRemoved), createdBy (ai for Saldin's own analyses, person for the person or an agent acting for them) and lastTriggeredAt.

list_personas

ChatGPT
Personal and business personas this connection can access.

list_recurrences

ChatGPT
Recurring income, expenses and card charges, one entry per series with its current terms; its id is what stop_recurrence and end_recurrence take. To find an occurrence, search_transactions by description and date. Editing an occurrence with this_and_future starts a new revision of the series.

list_tags

ChatGPT
Tags per persona.

pay_card_bill

ChatGPT
Record in Saldin that a full, partial or advance card-bill payment was made. This never sends money, contacts the card issuer or initiates a bank transaction. It updates the Saldin ledger by reducing the paying account balance and the card debt without creating another expense. For a full payment, use the outstanding amount from list_cards or get_card_bills.

prepare_invoice_issuance

ChatGPT
Prepare a fiscal draft without submitting it, for a customer already saved in Saldin (customerId from list_issuing_customers). New customers are added only in the Saldin app; never ask for a customer's CPF, CNPJ or other identifier here. For a customer who is not saved yet, give the person a link that opens the app's customer form prefilled: https://saldin.app.br/open/customer# followed by URL-encoded key=value pairs joined with &, using only name, email, phone, country (ISO code), address, street, number, complement, district, postalCode, municipality (IBGE code), city, region and personaId; the person completes and saves it in the app, then call list_issuing_customers again. Refreshes municipal eligibility through the certificate custody worker when needed. Show every returned value and environment to the person. A separate explicit approval is required before confirm_invoice_issuance.

preview_invoice_import

ChatGPT
Read NF-e or NFS-e XML files for a persona without saving anything. Each document comes back as new, duplicate, status_changed (cancelled or replaced since it was imported), received (issued to this business, not by it, which is not supported) or invalid, with the receipts it most likely pays: confidence exact, explained (the difference equals a fee charged the same day on the same account), close (within R$ 1) or approximate (within 1%, not preselected).

record_balance_adjustment

ChatGPT
Correct an account or card balance with a dated adjustment that is excluded from income and expense totals. Give exactly one of accountId or cardId. amount is the signed difference, not the new balance: for an account, positive raises the balance; for a card, positive raises the amount owed. To reach a target balance, subtract the current balance (list_accounts) from it. When the difference is real money, such as savings yield (rendimento) or a bank fee, give categoryId with accountId: the difference is then recorded as a confirmed income when positive or an expense when negative, in that category, instead of an adjustment. The category must belong to the account's persona and match that flow, and description defaults to the category name.

record_card_bill_payment

ChatGPT
Record in Saldin that a full, partial or advance card-bill payment was made. This never sends money, contacts the card issuer or initiates a bank transaction. It updates the Saldin ledger by reducing the paying account balance and the card debt without creating another expense. For a full payment, use the outstanding amount from list_cards or get_card_bills.

record_card_purchase

ChatGPT
Record a credit-card purchase on its purchase date; Saldin assigns the bill from the card's closing date. installments splits the total across consecutive bills, the first carrying any remainder cent, and the full amount reserves credit immediately. status defaults to confirmed; pending records a charge that is not confirmed yet. For a foreign-currency purchase, amount is what the card billed and original what was spent abroad.

record_income_or_expense

ChatGPT
Record money received into or paid from a bank, wallet or cash account; for a credit card use record_card_purchase. status "confirmed" (default) means it happened; "pending" means it is expected and not yet paid or received.

record_installment_anticipation

ChatGPT
Record in Saldin that future installments of a card purchase were paid off early at the amount the bank quoted. This never requests an anticipation from the issuer or sends money. The recorded payoff becomes one charge on the target bill and the selected installments leave their bills; recording the target bill payment is a separate record_card_bill_payment call.

record_refund

ChatGPT
Record a partial or full refund of an expense or card purchase. With originalTransactionId (any installment of a purchase) it links to the purchase and takes its card or account and category; give cardId or accountId only when the money came back somewhere else. A card refund credits the card's open bill. It reduces spending in the month received.

record_transfer

ChatGPT
Move money between two accounts; to pay a card bill use pay_card_bill. status defaults to confirmed. For different currencies give destinationAmount. Fees are line items, each in its own currency: with feeMode gross, amount and destinationAmount are before the fees, the transfer moves exactly those amounts and each fee becomes its own expense, named by its label, on the account that holds its currency; with net, both amounts are already the actual movements and the fees are only itemized. Between accounts of different personas it records two independent, related transactions instead of a transfer: an expense in the source persona classified with fromCategoryId (an expense category there, for example pró-labore or dividends) and an income in the destination persona classified with toCategoryId. That needs both persona grants and takes no fees (record a fee as its own expense and relate it), and each side is then edited or deleted on its own.

relate_transactions

ChatGPT
Mark two transactions as related, for example the USD sent for a dollar sale and the BRL received for it, or the two sides of a payment between personas recorded separately. Groups merge when either already has related transactions. Amounts, dates and categories do not change. Needs write access to both personas.

reopen_tax_assessment

ChatGPT
Undo the confirmed DAS of a month that is not paid: the pending expense Saldin created is deleted (needs the delete scope) and the month returns to its estimate. The assessment history is kept.

save_tax_activity

ChatGPT
Without id, add an activity to a business persona; with id, change or archive it. anexo is I to V, or fator_r for services that move between Anexos III and V by payroll. segregation covers the mixed activities of Res. CGSN 140 art. 25 par. 1 (rental of movable goods, IPI and ISS, interstate transport, accounting office with fixed ISS, and from 2027 goods without ICMS or services without ISS). issReduction is a municipal reduction as a fraction (0.5); fixedIss is a monthly fixed ISS under art. 33.

search_transactions

ChatGPT
Transactions matching optional text and filters, over all dates unless from or to is given, newest first, 50 per page by default; pass nextCursor as cursor for the next page instead of raising limit. Each installment of a card purchase and each recurrence occurrence is its own row, with its id, version (enough for update_transaction, no need to read it again), status and the names of its category, account or card and tags. For a merchant's usual category use suggest_classification, for a movement already recorded find_matching_transactions, and for totals summarize_transactions.

set_bill_closing_date

ChatGPT
Correct when one card bill closes, for a month the bank closes it earlier or later than the card's usual day. Each bill's current closingDate is in list_cards and get_card_bills: the first purchase date that goes to the next bill. The new date must be within 10 days of the usual one, after the previous bill's closing date and no later than the due date; null restores the usual day. Purchases already recorded keep their bills.

set_bill_due_date

ChatGPT
Correct when one card bill falls due, for a month the bank moves it from the card's usual day (a weekend or holiday, for example). Each bill's current dueDate is in list_cards and get_card_bills. The new date must be within 10 days of the usual one, on or after the bill's closing date, after the previous bill's due date and before the next one's; null restores the usual day. It never changes which charges the bill holds.

set_budget

ChatGPT
Set an overall (no categoryId) or category budget; setting one that exists replaces its amount. month YYYY-MM sets that month only. Omit month for the recurring monthly plan, which applies from fromMonth (default: the current month) on and replaces any later change to the same line; months before fromMonth keep the plan they had. A month with any month-specific budget uses only its month budgets, so add every category that month needs; get_budget_status reports the plan it used as source.

set_tax_payroll

ChatGPT
Record the payroll paid in each month (pró-labore, salaries, 13th salary, CPP and FGTS), which fator r divides by revenue. Pass several months at once; with clear true the given months are removed.

set_tax_profile

ChatGPT
Create or change a business persona's tax profile: regime (simples or mei), CNPJ opening date, first month in the Simples, first month to estimate (trackedFrom), municipality (IBGE code), cash basis (until 12/2026), revenue basis, IBS/CBS outside the Simples (2027 on), MEI activity, default activity and the account that pays the DAS. Creating a Simples profile needs activity, the main activity with its anexo or fator_r.

set_tax_revenue_month

ChatGPT
Replace the revenue Saldin derives for a month with the declared amounts, split into domestic and export, for months before the records start or to match the PGDAS-D. 0.00 and 0.00 confirms a month without revenue. With clear true the override is removed.

show_budget_status

ChatGPT
Render the overall and category budget status for one persona and month.

show_card_bills

ChatGPT
Render a credit card's bills, due dates, outstanding amounts and payment state.

show_cashflow_projection

ChatGPT
Render a persona's cash projection through a date up to 400 days ahead, including its lowest point and optional floor.

show_financial_overview

ChatGPT
Render current and projected balances, this month's flows, accounts, cards, upcoming items and goals for one persona or all granted personas.

show_monthly_report

ChatGPT
Render one month's income, expenses, categories and commitments for one persona or all granted personas.

stop_recurrence

ChatGPT
End a recurrence now: removes every pending occurrence dated today or later and keeps confirmed ones. To keep occurrences until a later date, use end_recurrence. Requires the delete scope.

suggest_classification

ChatGPT
How a merchant or description was categorized before, as ranked candidates with their category and subcategory names, how many times each was used, how many on the given card or account and with the given amount, the last use and its descriptions and tags. matchQuality says how the text matched: exact (same merchant or description), contains (the text appears as words) or fuzzy (only similar words, so check it really is the same place before trusting it). Use it instead of searching the merchant's history.

summarize_transactions

ChatGPT
Totals of the transactions matching the search_transactions filters, optionally grouped, so totals never need to be added up from rows: spending by category, tag, merchant, card or account, spending per day, or a trend across months in one call. Each persona is its own section in personas (one section when scope is a persona id) and every total is per currency: nothing is added across personas or currencies. totals covers the whole section; with groupBy, groups lists each key with a label and its own totals. income, expense, net (income minus expense) and count cover confirmed transactions; pending has the same figures for pending ones (expected income, pending expenses, future recurrence occurrences). Income and expense follow get_monthly_report: refunds reduce expense, and transfers, card payments and balance adjustments are counted in count but are neither income nor expense. Tag grouping counts a transaction under each of its tags, so tag groups can add up to more than totals, which counts it once; key null holds untagged transactions, and likewise transactions without a category, merchant, card or account. merchant groups by merchant, or by description when there is none, ignoring case and accents. day and month groups run oldest first, the others largest first; each section lists at most 200 groups, with groupCount and truncated telling whether there were more. basis (default "due_month", how the app plans) decides the month of a card charge for month grouping and for fromMonth and toMonth: "due_month" uses the month its bill is due, "purchase_date" the month it was bought. day grouping and from and to always use the transaction date (the purchase date for card charges), like search_transactions. To match get_monthly_report for a month, pass it as fromMonth and toMonth with the same basis. Say which basis an answer uses.

unconfirm_transaction

ChatGPT
Return a confirmed transaction to pending (expected, not yet paid or received); pending entries do not count in current balances.

unrelate_transaction

ChatGPT
Take a transaction out of its related group. Neither it nor the others change otherwise.

update_invoice

ChatGPT
Mark an invoice cancelled (its receipt links are removed) or issued again, or change its notes.

update_monitor

ChatGPT
Pause or resume a monitor (status), or change its title or threshold (amount, percent, includeNextMonth). Its kind and target stay the same; to watch something else, create another monitor. A removed monitor cannot be updated.

update_transaction

ChatGPT
Change fields of a transaction; send only the fields that change (a field equal to its current value is ignored). The answer lists the fields that changed and the transaction with every linked row after the change. Pass the version from search_transactions or get_transaction as baseVersion; a conflicting change returns version_conflict with both values. Linked records change together: both transfer sides, every installment of a purchase. For a card purchase pass any installment's id: amount is the new purchase total split again across its installments, installmentAmount changes only this installment (to match the bank's cents) and the total becomes the sum of the installments, firstBillDueMonth moves the whole purchase so its first installment lands on that bill and the others follow, billDueMonth moves only this charge, and installments changes the count. A recurring occurrence needs recurrenceScope; use this_and_future on the occurrence where a change starts.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/saldin"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/saldin)