Finmo
Finmo provides payment collection, payouts, wallets, foreign exchange, virtual accounts, and transaction management for businesses.
Verdict
Common use cases
- Wire funds to a vendor after invoice approval
- Refund a customer payment from support chat
- Validate beneficiary bank details before payout
- Create compliance-ready customer profiles at onboarding
- Check payin method requirements for new markets
Integration
- Vendor
- Finmo
- Category
- other
- Auth
- API_KEY
- Tools
- 19
- Composio slug
finmo
Tools
- Create Customer
Create a real production Finmo customer profile containing personal or company identity data. This stores PII, mutates production, and may start identity-verification or other compliance workflows, but does not itself move money. Confirm th
- Create Payin
Create a real production payin that can collect money from a customer and credit a customer or merchant wallet. This has real financial effects. First call FINMO_LIST_PAYIN_METHODS and FINMO_GET_PAYIN_METHOD_REQUIREMENTS, then supply exactl
- Create Payout
Send real production funds from a Finmo wallet to a beneficiary. This reserves and can irreversibly transfer money. First call FINMO_LIST_PAYOUT_METHODS and FINMO_GET_PAYOUT_METHOD_REQUIREMENTS, verify the beneficiary and available wallet b
- Create Payout Beneficiary
Create a real payout beneficiary in the connected Finmo production account. This does not move money, but Finmo stores the supplied sensitive bank, proxy, identity, and contact data and the record can enable later payouts. First call FINMO_
- Create Refund
Issue a real production full refund for a completed Finmo payin. This moves real money, debits or holds funds in the payin wallet, may incur fees, and may be irreversible. Before calling, verify the payin is refundable and that the full ref
- Get Payin Method Requirements
Return the dynamic required fields, validation regexes, limits, instructions, and capabilities for one Finmo payin method. Call this immediately before constructing a payin request.
- Get Payment
Get one payin, payout, or refund by its Finmo reference ID. Use this after an ambiguous timeout before retrying a money-moving request with the same idempotency key.
- Get Payout Method Requirements
Return the dynamic payout, beneficiary, and sender field requirements for one Finmo payout method. Use it before creating a beneficiary or moving money.
- Get Wallet
Get one wallet and its currency accounts, including actual and available balances. Reading balances is sensitive but does not move funds.
- List Customers
List one page of individual or company customer profiles and wallet-readiness state. Returns a continuation cursor when more customers are available.
- List Payin Methods
List one page of enabled ways to collect money for a country and currency, with a continuation cursor when more results exist. Use FINMO_GET_PAYIN_METHOD_REQUIREMENTS before creating a payin because required fields vary by method.
- List Payins
List inbound payment attempts with status, method, customer, wallet, and time filters. Returns one page and a continuation cursor.
- List Payout Beneficiaries
List one page of stored payout beneficiaries and their destination details. Returns a continuation cursor when more beneficiaries are available; use payout method discovery to assess rail suitability.
- List Payout Methods
List one page of enabled payout rails for a sender and beneficiary country/currency pair. Results may use wildcard sender values. Inspect the returned beneficiary requirements, then call FINMO_GET_PAYOUT_METHOD_REQUIREMENTS for current bene
- List Payouts
List one page of outbound payments with status, payout method, and time filters. Returns a continuation cursor when more payouts are available.
- List Refunds
List one page of refunds with status, originating payin, amount, and time filters. Returns a continuation cursor when more refunds are available.
- List Transactions
List organization-level financial transactions for reconciliation, filtered by customer, event type, settlement, reconciliation, or time. Returns one page and a continuation cursor.
- List Wallets
List one page of Finmo wallets available to the connected organization or a customer. Returns a continuation cursor when more wallets are available. Summaries exclude balances; use FINMO_GET_WALLET for wallet accounts and balances.
- Transfer Wallet Funds
Move real production funds immediately between two Finmo wallets. This money-moving operation may be irreversible. Before calling, use FINMO_GET_WALLET on both wallets to verify the exact destination, active currency accounts, and sufficien
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP integrations panel. 2. Click 'Add MCP' and select Finmo from the directory. 3. You'll be prompted to paste your Finmo API key — retrieve it from your Finmo dashboard under Settings > API Keys (create a new production key if you don't have one). 4. Paste the key into Switchy and click 'Connect'. 5. Switchy will verify the key and confirm the connection. 6. Open any Project, type '@Finmo' in the chat, and ask it to list available payout methods — if you see a structured response with method details, the integration is live. 7. Because Finmo tools move real money and store PII, review which team members have access to Projects where Finmo is enabled.
What teammates see: by default, memories from Finmo are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Payout Methods
@Finmo list all available payout methods for Brazil and show me the requirements for bank transfer payouts.
Create Beneficiary
@Finmo create a payout beneficiary for Acme Supplies using IBAN DE89370400440532013000, contact email vendor@acme.de, and address in Berlin.
Issue Refund
@Finmo issue a full refund for payin reference PAY_20250115_ABC123 and confirm the refund status.
Check Payment Status
@Finmo get the payment details for reference OUT_20250115_XYZ789 and tell me if it has settled.
Verify Payin Requirements
@Finmo show me the required fields and validation rules for card payins in Mexico.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Finmo what are the requirements to send a payout via SEPA to a EUR bank account?
The SEPA payout method requires the following beneficiary fields: full name (regex: ^[A-Za-z\s'-]{2,100}$), IBAN (validated against IBAN checksum), and BIC (optional but recommended). Sender fields include company name and address. Limits: €0.01 minimum, €15,000 maximum per transaction. Settlement typically occurs within 1 business day. Note that Finmo validates IBAN format in real time; invalid IBANs will be rejected before funds are reserved.
This example demonstrates the read-only requirements lookup that should always precede a payout. The MCP returns dynamic validation rules that vary by method and jurisdiction. Users must call this before creating beneficiaries or moving money to avoid rejections. No production side-effects occur.
@Finmo create a customer profile for Jane Doe, email jane@example.com, phone +44 20 7946 0958, UK resident
Customer created successfully. Finmo reference: cust_8x3k9mPq. Status: pending_verification. The profile contains the supplied identity data and has triggered Finmo's standard KYC workflow. Jane will receive an email at jane@example.com with verification instructions. Until verification completes, this customer cannot be used as a payin or payout party. You can check status via the Get Customer tool.
This write operation stores real PII in production and starts compliance workflows. It requires API key scopes for customer creation. Users should understand that customer records persist indefinitely and trigger identity verification; test data should never be created in production accounts. Always confirm the environment before running.
@Finmo review the last 5 payouts from our main wallet and flag any that failed or are still pending after 48 hours
Analyzed 5 recent payouts from wallet wal_7hG3n. Results: 3 completed successfully within 24 hours. 1 payout (ref: pyt_4kL9x, £250 to beneficiary ben_2mQ8, initiated 2024-01-15) is still status: processing after 51 hours—this exceeds typical FASTER_PAYMENTS settlement and may indicate a bank hold or compliance review. 1 payout (ref: pyt_9rT2w, €500 SEPA, initiated 2024-01-14) failed with reason: invalid_iban. Recommended actions: contact Finmo support about pyt_4kL9x; verify and resubmit pyt_9rT2w with corrected beneficiary IBAN.
This synthesis example pairs the MCP's list and get tools with AI reasoning to surface operational issues. It demonstrates how Switchy can monitor payment state across multiple transactions. Users need read access to wallets and payments. The MCP does not auto-retry failed payouts—remediation requires manual intervention.
Use-case deep-dives
When Finmo wins for multi-currency seller payouts
A 6-person marketplace team needs to pay 200+ sellers across 15 countries every Friday. Finmo's MCP is the right call if your team already runs Finmo in production and needs AI to handle the payout-method lookup, beneficiary validation, and retry logic without writing custom code. The MCP exposes 19 tools including dynamic requirements checks (Get Payout Method Requirements) and idempotent money movement (Create Payout). The threshold: if your ops team is manually copy-pasting bank details from a spreadsheet into the Finmo dashboard, this MCP saves 4-6 hours a week. If you're still evaluating payment rails or your volume is under 20 payouts a month, the setup overhead outweighs the gain. For teams shipping weekly payout runs with existing Finmo infrastructure, the MCP turns a multi-step dashboard workflow into a single conversational prompt.
When this MCP handles identity verification at scale
A fintech startup onboarding 50-100 new customers a day needs to create Finmo customer profiles, trigger identity checks, and log the compliance trail. The Finmo MCP is the right tool if your support or ops team is already context-switching between Slack, your CRM, and the Finmo dashboard to manually create profiles. The Create Customer tool writes real PII to production and kicks off verification workflows, so the win is speed and audit consistency, not experimentation. The trade-off: if your onboarding flow requires custom field mapping or multi-step approvals outside Finmo's schema, you'll still need middleware. If your team onboards fewer than 10 customers a week, the manual dashboard is faster. For high-velocity onboarding teams with Finmo as the system of record, the MCP collapses a 3-minute dashboard task into a 10-second AI handoff.
When Finmo MCP speeds up refund decisions
A 4-person support team fields 30-50 refund requests a day and needs to verify payin status, check wallet balance, and issue refunds without leaving the ticket thread. The Finmo MCP is the right call if your team already uses Finmo for payment processing and spends more than an hour a day toggling between Zendesk and the Finmo dashboard. The MCP's Get Payment and Create Refund tools let the AI fetch transaction details and execute refunds with idempotency guards, so repeat requests don't double-refund. The boundary: if your refund policy requires manager approval or multi-step fraud checks, the MCP won't replace that workflow. If your refund volume is under 10 a week, the manual dashboard is fine. For support teams handling daily refund spikes, the MCP turns a 5-minute lookup-and-click into a single conversational command.
Frequently asked
What does the Finmo MCP let me do in Switchy?
It lets your team create customer profiles, collect payments, send payouts, and issue refunds directly through Finmo's production API. All 19 tools operate on live financial data—creating a payin or payout moves real money. You can also fetch payment method requirements and verify transaction status before retrying operations.
Do I need special Finmo credentials to connect this MCP?
Yes, you need a Finmo production API key with write permissions. The MCP creates customers, moves money, and stores PII, so Finmo will require you to complete their onboarding and compliance checks before issuing keys. Sandbox keys won't work—this integration only targets live environments.
Can the Finmo MCP reverse a payout after it's sent?
No. Payouts and refunds are irreversible once Finmo processes them. The MCP includes a Get Payment tool so you can check transaction status after a timeout, but it won't let you cancel or claw back funds. Always verify beneficiary details and amounts before calling Create Payout.
Why use this MCP instead of calling Finmo's API directly?
The MCP surfaces dynamic field requirements—like regex validators and country-specific limits—before you submit a payment request, reducing failed transactions. It also enforces idempotency and provides plain-language error handling. If your team already has a Finmo integration, the MCP adds conversational access without replacing your existing flow.
Who on my team should connect the Finmo MCP?
Only finance or operations leads who hold production API keys and understand your compliance obligations. Every tool in this MCP can move money or store regulated PII. Don't share the connection with support staff or junior developers unless they're authorised to initiate real transactions in your Finmo account.