Say what happened
Describe an expense, income, transfer, balance question, or reconciliation task in everyday language.
EzFin turns natural-language requests into a reliable financial ledger—then lets your favorite AI client safely read, record, and reconcile through MCP.
One remote server · any compatible MCP client
AI helps understand your intent. EzFin’s application layer validates the facts, protects workspace boundaries, and performs the accounting.
Describe an expense, income, transfer, balance question, or reconciliation task in everyday language.
EzFin resolves accounts and categories, asks when something is ambiguous, and requests confirmation for sensitive changes.
The canonical API writes the record, prevents duplicate mutations, and returns server-computed balances and metrics.
Add one HTTPS endpoint. Your client discovers EzFin’s tools and opens a secure Google sign-in flow that binds the session to an authorized workspace.
$ codex mcp add ezfin --url \ https://api-ezfin.azifexlab.net/api/v1/mcp $ codex mcp list ezfin https://api-ezfin.azifexlab.net/api/v1/mcp
The MCP server offers a small set of task-oriented tools. It never exposes arbitrary queries, raw storage, or provider credentials.
skillTeaches the client EzFin’s safe, authoritative workflow before it acts.
record_transactionRecord income, expense, or adjustment through the canonical parser.
record_transferMove money between accounts without misclassifying income or expense.
find_transactionsSearch a bounded slice of transaction history with stable identifiers.
get_account_balanceRead a server-computed balance for an authorized account.
get_financial_metricsAsk for deterministic metrics with period and currency context.
reconcile_accountCompare an observed balance and safely propose an adjustment.
create_accountAdd an account to the authenticated workspace.
Every request resolves an authenticated user and workspace. A tool cannot silently switch to another workspace.
Missing facts and multiple matches produce structured clarification—not an invented account, amount, or category.
Mutations carry idempotency keys, preserve audit history, and pause for confirmation where the risk demands it.
Connect a compatible client, sign in with Google, choose your EzFin workspace, and ask for the skill tool first.