# Airwallex MCP

> Airwallex MCP connects your AI agent to global treasury tools for cross-border payments and multi-currency management. Get real-time balances, track international transfers, manage beneficiary lists, and fetch live foreign exchange rates—all through natural conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** airwallex, global-treasury-api, cross-border-payments, fx-management, multicurrency-accounts, financial-orchestration, beneficiary-management, fintech-tools, mcp

## Description

Need visibility into global cash flow? This MCP lets you control all aspects of your international finance operations using only plain talk with your AI client. Instead of manually logging into multiple bank portals or digging through complex spreadsheets to reconcile currencies, your agent handles it. You can list every business account worldwide and pull real-time balance data across different currencies. It helps you track payment histories, manage who receives money internationally, and get up-to-the-minute FX quotes. If you use Vinkius, this MCP adds enterprise-grade treasury functionality right into your workflow, letting you stop being a manual bookkeeper and start making decisions.

## Tools

### get_balance
Checks the real-time balance of a specific global account.

### get_fx_rates
Retrieves current foreign exchange quotes between two specified currencies.

### list_accounts
Provides a complete list of all connected business accounts and their base currencies.

### list_beneficiaries
Fetches the current directory of global recipients used for payouts.

### list_payments
Shows a summary of recent outgoing payment intents and their status transitions.

### list_transfers
Lists historical records of all processed cross-border transfers.

## Prompt Examples

**Prompt:** 
```
List all my Airwallex global accounts and their base currencies.
```

**Response:** 
```
I've retrieved your global accounts. You currently have 3 accounts: 'Main Treasury' (USD), 'EU Operations' (EUR), and 'HK Growth'. Which one should we check for real-time balances?
```

**Prompt:** 
```
Show the current FX rate for converting 10,000 USD to EUR.
```

**Response:** 
```
Accessing FX intelligence... The current rate for USD to EUR is 0.924. Converting 10,000 USD would yield approximately 9,240 EUR. Shall I retrieve the high-fidelity quote for an actual transfer?
```

**Prompt:** 
```
Show my recent payment intents and their statuses.
```

**Response:** 
```
Fetching payment data... Your last 5 intents include 3 'Succeeded' payments totaling $4,500 and 2 'Requires Action' items. The most recent is from @user1. Would you like the high-fidelity metadata for the pending ones?
```

## Capabilities

### List all global accounts
Retrieves a programmatic list of every business account the company holds worldwide, including current balances.

### Check real-time currency rates
Provides accurate foreign exchange quotes and market rates for optimizing cross-border conversions.

### Track payment status history
Monitors recent outgoing payments, showing their current status and full transaction details to confirm receivables.

### Manage global recipients
Accesses and updates the directory of international beneficiaries needed for smooth compliance and transfers.

### Get instant account balances
Retrieves a specific, up-to-date balance for any designated multi-currency account.

## Use Cases

### Reconciling multi-currency cash flow
A finance manager needs the total available funds in USD and EUR across three different accounts. Instead of logging into three portals, they ask their agent to run `list_accounts` and then follow up with a call to `get_balance`, getting instant liquidity reports.

### Preparing for international payroll
The HR team needs to pay 50 employees in different currencies. They use `list_beneficiaries` first, then check the latest rates with `get_fx_rates`, ensuring every payout is compliant before running transfers.

### Auditing a large payment batch
The operations team suspects some payments stalled. They ask their agent to run `list_payments` and then examine the full transfer history using `list_transfers` to pinpoint exactly where the money stopped.

## Benefits

- Stop manually checking balances. Use `list_accounts` and `get_balance` to get real-time liquidity summaries for every currency in one go.
- Optimize transfers by getting instant rates. The `get_fx_rates` tool lets you check the current market rate before committing to a conversion.
- Never lose track of incoming money again. Use `list_payments` to monitor payment intents and their statuses without needing banking logins.
- Simplify payouts. Manage your entire network using `list_beneficiaries`, ensuring compliance details are always up-to-date for international transfers.
- Understand your full history. Combine `list_transfers` with `list_accounts` to build a clear, auditable record of money movement.

## How It Works

The bottom line is: you tell the AI what money data you need, and it pulls it directly from Airwallex without any manual steps.

1. First, subscribe to this MCP and grab your Client ID and API Key from the Airwallex developer portal.
2. Next, connect those credentials in your preferred AI client like Claude or Cursor. The connection is handled by Vinkius.
3. Finally, just talk to your agent. Ask it things like, 'What's the balance for our EU account?' and it runs the calls.

## Frequently Asked Questions

**How do I find my Airwallex Client ID and API Key?**
Log in to your account, navigate to **Settings** > **Developer**, and you will find your Client ID and the option to generate an API Key.

**Can I retrieve real-time FX quotes via AI?**
Yes! The `get_fx_rates` tool allows your agent to retrieve current high-fidelity market rates between any two supported currencies programmatically.

**How do I check my multicurrency balances?**
Use the `get_balance` tool and provide a specific account ID to retrieve a high-fidelity summary of all funds held in that global account.

**How do I use `list_beneficiaries` to manage global recipients?**
You programmatically access your directory of global beneficiaries. This lets you check or update recipient details needed for international transfers without having to manually log into a portal.

**What status transitions can I track using `list_payments`?**
The tool provides high-fidelity status tracking for payment intents. You'll see if payments are 'Succeeded,' 'Requires Action,' or pending, giving you a perfect overview of your receivables.

**Can I use `list_transfers` to audit past account movements?**
Yes. You can pull a comprehensive list of all recorded transfers through the agent. This is useful for building operational financial reports or tracing historical cross-border activity.

**What happens if my AI client hits an error limit while calling this MCP?**
The agent will report an explicit error code and message directly. You'll need to wait the specified cool-down period before attempting the operation again, preventing rate limit issues.

**Does `get_balance` provide only a raw amount, or does it include currency details?**
It provides detailed real-time balances along with high-fidelity currency metadata. You get not just the number, but also which specific account and foreign currency it belongs to.