Cursor · AI app (MCP)
Your WhatsApp data, inside Cursor
Add Fliok’s MCP address and a scoped Fliok API key to Cursor. Its agent can then read your chats, templates and leads, and act within the key’s scopes.
Pro and upScoped API keyRevoke any time
# the address and a scoped Fliok key
url: https://fliok.com/api/mcp
Authorization: Bearer wa_••••> show today’s unanswered WhatsApp chats
● fliok · reads chats (read-only)
3 waiting:
Meera Kapoor unassigned · 42 min
Rahul Mehta Riya · 1 h
Asha Rao Arjun · 3 hHow many messages did we send this week?
What you can ask
Ask Cursor, 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“Which of our templates are approved?”
Reads your templates and Meta’s approval status, so your code uses a template that will send.
Setup
Connect Cursor in 3 steps
- 1Make an API key for Cursor in Fliok (Settings → Integrations → AI apps → Create a key) and set it as FLIOK_API_KEY in your shell.
- 2Add this to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project).
- 3Open Cursor Settings → MCP and check that Fliok shows its tools.
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/mcp{
"mcpServers": {
"fliok": {
"url": "https://fliok.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:FLIOK_API_KEY}"
}
}
}
}Good to know
- 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 you need, then add Fliok to Cursor’s MCP settings 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. Cursor can’t use the key after that.
Build with Fliok, from Cursor
Start on the Free plan. Using Fliok from Cursor needs Pro or higher.
Free forever plan · Keep your WhatsApp app