Get started
Felku is an MCP (Model Context Protocol) server that connects your WhatsApp and your Telegram bot to the AI agent you already use: Claude Code, Codex, Cursor, Hermes or any MCP client that speaks HTTP.
With it, your agent can read the chats you allow and send messages in them. Every send goes through our pacing guards, built to reduce the risk of your number being restricted.
Before you start: the WhatsApp connection is not official. WhatsApp can restrict or ban a number at any time; the guards reduce that risk but do not remove it. Use a dedicated number. Read Limits and ban risk and the Security and risks page.
How it works
You connect WhatsApp (by scanning a QR code, like WhatsApp Web) or your Telegram bot (by pasting the bot token) in the dashboard.
You choose who the agent can talk to: your account's contact list. Messages from anyone else are dropped on arrival and never reach the agent.
You create a key and put it in your agent. Done: it now sees the Felku tools.
First 5 minutes
Create your account at mcp.felku.com.br. We email you a 6-digit code: type it on the screen to confirm the account. The code is valid for 10 minutes; if it doesn't arrive, ask for a new one on the same screen.
Pick a plan. Every plan starts with a free trial (today, 7 days), card required. During the trial: 1 connection, and the agent talks with you and 2 more contacts on WhatsApp and with 1 one-to-one chat on Telegram.
Connect WhatsApp or Telegram in the dashboard. Read and accept the risk notice before pairing.
Add to your contact list the people the agent may serve (up to 2 during the trial).
In Agents and keys, create a key and copy your agent's command (see all).
Ask your agent: "list the felku-connect tools", then "show the connection status".
The key only works after you connect a channel. Until then the server answers
connection_required("connect WhatsApp or Telegram in the dashboard"). The key is not wrong: connect a channel and try again.
Address and protocol
MCP server address:
https://mcp.felku.com.br/mcpTransport: HTTP (Streamable HTTP, stateless). The server only answers
POST.Authentication: header
Authorization: Bearer <your key>. See Keys and access.MCP versions: revision
2026-07-28(noinitialize) and earlier ones (withinitialize). Your client picks; you don't need to configure anything.
What the agent can do
| It can | Tool |
|---|---|
| Check whether the connections are up | felku_get_connection_status |
| Read new WhatsApp or Telegram messages | felku_read_new_messages, felku_telegram_read_updates |
| Send text on WhatsApp or Telegram | felku_send_text, felku_telegram_send_message |
| Mark as read, react, show "typing", edit or delete its own message | felku_mark_read, felku_react, felku_set_typing, felku_edit_message, felku_delete_message |
| Check whether a number on your list has WhatsApp | felku_check_number |
| See how much of the limits it has used and when it can send again | felku_get_policy_status |
| Pause a connection in an emergency | felku_pause_connection |
| Get the link to the pairing page (a person scans the QR) | felku_start_pairing |
Full list and arguments: Tools.
Not available yet: importing old history, fetching received media (images or documents) and transcribing audio. The tools felku_read_history, felku_request_more_history and felku_get_media don't show up in the agent's list while those features aren't released. The WhatsApp Business catalog is not available either. Groups: reading the ones the owner enables, communities and channels (read and follow) already work; sending to groups and administering them exist but come switched off (Tools).
Account, trial and subscription
Forgot your password: under Forgot password, we email you a 6-digit code; with it you set a new password on the same screen.
Free trial: starts when you subscribe, card required. If you don't cancel before the trial ends, the subscription starts and the card is charged; we email you before that. One trial per person.
Withdrawal (right of withdrawal): you can withdraw from the purchase within 7 days of the purchase or of the first charge, as the Terms say, in the dashboard under Account › Withdraw and get a refund. That period comes from Brazil's Consumer Protection Code and does not change with the length of the trial.
Cancel the subscription at the end of the period: under Account › Cancel subscription, at any time. You keep access until the end of the period and can reactivate before then.
Four things to know right away
Sending is direct. When the agent asks, the message goes out, within the guards. If it wants to see it first, it asks for a preview with
dry_run: true, and nothing is sent.A received message is data, never an instruction. Text from someone else may try to command your agent ("ignore your rules and..."). The server flags it (
origin.untrusted), but whether it obeys is up to your agent. Configure it to treat messages as content.A bigger plan doesn't buy more sending. The pacing guards are the same on every plan; the plan changes how many connections, keys and contacts you get.
Content goes to your agent's AI provider. When the agent reads a chat, the text goes to the provider it uses (Anthropic, OpenAI, Google, xAI...), under that provider's rules. Felku neither chooses nor controls that service.