Integration

Finmo integration

Finmo is a payments and treasury platform for businesses. Collect money with local payin methods or a hosted checkout page, refund payins, send domestic and cross-border payouts, quote and book FX conversions, move funds between wallets, set up payment plans and recurring collections, and read wallet ledgers, transactions and webhook delivery history. Creating payins, payouts, refunds, conversions, transfers and recurring charges moves real money with a production key; a sandbox key never reaches a bank, and the simulate_* tools complete sandbox records. Customer profiles (KYC data), payout beneficiaries and senders, virtual accounts, card tokenization, KYC document uploads, QR decoding, card payin intents and payin or payout memo downloads are not exposed, and beneficiary bank details, sender details, metadata and webhook or receipt contact fields are not returned. Exceeding Finmo rate limits returns HTTP 429; Finmo raises limits on request. Authentication is HTTP Basic: the Access API key as username and the Secret API key as password, generated as a pair in the Finmo dashboard (the key decides sandbox or production).

Connect Finmo How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Finmo.Built from the 48 Finmo tools below, on the connection you add once.

What you can do with Finmo

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Payin, 5 operations

cancel_payinCancel payinPATCHCancels a PENDING payin for real, only for payin methods whose is_cancellable is true (see get_payin_method_fields). Finmo then sends the payin cancelled webhook.
create_payinCreate payinPOSTCreates a real payin: a request for a payer to pay you by the chosen method. Returns payin_id, status and pay_code (the payment instructions to show the payer). Build payin_method_param from get_payin_method_fields.
get_payinGet payinGETReturns one payin by its payin_id (from create_payin or list_payins): amount, status, paid and refunded amounts, fees, refundability flags and pay_code instructions.
list_payinsList payinsGETLists payins (payment requests to collect funds), filtered by status, date, customer, wallet or payin method. Paginate with limit (default 10) and page.
simulate_payinSimulate payinPATCHSandbox only: marks a PENDING payin COMPLETED (funds received) or CANCELLED, to test your flow and webhooks. Pass amount and currency only to simulate a partial payment.

Checkout, 4 operations

cancel_checkoutCancel checkoutPATCHCancels a checkout page for real, together with any of its payins still PENDING. Finmo then sends the checkout cancelled webhook.
create_checkoutCreate checkoutPOSTCreates a Finmo-hosted payment page for one amount and returns its checkout_url to give the payer. If you pass notification_email or a phone number, Finmo sends the link there itself.
get_checkoutGet checkoutGETReturns one checkout by its checkout_id (xo_*, from create_checkout or list_checkouts): status, amount, checkout_url and the payin_id created once the payer paid.
list_checkoutsList checkoutsGETLists hosted checkout pages, filtered by status (CREATED, PENDING, COMPLETED, EXPIRED, CANCELLED), date, customer or wallet. Paginate with limit (default 10) and page.

Fx conversion, 4 operations

create_fx_conversionCreate fx conversionPOSTConverts money for real from one currency to another in your wallets at the live spot rate, or at a quote from create_fx_rate (fx_rate_id). Pass source_amount or target_amount, never both.
get_fx_conversionGet fx conversionGETReturns one FX conversion by its fx_conversion_id (from create_fx_conversion or list_fx_conversions): amounts, rate, status and the debit and credit wallets.
list_fx_conversionsList fx conversionsGETLists FX conversions (currency exchanges between your wallets), filtered by status (PENDING, COMPLETED) or date. Paginate with limit (default 10) and page.
simulate_fx_conversionSimulate fx conversionPATCHSandbox only: completes (or sets to the status you pass) a PENDING FX conversion, to test your flow and webhooks. Status defaults to COMPLETED.

Payment plan, 4 operations

create_payment_planCreate payment planPOSTCreates a payment plan: a recurring schedule (frequency, fixed amount per cycle and number of cycles, or a custom plan_schedule) that create_recurring_payin can use. It charges no one by itself.
delete_payment_planDelete payment planDELETEDeletes a payment plan for real: Finmo marks it deleted and inactive (a soft delete). Returns the plan with is_deleted and deleted_at.
get_payment_planGet payment planGETReturns one payment plan by its payment_plan_id (from create_payment_plan or list_payment_plans): frequency, amounts, cycles, schedule and whether it is active.
list_payment_plansList payment plansGETLists payment plans (recurring payment schedules), filtered by frequency, country, currency, name, auto-debit or date. Paginate with limit (default 10) and page.

Payout, 4 operations

create_payoutCreate payoutPOSTSends money for real from a Finmo wallet to a beneficiary bank account (domestic or cross-border). Give payout_beneficiary_param (fields from get_payout_method_fields) or a payout_beneficiary_id. Returns payout_id and status.
get_payoutGet payoutGETReturns one payout by its payout_id (from create_payout or list_payouts): amounts and currencies on both sides, FX rate, fees, status and failure or return reason. Beneficiary bank details are not returned.
list_payoutsList payoutsGETLists payouts (money sent from your wallets), filtered by status (PENDING, COMPLETED, FAILED), payout method or date. Paginate with limit (default 10) and page. Beneficiary bank details are not returned.
simulate_payoutSimulate payoutPATCHSandbox only: sets a PENDING payout to its final status COMPLETED, FAILED or RETURNED, to test your flow and webhooks.

Recurring payin, 4 operations

create_recurring_payinCreate recurring payinPOSTSets up a real recurring collection from a customer, from a payment_plan_id or its own frequency, currency and country. Returns recurring_payin_id and redirect_url, where the customer authorizes it.
get_recurring_payinGet recurring payinGETReturns one recurring payin by its recurring_payin_id (recur_payin_*): plan, amount, frequency, status, start and end, next installment date and whether it is active.
list_recurring_payinsList recurring payinsGETLists recurring payins (subscriptions that collect from a customer on a schedule), filtered by id, payment plan, customer, amount, frequency or status. Paginate with limit (default 10) and page.
trigger_recurring_payinTrigger recurring payinPATCHCharges a usage-based recurring payin now for the amount you pass: this collects real money from the customer.

Refund, 4 operations

create_refundCreate refundPOSTRefunds a COMPLETED payin for real, in full (type FULL) or in part (type PARTIAL with amount and currency). Check is_refundable on get_payin first. Returns refund_id and status.
get_refundGet refundGETReturns one refund by its refund_id (from create_refund or list_refunds): amount, currency, type, status, original payin_id and fees.
list_refundsList refundsGETLists refunds, filtered by status (PENDING, COMPLETED, FAILED), original payin_id or date. Paginate with limit (default 10) and page.
simulate_refundSimulate refundPATCHSandbox only: marks a PENDING refund COMPLETED, to test your flow and the refund completed webhook.

Wallet, 3 operations

create_walletCreate walletPOSTCreates a wallet for an existing Finmo customer (customer_id) in one currency or a list of currencies. Returns wallet_id and one wallet account per currency with its balances.
get_walletGet walletGETReturns one wallet by its wallet_id (from list_wallets): category, owner customer and, per currency account, the actual and available balances.
list_walletsList walletsGETLists your Finmo wallets (organization Payin, Payout and Fees wallets, and customer wallets), filtered by category, customer or date. Paginate with limit (default 10) and page.

Wallet fund transfer, 3 operations

create_wallet_fund_transferCreate wallet fund transferPOSTMoves money for real from one wallet to another (organization wallets and customer wallets). Returns wallet_fund_transfer_id and status.
get_wallet_fund_transferGet wallet fund transferGETReturns one wallet fund transfer by its wallet_fund_transfer_id (wft_*, from create_wallet_fund_transfer or list_wallet_fund_transfers): amount, wallets, fees and status.
list_wallet_fund_transfersList wallet fund transfersGETLists transfers between wallets, filtered by wallet, customer, amount, currency or date. Paginate with limit (default 10) and page.

Webhook notification, 3 operations

get_webhook_notificationGet webhook notificationGETReturns one webhook notification by its webhook_id (from list_webhook_notifications): event type, event id and delivery status. The event payload is not returned: read the event with its own get tool.
list_webhook_notificationsList webhook notificationsGETLists the webhook notifications Finmo sent you, with event type, event id and delivery status, to find a missed one. Filter by event_type, event_id (such as a payin_id) or date.
retrigger_webhook_notificationRetrigger webhook notificationPATCHSends a webhook notification again to your webhook endpoint, for one that was not delivered. Pass the webhook_id from list_webhook_notifications.

Fx rate, 2 operations

create_fx_rateCreate fx ratePOSTGets a live FX quote for a currency pair: pass source_amount or target_amount, never both. Returns fx_rate_id and fx_rate; the quote is usually valid for about 20 seconds. Pass fx_rate_id to create_fx_conversion or create_payout.
get_fx_rateGet fx rateGETReturns a previously quoted FX rate by its fx_rate_id (from create_fx_rate): pair, amounts, rate, fixed side and expiry.

Payin method, 2 operations

get_payin_method_fieldsGet payin method fieldsGETReturns the fields one payin method needs (payin_method_param: name, mandatory, regex), its amount limits, expiry and refund rules. Read before create_payin to build payin_method_param.
list_payin_methodsList payin methodsGETLists the payin (collection) methods available for one country and currency, such as au_bank_npp. Pass a payin_method_name from here to get_payin_method_fields, then create_payin or create_checkout.

Payout method, 2 operations

get_payout_method_fieldsGet payout method fieldsGETReturns the beneficiary fields one payout method needs (base, individual and company field lists with name, mandatory, regex) and its amount limits. Read before create_payout.
list_payout_methodsList payout methodsGETLists the payout methods available for a sender and beneficiary country and currency pair, with amount limits. Pass a payout_method_name from here to get_payout_method_fields, then create_payout.

Transaction, 2 operations

get_transactionGet transactionGETReturns one transaction by its transaction_id (txn_*, from list_transactions or a payin, payout or refund): event, amount, fees, net amount, settlement and reconciliation status.
list_transactionsList transactionsGETLists transactions across events (payin, payout, refund, virtual account payins, top-ups) with fees and net amount, filtered by customer, event type, settlement, reconciliation or date.

Wallet transaction, 2 operations

get_wallet_transactionGet wallet transactionGETReturns one wallet ledger entry by its wallet_transaction_id (w_txn_*, from list_wallet_transactions): amount, type, event, running balances and settlement status.
list_wallet_transactionsList wallet transactionsGETLists wallet ledger entries (debits, credits, reserves, releases) with running balances, filtered by wallet, customer, type, event type, tag or date. Paginate with limit (default 10) and page.

Use Finmo from Claude Code, Cursor or Codex

Connect Finmo in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Finmo operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Finmo

Create your workspace
Sign up free. Nothing to install.
Connect Finmo once
Add your Finmo connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.