Grok (xAI API) · AI app (MCP)
Grok, with Fliok’s tools
Building on Grok? In your requests to xAI’s API, add Fliok as a remote MCP tool with its address and a scoped API key, and Grok can use Fliok’s tools.
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?
This is for developers using xAI’s API. The Grok app is not covered.
What you can ask
Ask Grok, 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 Grok in 3 steps
- 1Make an API key in Fliok for Grok — Read only is the safe start.
- 2Pass Fliok as a remote MCP tool in your xAI API request (the Responses API at https://api.x.ai/v1/responses, or mcp(...) in the xai-sdk). Grok calls Fliok's tools from xAI's servers.
- 3Put the key in authorization exactly as shown; Fliok accepts it with or without the word Bearer.
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{
"model": "YOUR_GROK_MODEL",
"input": [
{
"role": "user",
"content": "Which WhatsApp chats in Fliok are waiting for a reply?"
}
],
"tools": [
{
"type": "mcp",
"server_url": "https://fliok.com/api/mcp",
"server_label": "fliok",
"authorization": "wa_YOUR_FLIOK_KEY"
}
]
}Good to know
- It works through xAI’s API, for developers building on Grok, not in the Grok app.
- 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 app needs. In your request to xAI’s API, add Fliok as a remote MCP tool with the address https://fliok.com/api/mcp and the key. The MCP guide has the exact shape.
No. It is for developers who call xAI’s API, where Fliok is added as a remote MCP tool.
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. Grok can’t use the key after that.
Build on Grok with Fliok
Start on the Free plan. Using Fliok from Grok needs Pro or higher.
Free forever plan · Keep your WhatsApp app