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.
The same connector works with several AI assistants. Pick yours to get the setup steps:
| AI assistant | Surfaces | Setup guide |
|---|---|---|
| Claude (Anthropic) | Claude.ai (Web), Claude Desktop, Claude Code | Use the iBanFirst MCP with Claude |
| ChatGPT (OpenAI) | chatgpt.com (Web), ChatGPT Desktop | Use the iBanFirst MCP with ChatGPT |
| Hermes Agent (Nous Research) | CLI, desktop app, messaging platforms | Use the iBanFirst MCP with Hermes Agent |
Before you start
Whatever assistant you use, you need:
- The connector URL: https://mcp.ibanfirst.com/mcp
- Your iBanFirst MCP credentials: a Token ID and a Token Password, generated on the iBanFirst platform under API Access. See I can't create a Token on the iBanFirst platform if the option is not available to you.
- An AI plan that supports custom connectors — see the requirements on the Claude, ChatGPT or Hermes Agent page.
No OAuth client ID or client secret is required: your AI assistant registers itself with the iBanFirst MCP server automatically.
How the connection works
The connection flow is the same for every AI assistant:
- You add the connector URL in your AI assistant and click Connect.
- Your AI assistant opens the iBanFirst login page in your browser.
- You enter your iBanFirst Token ID and Token Password. They are checked against the iBanFirst API.
- You are sent back to your AI assistant, which now holds a temporary access token — never your password.
- Your AI assistant renews that access token silently in the background. You stay connected for up to 7 days before you are asked to log in again.
Your iBanFirst credentials are entered only on the iBanFirst login page. They are never shared with Claude, ChatGPT or any other AI provider. Each connection is bound to the AI assistant that opened it: a session opened in Claude cannot be reused by ChatGPT, and vice versa.
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 your assistant to pull your latest financial movements directly into an Excel file for reconciliation. See MCP + Excel.
Available tools
The connector exposes the following tools to your AI assistant, grouped by domain. They are identical in Claude and ChatGPT.
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. |
FAQ
These questions apply to every AI assistant. For assistant-specific issues, see the Claude FAQ, the ChatGPT FAQ or the Hermes Agent FAQ.
Why does the login page show "Invalid credentials"?
Your Token ID or Token Password was entered incorrectly. Double-check both values in your iBanFirst platform settings under API Access and enter them again. Make sure there are no leading or trailing spaces.
The connector connects successfully but returns no data — why?
Your 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 mcp.ibanfirst.com or api.ibanfirst.com. Ask your IT team to whitelist those domains on port 443.
My assistant asks me to log in again
Access tokens are renewed automatically, but a full login is required again after 7 days, or as soon as your Token Password changes. Click Connect (or Reconnect) in your assistant and enter your credentials on the iBanFirst login page.
Can I use the connector in Claude and ChatGPT at the same time?
Yes. Connect each assistant separately — you log in once on the iBanFirst login page for each of them. Each connection is independent: disconnecting one does not disconnect the other.
I can't create a 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.
I want to fully disconnect my account, but disconnecting doesn't seem to work
Ask your assistant to call the disconnect_ibanfirst_mcp tool (for example "Disconnect my iBanFirst account"). This ends the session on the iBanFirst side immediately. Then remove or disconnect the connector in your assistant's settings so it stops trying to reconnect.
Can the MCP connector make payments or change my account on my behalf?
No. The MCP connector is strictly read-only. It can only retrieve data — wallet balances, transaction history, payment status, FX rates, trades, and beneficiary details — for your AI assistant to consult. No payment initiation, beneficiary creation, account modification, or transaction execution can be performed through the MCP. Any action that moves funds or changes your account must be completed manually on the secured iBanFirst platform (platform.ibanfirst.com).
What are the terms for using this connector with a third-party AI (Claude, ChatGPT, etc.)?
iBanFirst's role is limited to providing API access — how a third-party AI provider processes your data once transmitted is outside iBanFirst's control. See the Important notice — Third-Party AI integration in the Excel guide for full details.
Who do I contact for a technical issue?
For any technical issue not covered here, contact the iBanFirst production support team at it-production@ibanfirst.com.