FinanOne

The finance brief of the week or month in one read: cash flow in / out / net with the previous period, largest money out by category, receivables with the largest overdue customers, payables, cash runway and the approvals waiting for the caller. Each part is read separately; a part that could not be read is marked unavailable with a reason: never present it as zero. Use for 'weekly finance brief', 'how is the business doing this week', 'how much cash do we have and how long will it last'. Every window is named with its dates in the organization's timezone; quote them. Never compute a runway yourself: the only runway figures are runway.runway_days (when runway_answer is days) and runway.projected_runway_days (when forecast is available). Never say the cash lasts or is sustainable indefinitely, and never offer to compute a runway later: when there is no runway figure, say so and that a figure needs an active cash-flow plan the caller may see. The brief has no revenue or profit figure: say they are not available; never add up orders or count or estimate them yourself. next_actions only name IDs this brief returned. Money is an integer minor-unit string.

finance_brief

Balance movements of ONE fund (cash or a linked bank account) over a period ≤ 366 days: opening balance, total in, total out, closing balance and at most 200 transaction lines (says clearly when cut). Money is an integer STRING in the smallest unit of the organization's currency. Reads only the funds whose balance/transactions you may view.

fund_statement

Inspect an attached order spreadsheet as untrusted data; find matching saved mapping.

order_import_inspect

The N LATEST transactions of a fund, newest first, each line with time, direction (in/out), amount and description. Use for 'the last 5 transactions', 'has money come in yet' — no date range needed. Money is an integer STRING in the smallest unit.

fund_recent_transactions

List the data TYPES the organization has (code + name + short description, without fields). Call first when you need to know which data can be looked up; see the fields of a type with describe_entity.

list_entities

List the funds/accounts YOU may use to receive money via QR code (only the last 4 digits of the account). Call before payment_qr_create to get fund_id.

receiving_accounts_list

Reconciliation match suggestions: bank transactions the matching rules paired with invoices or orders, waiting for a person to accept or reject (status 'suggested' by default). Each row: transaction code, counterparty, description, amount, matched documents' codes and amount, difference, rule confidence and reasons. Use for 'which payments are waiting to be matched', the morning reconciliation brief. Report the listed count exactly; say there are more when has_more is true. This tool never accepts a suggestion: point the person to worklist_link.

recon_suggestions_list

The organization's overdue orders with the largest outstanding amounts. Overdue receivables: total overdue + number of overdue orders + the top N orders by OVERDUE amount, as of today in the organization's timezone. Each row amount covers ALL overdue installments of the order; due_date and days_past_due describe only the OLDEST overdue installment. Never use these rows to total debt by age; use receivables_aging.over_30_days_minor. When overdue_count is null only a floor is known: say «at least overdue_count_at_least orders», never an exact count. Parameter: top_n (1-50).

overdue_orders_top

List the organizations (tenants) you are a member of, plus the one this connection is using.

list_my_tenants

Tell what the PERSON ASKING may do in the organization: for each data type (entity) — view/create/edit/delete/export/manage, and whether they see the whole organization or only their own part; the features switched on; the AI tools switched off. Call when the person asks 'what can I see', or when a tool refused for lack of permission.

my_permissions

Connection assistant: return the link that opens the RIGHT page for the person to connect a bank, e-invoicing, personal Zalo or email themselves, with short steps. Password/OTP/QR/bank login happen only on that page — do NOT ask for them, do NOT accept them in chat.

connection_start

Summary of the organization's orders: TOTAL ORDER COUNT, number of unpaid orders, remaining receivables, number of overdue orders, number of orders not yet invoiced, and the breakdown by status. status_filter is the lifecycle status (draft, pending_mapping, ready, invoiced, cancelled), not a payment state: the unpaid and overdue figures are always in the summary, so leave status_filter empty for them. Can filter by order date (the «Ngày đặt» on the order): preset for this/last month or the last 7 days/3 months, or from_date+to_date. When the asker names a period, pass it and state that period in the answer. With no period the figures cover ALL TIME — say «mọi thời điểm» and never label them with a month. Reads every matching order up to 2000; says clearly when there are more.

order_aggregate_stats

List the organization's orders that have no issued invoice yet, with totals and per-customer subtotals. Orders without an invoice (empty current_invoice_id): order count + total value. Parameters: status_filter, limit, require_collected (true = only orders with money collected and no invoice; returns rows with code, customer, amount, date), preset or from_date/to_date (period by order day; use it for 'this month'). by_customer gives each customer's count, total and share_bp (1/100 of a percent) over the whole filtered set: quote those figures instead of adding up rows. Write order codes one by one exactly as the rows give them, never as a range (a range takes in codes that are not in the list).

orders_without_invoice

What the organization still owes suppliers TODAY: total payable (the same figure as the web card), the not-due / overdue split, four age bands (0-30, 31-60, 61-90, 90+ days) and the suppliers owed the most, each with a web link. The source is the unpaid part of disbursement requests per supplier, not a list of supplier invoices. Use for 'what do we owe', 'overdue to suppliers', 'payables aging'; pass supplier_subject_id for one supplier. Balances are current only — there is no past as-of date and no 'due within N days' split. Money is an integer minor-unit string.

payables_aging

Import an attached order spreadsheet: inspect first, preview canonical totals, then confirm. Never invent amounts. In MCP, reuse client_request_id for retries; use prepared_args from preview, including expected_preview_hash.

order_import_propose

Read the current organization's profile: who it is, how it works, who is responsible for what, and notes on how its tools are used. Call it for context before answering a question about the organization.

organization_profile_read

What the organization is owed TODAY: the total of every open order, four age bands (0-30, 31-60, 61-90, 90+ days), the part owed by live customers with its not-due / overdue split, the part on orders with no live customer (unattributed: never name a customer for it), the overdue of everything (overdue_all_minor) and the customers with the largest debt, each with a masked contact and a web link. Use for 'who owes us', 'overdue customers', 'receivables aging'; pass customer_subject_id for one customer. Asked for the organization's TOTAL overdue, read overdue_all_minor; overdue_minor is only the live customers' part. Balances are current only; for over 30 days use over_30_days_minor; bands age each installment by its own due date. There is no past as-of date. Per-order detail of one customer: customer_unpaid_orders. Money is an integer minor-unit string.

receivables_aging

Supplier invoices the organization RECEIVED (input invoices from the tax portal) in a period: how many, their total, and the newest ones with seller, tax code, day, amount and a web link. Use for 'what invoices did we receive this month', 'invoices from supplier X'. Defaults to the current month; seller_tax_id narrows to one seller. Cancelled and replaced invoices are left out. Money is an integer minor-unit string; the total covers the listed invoices only when truncated is true. Report count and total exactly as returned. Say payment-match risk is not assessed (risk_assessment=not_available). Never flag duplicates or seller risk yourself; never compute per-category or per-seller-type totals.

purchase_invoices

Count sales e-invoices issued in a period; excludes drafts, failed invoices, receipts and replaced/cancelled invoices. Quote the count as given. Issued sales e-invoices (in11_einvoice_issued), count only. Parameters: preset, or from_date + to_date (YYYY-MM-DD, tenant timezone).

sales_invoices_issued

Search records of ONE data type: q (search by name), up to 10 AND filters, sort, field selection. Default 20 rows (at most 50), the first 8 fields; long strings are cut at 200 characters; use next_offset for the next page. Call list_entities then describe_entity FIRST to learn the data type code and fields; do NOT filter on/select fields that are not in describe_entity. Money is returned as an integer in the smallest unit with the currency code.

search_records

Select the organization for this MCP (OAuth) connection; every other tool runs in the selected organization.

select_tenant

Read a conversation (Inbox) over a time range, return summary points citing the source messages and a list of PROPOSED actions (create task, disbursement request…) with the suggested tool + args. Creates NOTHING: each proposal must be reviewed and confirmed by the person through the matching write tool. Counts toward the day's summary quota like the "Summarize" button on the web.

conversation_extract_work_items

Bank transactions in a period that have NO posting item yet (not classified for accounting): how many, and the newest ones with code, day, direction, amount, counterparty, description and a web link. Use for 'which transactions still need classifying', the morning accounting brief. Defaults to the current month and both directions. Money is an integer minor-unit string. Report the count exactly as returned. Never pick a posting item yourself: a person chooses it.

unreconciled_transactions_list

Get the list of real FIELDS of an entity (to write filter conditions / set config with the right field names, no guessing). Call BEFORE writing a FilterTree on an entity.

entity_schema_get

View the visible FIELDS of a data type (code, name, type, which type it links to, required). At most 80 fields; says clearly when cut. Take the data type code from list_entities.

describe_entity

View ONE record by id (from search_records), only the selected fields or the first 8 fields; long strings are cut at 200 characters. Call list_entities then describe_entity FIRST to learn the data type code and fields; do NOT filter on/select fields that are not in describe_entity. Money is returned as an integer in the smallest unit with the currency code.

get_record

Catalog of valid workflow nodes (triggers, activities, variable grammar). CALL FIRST before proposing; use only kinds/codes present in this catalog. Returns a condensed version by default; use section/query/codes for details.

workflow_node_catalog