{"templateId":"markdown","sharedDataIds":{},"props":{"codeGuideFiles":[],"seo":{"title":"Use the iBanFirst MCP with Hermes Agent","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":"use-the-ibanfirst-mcp-with-hermes-agent"},"children":["Use the iBanFirst MCP with Hermes Agent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/mcp-connector"},"children":["iBanFirst MCP Connector"]}," to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://hermes-agent.nousresearch.com/"},"children":["Hermes Agent"]},", the open-source AI agent from Nous Research, and ask questions about your wallets, payments, and FX rates in plain language, from the Hermes CLI, desktop app or any messaging platform it is connected to."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you start, make sure you have your iBanFirst ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token Password"]}," (see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/mcp-connector#before-you-start"},"children":["Before you start"]},")."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements"},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Hermes Agent"]}," installed. MCP support ships with the standard install. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://hermes-agent.nousresearch.com/"},"children":["Hermes Agent website"]}," for installers, or run:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A browser on the same machine to complete the iBanFirst login. For remote or headless setups, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp#oauth-authenticated-http-servers"},"children":["Hermes MCP documentation"]},"."]}]}]},{"$$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":"1.-add-the-ibanfirst-server-to-your-hermes-config"},"children":["1. Add the iBanFirst server to your Hermes config"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.hermes/config.yaml"]}," and add the following section:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"mcp_servers:\n  ibanfirst_mcp:\n    url: \"https://mcp.ibanfirst.com/mcp\"\n    auth: oauth\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your file already has an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp_servers"]}," section, add only the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ibanfirst_mcp"]}," entry under it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No OAuth client ID or client secret is needed: Hermes registers itself with the iBanFirst MCP server automatically."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2.-log-in-to-ibanfirst"},"children":["2. Log in to iBanFirst"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Start Hermes (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hermes chat"]},"), or run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/reload-mcp"]}," in a running session"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Hermes prints an authorize URL and opens the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["iBanFirst login page"]}," in your browser"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your iBanFirst ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token Password"]},", then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Back in Hermes, the iBanFirst tools are now available"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hermes stores the access token in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.hermes/mcp-tokens/ibanfirst_mcp.json"]}," and renews it silently. You stay connected for up to 7 days before being asked to log in again."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To trigger the login explicitly, run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hermes mcp login ibanfirst_mcp"]}," from a terminal."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-it"},"children":["Use it"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ask Hermes in natural language, for example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"List my iBanFirst wallets and their balances.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Show me all payments waiting for signature.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"What's the EUR/USD rate on iBanFirst right now?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Every Monday morning, send me my EUR and USD balances.\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The full list of tools is in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/mcp-connector#available-tools"},"children":["Available tools"]},". All tools are read-only."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"faq"},"children":["FAQ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For questions common to every AI assistant (login, credentials, multiple companies, read-only access), see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/mcp-connector#faq"},"children":["MCP Connector FAQ"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"i-have-trouble-connecting-or-hermes-keeps-failing-to-authenticate"},"children":["I have trouble connecting, or Hermes keeps failing to authenticate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reset the stored iBanFirst token and log in again:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delete the token file:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"rm ~/.hermes/mcp-tokens/ibanfirst_mcp.json\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Hermes Agent prompt, run:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"/reload-mcp\n"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Log in again on the iBanFirst login page with your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token Password"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-ibanfirst-tools-dont-appear-in-hermes"},"children":["The iBanFirst tools don't appear in Hermes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ibanfirst_mcp"]}," entry is correctly indented under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp_servers"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.hermes/config.yaml"]},", then run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/reload-mcp"]}," or start a new session."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-browser-doesnt-open-or-the-login-times-out"},"children":["The browser doesn't open, or the login times out"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy the authorize URL printed by Hermes into your browser manually. If you edited ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["config.yaml"]}," while a session was running, run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hermes mcp login ibanfirst_mcp"]}," from a new terminal instead: it waits up to 5 minutes for you to log in."]}]},"headings":[{"value":"Use the iBanFirst MCP with Hermes Agent","id":"use-the-ibanfirst-mcp-with-hermes-agent","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Connect the MCP","id":"connect-the-mcp","depth":2},{"value":"1. Add the iBanFirst server to your Hermes config","id":"1.-add-the-ibanfirst-server-to-your-hermes-config","depth":3},{"value":"2. Log in to iBanFirst","id":"2.-log-in-to-ibanfirst","depth":3},{"value":"Use it","id":"use-it","depth":2},{"value":"FAQ","id":"faq","depth":2},{"value":"I have trouble connecting, or Hermes keeps failing to authenticate","id":"i-have-trouble-connecting-or-hermes-keeps-failing-to-authenticate","depth":3},{"value":"The iBanFirst tools don't appear in Hermes","id":"the-ibanfirst-tools-dont-appear-in-hermes","depth":3},{"value":"The browser doesn't open, or the login times out","id":"the-browser-doesnt-open-or-the-login-times-out","depth":3}],"frontmatter":{"seo":{"title":"Use the iBanFirst MCP with Hermes Agent"}},"lastModified":"2026-10-07T10:18:45.000Z"},"slug":"/guides/mcp-hermes","userData":{"isAuthenticated":false,"teams":["anonymous"]}}