Airwallex
Airwallex provides business accounts, payments, payouts, foreign exchange, cards, and financial operations through a unified global financial platform.
Verdict
Common use cases
- Check multi-currency balances during budget reviews
- Audit recent transfers before month-end close
- Verify beneficiary details before wire approvals
- List supported conversion pairs for FX planning
- Surface pending conversions in treasury standups
Integration
- Vendor
- Airwallex
- Category
- other
- Auth
- API_KEY
- Tools
- 7
- Composio slug
airwallex
Tools
- Get Current Account
Retrieve identity, status, and profile details for the connected Airwallex account.
- Get Current Balances
Return available, pending, reserved, prepayment, and total balances by currency for an Airwallex account type.
- Get Supported Conversion Currencies
Return the connected client's currencies supported for buying and selling in conversions.
- List Beneficiaries
List beneficiaries, optionally filtered by identity, bank account, entity type, or creation date. Returns one page and a cursor for continuation.
- List Conversions
List recent currency conversions, optionally filtered by currencies, request ID, status, or creation time. Returns one page and a continuation cursor.
- List Global Accounts
List global accounts, optionally filtered by country, currency, nickname, status, or creation time. Returns one page and an Airwallex bookmark cursor when another page is available.
- List Transfers
List one page of transfers created by the connected Airwallex account, optionally filtered by currency, destination, request ID, status, or creation time. Pass the returned cursor to retrieve the next page.
Setup
Setup guide
- 11. In Switchy, open Settings and navigate to the Integrations tab. 2. Find Airwallex in the MCP directory and click Connect. 3. You'll be prompted to paste an API key — generate one in your Airwallex dashboard under Developers > API Keys with scopes for accounts:read, balances:read, beneficiaries:read, conversions:read, and transfers:read. 4. Paste the key into Switchy and click Authorize. 5. Switchy confirms the connection and displays the account identity it retrieved. 6. Open any Project, type '@Airwallex get current balances' in the chat, and press send. 7. The MCP returns a breakdown of available, pending, and reserved funds by currency, confirming the integration works. 8. You can now @mention Airwallex in any Project to invoke its tools — the AI will route requests automatically based on your prompt.
What teammates see: by default, memories from Airwallex 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
Balance Snapshot
@Airwallex get current balances and show me available funds in USD, EUR, and GBP.
Recent Transfers
@Airwallex list transfers from the past seven days and highlight any that are still pending.
Conversion History
@Airwallex list conversions completed this month and summarize the total volume by currency pair.
Beneficiary Lookup
@Airwallex list beneficiaries and find the one with 'Acme Corp' in the name, then show me the bank account details.
Conversion Pairs
@Airwallex get supported conversion currencies and tell me if I can convert SGD to AUD.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@airwallex what's my current balance across all currencies, and which ones can I convert between right now?
Your Airwallex account shows available balances in 4 currencies: USD $12,450.32, EUR €8,200.15, GBP £3,100.00, and AUD $5,600.78. You have $200 USD pending and €150 EUR reserved. For conversions, you can buy or sell between USD, EUR, GBP, AUD, SGD, HKD, and CNY. The EUR balance includes a €500 prepayment credit applied to your account type.
This example combines balance checking with conversion-currency discovery, showing how the MCP surfaces multi-currency state in one query. Requires read:account and read:balances scopes. Balance figures refresh on each call but may lag real-time by seconds during high transaction volume.
@airwallex create a transfer of 5000 USD to my beneficiary 'Supplier Inc' and confirm the reference number
Transfer initiated: 5,000.00 USD to beneficiary 'Supplier Inc' (ID: bene_abc123xyz). Reference number TRF-2024-001234. Status: processing. Estimated arrival: 1-2 business days depending on the beneficiary's bank. Your USD available balance decreased from $12,450.32 to $7,450.32. You'll receive a webhook notification when the transfer completes or if any issues arise.
Demonstrates the MCP's ability to execute financial actions, not just read data. This is illustrative—actual transfer creation requires write:transfers scope, a verified beneficiary on file, and sufficient balance. Always confirm beneficiary details in Airwallex's dashboard before automating transfers; reversals are difficult once processed.
@airwallex review my last 10 conversions and summarize which currency pairs had the best rates this month
Your last 10 conversions span USD↔EUR (4 trades), GBP→USD (3 trades), and AUD→USD (3 trades). Best effective rates this month: EUR→USD averaged 1.0842 (vs. mid-market 1.0820), and AUD→USD averaged 0.6531 (vs. mid-market 0.6510). GBP→USD conversions were tighter at 1.2701 (mid-market 1.2695). All conversions completed within 2 hours. Two EUR→USD trades on Jan 15 captured a favorable rate spike; consider timing larger conversions around market open for similar opportunities.
Showcases synthesis: the MCP fetches conversion history, and the AI calculates rate performance against market benchmarks. Requires read:conversions scope. Conversion data includes request IDs and timestamps, enabling audit trails. Rate comparisons assume the AI has access to external FX reference data; the MCP itself doesn't provide mid-market rates.
Use-case deep-dives
When Airwallex beats manual FX for recurring global payroll
A 6-person SaaS startup paying 12 contractors across 8 countries every month hits the sweet spot for this MCP. The finance lead runs a standup query in Switchy to check balances, pull conversion rates for the week's currencies, and list pending transfers—all without opening the Airwallex dashboard. The MCP's 7 tools cover the read-only workflow: you see what's queued, what's settled, and what FX spread you're getting, but you can't initiate payments from the AI layer. If your team processes more than 40 transfers a month or needs approval workflows inside the chat, you'll still route final execution through Airwallex's UI. For teams under that threshold who want payment visibility during planning calls, this MCP cuts 4 minutes per check-in.
Use this MCP when support needs live FX context
A 3-person customer success team handling refunds for a marketplace with buyers in 15 currencies can answer "did the refund clear?" questions in Slack without switching tabs. The List Transfers and Get Current Balances tools let the agent surface transaction status and remaining liquidity in the customer's original currency during a live chat. The limitation: you can't create a new beneficiary or trigger a refund from Switchy, so this is strictly a lookup play. If your refund volume is under 20 per week and the questions are "where is it?" not "send it now," the MCP saves 90 seconds per inquiry. Teams doing high-frequency refunds or needing instant disbursement will still need Airwallex's dashboard open alongside the AI workspace.
When finance wants conversion history without export hell
A fractional CFO working with 4 early-stage clients uses this MCP to pull conversion history and balance snapshots during quarterly board prep. The List Conversions and Get Supported Conversion Currencies tools let her compare realized FX rates against spot without downloading CSVs from each client's Airwallex account. The trade-off: pagination is manual—if a client ran 200 conversions in the quarter, she'll need to pass cursors through multiple queries. For clients with under 50 conversions per review period, the MCP turns a 12-minute export-and-pivot task into a 3-minute conversational pull. If your client roster exceeds 8 accounts or conversion volume tops 100 per quarter, you'll want a dedicated BI connector instead of ad-hoc AI queries.
Frequently asked
What does the Airwallex MCP do in Switchy?
It connects your Airwallex account so AI agents can check balances, list beneficiaries, review conversions, and pull transfer history without leaving the chat. Useful for finance teams who want to query payment data conversationally instead of logging into the Airwallex dashboard every time someone asks about a wire or FX rate.
Do I need admin access to connect Airwallex?
You need an Airwallex API key with read permissions for accounts, balances, beneficiaries, conversions, and transfers. Airwallex issues keys at the account level, so whoever generates the key controls what the MCP can see. Check your Airwallex role settings before creating the key.
Can the Airwallex MCP initiate payments or conversions?
No. It only reads data—balances, beneficiary lists, conversion history, transfer records. If you need to send money or execute an FX trade, you still do that in Airwallex directly or via their full API. This MCP is for visibility, not execution.
Why use this instead of just opening Airwallex?
Speed and context. An agent can pull your USD balance, list pending transfers, and check conversion rates in one response while you're already discussing a vendor payment in Switchy. No tab-switching, no manual CSV exports, no copy-pasting account numbers into Slack.
Who on the team should connect the Airwallex MCP?
Whoever owns treasury or AP workflows and already has API access in Airwallex. Once connected, any Switchy workspace member can query the data through agents, but the API key's permissions define what's visible. Don't share keys across unrelated teams.