Hermes Agent
Run your Asyntai AI chatbot from the Hermes AI agent
Overview
Hermes Agent is an open source AI agent by Nous Research. The Asyntai plugin connects Hermes to the Asyntai MCP server, so you can run your chatbot from the Hermes chat: add knowledge, crawl a site, change the widget, read conversations and leads, and reply live to visitors.
What You Can Ask For
- "Which websites are on my Asyntai account, and what plan am I on?"
- "Add this text about our opening hours to my chatbot's knowledge."
- "Show me what visitors asked my chatbot this week."
- "List my leads from the last 7 days."
- "Change the widget color to black."
Install the Plugin
Check Node.js
The plugin starts the Asyntai connector with npx, so it needs Node.js 18 or newer. Run node --version to check.
Install and Enable
Run these two commands:
hermes plugins install asyntai
hermes plugins enable asyntai
Start a New Chat
Start a new Hermes session. The 73 Asyntai tools load when the session starts, with names that begin with mcp__asyntai__.
Sign In
The first time Hermes calls an Asyntai tool, your browser opens the Asyntai sign-in page. Sign in and click to approve the connection. The access is saved in ~/.asyntai/mcp-credentials.json, so you do not sign in again in later sessions.
To sign out on that computer, run npx @asyntai/mcp logout. You can also remove the connection at any time on the connections page.
Need an Account?
You sign in with your Asyntai account. Create an account if you do not have one. The free plan works.
Approvals
The plugin marks the Asyntai server as untrusted in Hermes. Hermes runs read tools at once, and it asks you before every tool that changes something, such as adding knowledge, editing instructions or sending a reply to a visitor. In a cron job or another unattended run, Hermes refuses those tools.
What the Plugin Can Do
The plugin gives Hermes all the tools of the Asyntai MCP server. The MCP documentation lists them, with the plans and limits that apply.
If the Tools Do Not Load
- Run
hermes plugins listand check that asyntai shows as enabled. - Start a new session after you enable the plugin. Changes do not apply to a session that is already open.
- The first start downloads the connector from npm, which can take a minute. If the first session shows no Asyntai tools, start one more session.
- Sign in once on a computer with a browser before you use the plugin on a server.
Need Help?
If you have any questions or run into issues, contact us at [email protected].