{"templateId":"markdown","sharedDataIds":{},"props":{"codeGuideFiles":[],"seo":{"title":"iBanFirst MCP Connector","description":"iBanFirst is the groundbreaking API that allows you to navigate, manipulate, and control iBanFirst applications."},"dynamicMarkdocComponents":[],"metadata":{"type":"markdown"},"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ibanfirst-mcp-connector"},"children":["iBanFirst MCP Connector"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-the-mcp"},"children":["Connect the MCP"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude.ai-web"},"children":["Claude.ai (Web)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://claude.ai"},"children":["claude.ai"]}," and expand the sidebar"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customize"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connectors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Connector"]}," and search for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"iBanFirst App MCP\""]}," in the connector list"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}," and enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client Password"]}," with your iBanFirst account"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude-desktop"},"children":["Claude Desktop"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Claude Desktop"]}," on your desktop"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customize"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connectors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Connector"]}," and search for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"iBanFirst App MCP\""]}," in the connector list"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}," and enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth Client Password"]}," with your iBanFirst account"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-tools"},"children":["Available tools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The connector exposes the following tools to your AI assistant, grouped by domain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"wallets"},"children":["Wallets"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_wallets"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List all iBanFirst wallets. Optionally filter by 3-letter currency code (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EUR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_wallet_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get full details of a wallet (IBAN, bank info, holder) by wallet ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_wallet_balance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get the balance of a wallet on a specific date (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]},")."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"financial-movements"},"children":["Financial movements"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_financial_movements"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List transaction history. Optionally filter by wallet, date range, and sort order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_financial_movement_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get full details of a specific financial movement by ID."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payments"},"children":["Payments"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_payments_by_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List payments filtered by status (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["all"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["planified"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalized"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rejected"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refused"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blocked"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["waitingconfirmation"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_payment_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get full details of a payment by its ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_payment_options"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get available payment options and fee estimates for a given wallet and external bank account."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fx-rates--trades"},"children":["FX rates & trades"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_fx_rates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get current FX rates for a currency pair (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EURUSD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GBPEUR"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_trades"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List FX trades. Filter by status and date range."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_trade_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get full details of a specific trade by its ID."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fix-forward-trades"},"children":["Fix-forward trades"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_fix_forwards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List active fix-forward trades (paginated)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_fix_forward"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get details of a specific fix-forward trade by ID."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"beneficiaries"},"children":["Beneficiaries"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_external_bank_accounts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve the list of all beneficiaries referenced with your iBanFirst accounts. Optionally filter by 3-letter ISO currency code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_external_bank_account_by_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get details of an external bank account by ID."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"documents"},"children":["Documents"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_documents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List documents available on the account (paginated)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_document_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get full details of a specific document by ID (name, type, MIME type, download link)."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"faq"},"children":["FAQ"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-does-the-connector-show-authentication-failed"},"children":["Why does the connector show \"Authentication failed\"?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This usually means your OAuth Client ID or OAuth Client Password was entered incorrectly. Double-check both values in your iBanFirst platform settings under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Access"]}," and re-enter them in the connector form. Make sure there are no leading or trailing spaces."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-connector-connects-successfully-but-returns-no-data--why"},"children":["The connector connects successfully but returns no data — why?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"i-get-a-connection-timeout-or-server-unreachable-error"},"children":["I get a \"Connection timeout\" or \"Server unreachable\" error"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This can happen due to network restrictions (VPN, corporate firewall) blocking outbound requests to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api.ibanfirst.com"]},". Ask your IT team to whitelist that domain on port 443."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-mcp-connector-disconnects-after-a-short-period"},"children":["The MCP connector disconnects after a short period"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["OAuth 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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"i-dont-see-the-ibanfirst-app-mcp-connector-in-the-list"},"children":["I don't see the \"iBanFirst App MCP\" connector in the list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"iBanFirst App MCP\""]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"i-need-further-assistance"},"children":["I need further assistance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For any technical issue not covered above, contact the iBanFirst production support team at ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:it-production@ibanfirst.com"},"children":["it-production@ibanfirst.com"]},"."]}]},"headings":[{"value":"iBanFirst MCP Connector","id":"ibanfirst-mcp-connector","depth":1},{"value":"Connect the MCP","id":"connect-the-mcp","depth":2},{"value":"Claude.ai (Web)","id":"claude.ai-web","depth":3},{"value":"Claude Desktop","id":"claude-desktop","depth":3},{"value":"Available tools","id":"available-tools","depth":2},{"value":"Wallets","id":"wallets","depth":3},{"value":"Financial movements","id":"financial-movements","depth":3},{"value":"Payments","id":"payments","depth":3},{"value":"FX rates & trades","id":"fx-rates--trades","depth":3},{"value":"Fix-forward trades","id":"fix-forward-trades","depth":3},{"value":"Beneficiaries","id":"beneficiaries","depth":3},{"value":"Documents","id":"documents","depth":3},{"value":"FAQ","id":"faq","depth":2},{"value":"Why does the connector show \"Authentication failed\"?","id":"why-does-the-connector-show-authentication-failed","depth":3},{"value":"The connector connects successfully but returns no data — why?","id":"the-connector-connects-successfully-but-returns-no-data--why","depth":3},{"value":"I get a \"Connection timeout\" or \"Server unreachable\" error","id":"i-get-a-connection-timeout-or-server-unreachable-error","depth":3},{"value":"The MCP connector disconnects after a short period","id":"the-mcp-connector-disconnects-after-a-short-period","depth":3},{"value":"I don't see the \"iBanFirst App MCP\" connector in the list","id":"i-dont-see-the-ibanfirst-app-mcp-connector-in-the-list","depth":3},{"value":"I need further assistance","id":"i-need-further-assistance","depth":3}],"frontmatter":{"seo":{"title":"iBanFirst MCP Connector"}},"lastModified":"2026-06-12T12:27:04.000Z"},"slug":"/guides/mcp-connector","userData":{"isAuthenticated":false,"teams":["anonymous"]}}