t1k:business:airwallex
| Field | Value |
|---|---|
| Module | base |
| Version | 0.12.1 |
| Effort | low |
| Tools | — |
Keywords: account balance, airwallex, balance, banking, beneficiaries, beneficiary, card, cashflow, client payment, company card, contract to billing, conversion, foreign exchange, fx, global account, hk entity bank, invoice, issue card, money out, multi-currency, payables, payee, payment received, payout, receivables, reconcile, statement, transactions, transfer
How to invoke
Section titled “How to invoke”/t1k:business:airwallexbalance | transactions [account] | receivables | payables | beneficiaries | cards | fx-rates | reconcile <amount/client> | invoice-from <contract.md> | <natural-language finance query>Airwallex Account Operations
Section titled “Airwallex Account Operations”Read and operate the Airwallex business account from Claude Code through the official Airwallex AgentOS MCP server. Airwallex is a common HK-entity business bank — this skill is the bridge between contracts/finance work and the live account: pull real balances, reconcile incoming client payments against invoices, review cashflow, and manage beneficiaries and cards. Pairs with [[t1k:business:pandadoc-esign]] (signing) and t1k:business:finance (modeling/reporting over the numbers this skill pulls).
invoice issued → client pays → airwallex: read transactions → reconcile → finance reportcontract (.md) → airwallex: contract-to-billing → invoice + billing termsVerified surface (observed against a live production account)
Section titled “Verified surface (observed against a live production account)”- ~60 tools surface as
mcp__airwallex__*once connected. Reads:get_account_balances,list_balance_history,list_global_accounts,list_global_account_transactions,list_transfers,list_fx_conversions,get_fx_rate,list_beneficiaries,list_cards/list_cardholders,list_spend_bills/list_spend_vendors,list_payment_intents/list_refunds, billinglist_*. Non-money-out writes: beneficiaries, cards, payment links, billing/invoices. (Names are discovered per session — see the tool-names gotcha — treat this list as a map, not a contract.) - Money-out was refused server-side in production — the server itself rejected transfers, payment capture, FX conversion execution, and refunds/payouts, not merely “disabled by default”. Do not rely on that as the only guard: the HARD GATE below still binds, and re-verify on your own account before assuming the door is locked.
- Keep the mapping of your wallet currencies and global accounts to your accounting files in your own repo docs, not in this skill.
⚠️ This is LIVE PRODUCTION financial data
Section titled “⚠️ This is LIVE PRODUCTION financial data”The AgentOS MCP authenticates by OAuth against the production Airwallex account. Everything it reads is real money and real counterparties. Two consequences:
- Never quote raw account numbers, full card PANs, or beneficiary bank details in chat beyond what the user asked for — treat output like the secrets they are (see
rules/security.md). - Money-out is gated (see HARD GATE below). Reading is safe; moving money is not.
The three Airwallex MCP connectors
Section titled “The three Airwallex MCP connectors”Only the AgentOS MCP (row 1) is registered for live account operations. The other two are documented here so you know what you’re not talking to.
| Connector | Endpoint | Scope | Use for live ops? |
|---|---|---|---|
| AgentOS MCP ⭐ | https://mcp.airwallex.com/mcp | Production: read account + non-money-out writes | ✅ |
| Developer MCP | https://mcp-demo.airwallex.com/developer | Sandbox + docs (coding help only) | ❌ |
| Docs MCP | (docs-only, no auth) | Documentation lookup | ❌ |
Prerequisites (one-time)
Section titled “Prerequisites (one-time)”- Register the
airwallexMCP server in your project.mcp.json(https://mcp.airwallex.com/mcp, HTTP transport). - Authenticate once: run
/mcp, select airwallex, complete the browser OAuth login with your production Airwallex account. Status must read connected before any operation below. - Tools surface as
mcp__airwallex__*and are deferred — load them first withToolSearch(query="airwallex"). The exact tool names appear only after step 2; this skill documents operations by capability, then you bind to whatever tools the server actually exposes.
Operations
Section titled “Operations”Grouped by safety tier. Read first; write second; move-money last (and gated).
Read (safe)
Section titled “Read (safe)”| Operation | What it does |
|---|---|
| Balances | Query multi-currency balances across cash / yield / credit account types. |
| Transactions | List/inspect account transactions for an account + date range. |
| Receivables / payables | Understand cashflow — what’s owed to you vs what you owe. |
| Statements | Pull statement data for a period (reconciliation, finance reports). |
| FX rates / conversion options | Get current FX options to prep a payrun (read-only quote, not execution). |
| Beneficiaries | List existing payees and their details. |
| Cards | List company cards and their state. |
Write — non-money-out (allowed, but confirm first)
Section titled “Write — non-money-out (allowed, but confirm first)”| Operation | What it does |
|---|---|
| Create beneficiary | Add a new payee. Enables a future payout but does not move money. |
| Issue / provision card | Create a company card for business spend. |
| Contract-to-billing | Turn a signed contract into billing terms + a customer invoice. |
These don’t move money, but they create real records on the production account. Show the user what you’re about to create and get a yes before writing.
Creating an invoice (Airwallex Billing)
Section titled “Creating an invoice (Airwallex Billing)”Flow (all non-money-out writes):
create_billing_product → create_billing_customer → create_billing_invoice (DRAFT) → add_billing_invoice_line_items → STOP, show the user the draft → finalize_billing_invoice.
finalizeis IRREVERSIBLE — once finalized the invoice is issued; it can only be voided, never edited. Never finalize without explicit per-invoice user approval; always build and show the DRAFT first.- Default
collection_method: OUT_OF_BANDwhen clients pay by bank transfer into your global accounts: the Airwallex invoice is then just the billing document, and youmark_billing_invoice_as_paidonce the deposit shows in the balance ledger. UseCHARGE_ON_CHECKOUTonly when you deliberately want the client to pay through Airwallex’s hosted page (a new payment rail, may incur fees). - Pick one invoicing channel per invoice. If invoices of record are issued elsewhere (e-sign tool, document system), an Airwallex Billing invoice is a DIFFERENT document — do not double-invoice a client across both.
create_billing_customer: never fabricate an email or phone number — omit them unless the user provides them.
Money-out (HARD GATE — disabled by default)
Section titled “Money-out (HARD GATE — disabled by default)”✅ No automated interceptor enforces this gate. Unlike the PandaDoc per-send discipline, the money-out rule below is carried by this skill body alone: it binds whoever is reading this file, and nothing else. There is no PreToolUse hook matching mcp__airwallex__* in this kit or in core — an earlier revision of this section claimed one named airwallex-payout-gate, which was never shipped (theonekit-business#33), and a reader who trusted it could have taken a risk believing a mechanical guard would stop the call. Airwallex’s own default-off on money-out actions is the only backstop that exists. Treat every money-out call as unguarded.
Executed by
Section titled “Executed by”Only the read/reconcile half of this skill is cheap-tier work; every
money-moving operation stays behind the HARD GATE above (routing SSOT:
rules/orchestration-rules.md § “Task-Type → Agent Routing”):
| Step | Agent |
|---|---|
| Pull balances, transaction lists, receivables/payables or statements for a stated account + date range and report the figures | t1k-fact-fetcher |
| Reconcile an incoming client payment — match the incoming credit to the invoice, confirm received, update the client tracker — against a stated invoice | t1k-data-verifier |
| Any money-out operation (transfer, FX conversion, payout, bill payment) | never delegated — stays gated behind the HARD GATE above; per-action explicit human approval required in every case |
| Non-money-out writes (create beneficiary, issue card, contract-to-billing) | stay on a reasoning tier — they create real production records and need user confirmation |
Cheap-tier delegation ends at “this payment is reconciled against this invoice.” Sending, converting, or paying money is a human decision and is never delegated.
Common workflows
Section titled “Common workflows”- Reconcile a client payment — invoice issued → read transactions → match incoming credit to the invoice → confirm received → update the client tracker / deal status. Pairs with
t1k:business:finance. - Cashflow snapshot — balances + receivables + payables → hand the numbers to
t1k:business:financefor runway/burn or an investor update. - Beneficiary setup before a payout — create beneficiary (non-money-out) now; the actual payout stays gated until you explicitly approve it later.
Hard rules
Section titled “Hard rules”- OAuth, not API keys. No Airwallex credentials should live in the repo. Auth is the interactive
/mcpbrowser flow; nothing to gitignore.
Security
Section titled “Security”Account data is live financial data. Do not echo full account/card/beneficiary identifiers into chat beyond the user’s request; never write them into synced data-room files. Per rules/security.md and the skill-security boilerplate.