Hermes · AI app (MCP)
Hermes, working in Fliok
Add Fliok to Hermes as an MCP server with a scoped API key. Hermes runs in Telegram and other chat apps, so you can ask it about your chats from there.
Pro and upScoped API keyRevoke any time
Add Asha Rao, +91 98765 43210, as a lead and tell me who is waiting for a reply
Asha Rao is in your leads as a new lead. 3 chats are waiting: Meera Kapoor (unassigned), Rahul Mehta (Riya) and Asha Rao (Arjun).
# the address and a scoped Fliok key
url: https://fliok.com/api/mcp
Authorization: Bearer wa_••••Show today’s unanswered chats
3 chats are waiting for a reply:
- MMeera KapoorIs the 2 kg box available?Unassigned42 min
- RRahul MehtaWhere is my order?Riya1 h
- AAsha RaoCan you share the menu?Arjun3 h
What you can ask
Ask Hermes, in plain words
Examples, with sample data. The app does only what its tools allow and you approved.
“Show today’s unanswered chats”
Lists the WhatsApp chats waiting for a reply, and who each one is assigned to.
Your AI appShow today’s unanswered chats
Fliok · reads chatsRead-only3 chats are waiting for a reply:
- MMeera KapoorIs the 2 kg box available?Unassigned42 min
- RRahul MehtaWhere is my order?Riya1 h
- AAsha RaoCan you share the menu?Arjun3 h
“Send the order-update template to this customer”
Sends an approved template from your own number, through the same checks as the inbox.
Your AI appSend the order-update template to Rahul Mehta, order ORD-1042
Fliok · sends a templateSends messagesSent order_update to Rahul Mehta from your WhatsApp number. It is queued; you will see it delivered in the inbox.
“Create a lead from this email”
Adds the lead with a name, number and source. A number you already have is never added twice.
Your AI appCreate a lead from this email: Asha Rao, +91 98765 43210, wants a quote for 300 guests
Fliok · adds a leadChanges dataAsha Rao · +91 98765 43210Source: Email · Note: quote for 300 guestsNew lead“How many messages did we send this week?”
Reads message and conversation counts for the period from Fliok’s reports.
Your AI appHow many messages did we send this week?
Fliok · reads reportsRead-onlySent1,284Delivered1,241Read978
Setup
Connect Hermes in 3 steps
- 1Make an API key in Fliok for Hermes.
- 2Add the fliok entry under mcp_servers in ~/.hermes/config.yaml (replace wa_YOUR_FLIOK_KEY with the key).
- 3Run /reload-mcp in Hermes (or restart it); hermes mcp test fliok checks the connection.
A workspace admin creates a Fliok API key with only the scopes the app needs; the app sends it with every call.
https://fliok.com/api/mcpmcp_servers:
fliok:
url: "https://fliok.com/api/mcp"
headers:
Authorization: "Bearer wa_YOUR_FLIOK_KEY"Good to know
- It runs where you set the agent up; Fliok has no Telegram bot of its own.
- A workspace admin creates the API key and picks its scopes; the app can do only what they allow.
- Keep the key out of shared code and chats: anyone holding it can act in Fliok within its scopes.
- No money moves through it: it cannot buy a plan, top up the wallet or change how you pay.
- Messages it sends are ordinary WhatsApp messages: free-form text only inside the 24-hour window, a template outside it, and Meta’s charges as usual.
- Everything the AI app does goes through the same permissions, plan limits, staff restrictions and audit trail as Fliok’s API.
- What the AI app reads through Fliok is handled under that app’s own terms.
Create a Fliok API key with the scopes your agent needs, then add Fliok to Hermes’s MCP servers with the address https://fliok.com/api/mcp and the key. The MCP guide has the exact configuration.
What its tools allow, and only what you approved or gave the key. The tools cover these areas: Chats, Messages, Templates, Contacts, Sales CRM, Broadcasts, Invoices and bookings, Instagram, WhatsApp Pay, Reports, Team, Integrations, Webhooks, Plan and wallet (read only). The MCP guide lists every tool with the permission it needs.
A workspace admin, in Fliok. Give the key only the scopes the app needs; it can never do more than the role it is made for.
Pro and Enterprise: connecting an AI app uses the same developer features as Fliok’s REST API. Free and Basic don’t include them.
No money moves through it: it cannot buy a plan, top up the wallet or change how you pay. Meta’s charges for the WhatsApp messages it sends apply as usual.
Revoke its API key in Fliok, under Settings → Integrations → AI apps or on the API keys page. Hermes can’t use the key after that.
Ask Hermes, work in Fliok
Start on the Free plan. Using Fliok from Hermes needs Pro or higher.
Free forever plan · Keep your WhatsApp app