iBanFirst MCP Connector
The iBanFirst MCP server gives AI assistants direct access to your international payments and treasury operations. Query multi-currency wallet balances and IBANs, retrieve transaction history and payment details, check live FX rates, explore payment options and fees, manage external beneficiary accounts, and monitor active fix-forward trades. Designed for finance teams and CFOs who want instant, conversational visibility into their cross-border cash flows — without leaving their AI interface.
Connect the MCP
Claude.ai (Web)
- Open claude.ai and expand the sidebar
- Click Customize → Connectors -> Custom Url -> add the url: https://mcp.ibanfirst.com/mcp
- Click the + to Add Connector and search for "iBanFirst MCP"
- Click Connect and enter your OAuth Client ID and OAuth Client Password with your iBanFirst account
Not an Administrator of your Claude account? See I don't have admin access to add the connector — what should I do?
Claude Desktop
- Open Claude Desktop on your desktop
- Go to Customize → Connectors
- Click the + to Add Connector and search for "iBanFirst App MCP" in the connector list
- Click Connect and enter your OAuth Client ID and OAuth Client Password with your iBanFirst account
Not an Administrator of your Claude account? See I don't have admin access to add the connector — what should I do?
Example use cases
See the iBanFirst MCP in action:
- Cash position check — ask "What's my EUR wallet balance today?" to get instant balances without logging into the platform.
- Payment tracking — ask "Show me all payments waiting for signature" to catch bottlenecks before they delay a transfer.
- FX rate monitoring — ask "What's the current EURUSD rate?" before booking a trade.
- Financial reporting in Excel — ask Claude to pull your latest financial movements directly into an Excel file for reconciliation.
Available tools
The connector exposes the following tools to your AI assistant, grouped by domain.
Wallets
| Tool | Description |
|---|---|
get_wallets | List all iBanFirst wallets. Optionally filter by 3-letter currency code (e.g. EUR, USD). |
get_wallet_details | Get full details of a wallet (IBAN, bank info, holder) by wallet ID. |
get_wallet_balance | Get the balance of a wallet on a specific date (YYYY-MM-DD). |
Financial movements
| Tool | Description |
|---|---|
get_financial_movements | List transaction history from the last 12 months only (older history is unavailable). Optionally filter by wallet, date range, and sort order. |
get_financial_movement_details | Get full details of a specific financial movement by ID. |
Payments
| Tool | Description |
|---|---|
get_payments_by_status | List payments filtered by status (all, planified, finalized, rejected, canceled, refused, blocked, waitingconfirmation, waitingsignature). |
get_payment_details | Get full details of a payment by its ID. |
get_payment_options | Get available payment options and fee estimates for a given wallet and external bank account. |
FX rates & trades
| Tool | Description |
|---|---|
get_fx_rates | Get a live indicative FX rate for a currency pair (e.g. EURUSD, GBPEUR). |
get_trades | List spot FX trades (settle instantly). Filter by status and date range. |
get_trade_details | Get full details of a specific trade by its ID. |
Fix-forward trades
| Tool | Description |
|---|---|
get_fix_forwards | List booked and executed fix-forward contracts — locks an FX rate today for a future settlement date (paginated). |
get_fix_forward | Get details of a specific fix-forward trade by ID. |
Beneficiaries
| Tool | Description |
|---|---|
get_external_bank_accounts | Retrieve the list of all beneficiaries referenced with your iBanFirst accounts. Optionally filter by 3-letter ISO currency code. |
get_external_bank_account_by_id | Get details of an external bank account by ID. |
Session
| Tool | Description |
|---|---|
disconnect_ibanfirst_mcp | Disconnect the current account from the MCP connector, ending the session immediately. See I want to fully disconnect my account below. |
FAQ
Why does the connector show "Authentication failed"?
This usually means your Token Client ID or Token Client Password was entered incorrectly. Double-check both values in your iBanFirst platform settings under API Access and re-enter them in the connector form. Make sure there are no leading or trailing spaces.
The connector connects successfully but returns no data — why?
Your OAuth credentials may not have the required API scopes enabled. Contact your iBanFirst account administrator to verify that your API client has read access to wallets, payments, and FX rates.
I get a "Connection timeout" or "Server unreachable" error
This can happen due to network restrictions (VPN, corporate firewall) blocking outbound requests to api.ibanfirst.com. Ask your IT team to whitelist that domain on port 443.
The MCP connector disconnects after a short period
Access tokens expire after a set period. Claude should refresh the token automatically — if it does not, try disconnecting and reconnecting the connector, then authenticate again with your credentials.
I don't see the "iBanFirst App MCP" connector in the list
The connector may not yet be available in your region or your Claude plan. Ensure you are using a Claude plan that supports custom connectors, and check that you are searching for the exact name "iBanFirst App MCP".
I don't have admin access to add the connector — what should I do?
If your organization uses a Claude Enterprise plan, custom connectors can only be added by your Claude Code admin console administrator. Ask your IT admin to add the iBanFirst MCP connector as a custom connector once, using the URL https://mcp.ibanfirst.com/mcp. This is a one-time setup — once the connector is added at the organization level, every user can connect it individually with their own Token ID and Token Password.
I can't create an Token on the iBanFirst platform
Make sure you have Administrator rights on your iBanFirst account and that the API feature is activated for your account. If you don't have Administrator rights, ask your Account Manager at iBanFirst.
I manage several companies on iBanFirst but the MCP only shows me one — why?
Each MCP token is tied to a single Company on the iBanFirst platform. The connector only exposes data for the company linked to the credentials you used to connect — it cannot see wallets, payments, or beneficiaries belonging to your other companies. To switch companies, ask the MCP to disconnect, then reconnect using an MCP token generated for the other company.
Claude Code says the MCP is not connected when working with my Excel file
If Claude Code returns an error stating the MCP is not connected while you're working on an Excel file, the file may be locked by Excel while it's open. Save your work, close the Excel file completely, and reopen it before running the command again. This forces Excel to release its lock and lets the MCP reconnect properly.
Which Claude model should I use with the iBanFirst MCP?
All Claude models work well with our MCP — pick whichever one suits your needs.