SendKuy
Send WhatsApp, SMS and email, verify OTP codes and run campaigns with SendKuy.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@sendkuy/mcpclaude mcp add sendkuy -e 'SENDKUY_API_KEY=<your sendkuy_api_key>' -- npx -y @sendkuy/mcp@1.0.0
{
"mcpServers": {
"sendkuy": {
"command": "npx",
"args": [
"-y",
"@sendkuy/mcp@1.0.0"
],
"env": {
"SENDKUY_API_KEY": "<your sendkuy_api_key>"
}
}
}
}
متغيرات البيئة
SENDKUY_API_KEYسري SendKuy API key from https://app.sendkuy.com/user/api. Needs account:read plus the scopes of the tools you want.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
SendKuy MCP server
Give AI assistants and agents a way to reach people: send WhatsApp, SMS and email, verify OTP codes and run campaigns through your SendKuy account.
Use it while you build an integration ("send a test OTP to my number", "why is my webhook failing?"), or as the notification step of an agent that runs on its own: an on-call alert, a daily revenue summary, an order update per customer.
Full guide with scenarios: docs.sendkuy.com/mcp
Get a key
Create an API key at app.sendkuy.com/user/api. Give it account:read plus the scopes of the tools you want, and nothing more. The server lists only the tools your key can use, so a key with read scopes never sees a tool that sends.
Install
Claude Code:
claude mcp add --transport stdio --env SENDKUY_API_KEY=sk_live_YOUR_API_KEY sendkuy -- npx -y @sendkuy/mcp
Cursor (.cursor/mcp.json), Windsurf and Claude Desktop:
{
"mcpServers": {
"sendkuy": {
"command": "npx",
"args": ["-y", "@sendkuy/mcp"],
"env": { "SENDKUY_API_KEY": "sk_live_YOUR_API_KEY" }
}
}
}
VS Code (.vscode/mcp.json):
{
"inputs": [
{
"type": "promptString",
"id": "sendkuy-key",
"description": "SendKuy API key",
"password": true
}
],
"servers": {
"sendkuy": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@sendkuy/mcp"],
"env": { "SENDKUY_API_KEY": "${input:sendkuy-key}" }
}
}
}
Claude Desktop can also install sendkuy-mcp.mcpb from the latest release with one click.
Tools
| Tool | What it does | Scopes |
|---|---|---|
sendkuy_get_account | Plan, credits per channel, usage this period, the key's scopes | account:read |
sendkuy_send_message | One body to 1–100 recipients, contacts or a group, on one channel | messages:write |
sendkuy_send_batch | Up to 500 messages with different content, answered row by row | messages:write |
sendkuy_get_messages | Status of up to 20 messages by id | messages:read |
sendkuy_list_messages | Recent messages by channel, status and time | messages:read |
sendkuy_cancel_message | Cancel a message not sent yet | messages:write |
sendkuy_send_verification | Send an OTP code | verifications:write |
sendkuy_check_verification | Check the code a user typed | verifications:write |
sendkuy_check_whatsapp_numbers | Which numbers are on WhatsApp | numbers:read |
sendkuy_find_contacts | A contact by phone or external_id | contacts:read |
sendkuy_list_templates | Saved message templates | templates:read |
sendkuy_list_groups | Contact groups and their size | groups:read |
sendkuy_list_campaigns | Campaigns prepared in the dashboard | campaigns:read |
sendkuy_start_campaign | Start a campaign | campaigns:write |
sendkuy_get_campaign | Progress and delivery stats | campaigns:read |
sendkuy_control_campaign | Pause, resume or cancel | campaigns:write |
sendkuy_list_webhook_deliveries | Webhooks and their latest delivery attempts | webhooks:read |
Tools that send really send and spend credit. They take an optional dedupe_key: an agent that repeats a step with the same key gets the first answer back instead of sending twice.
Examples
- On-call alert. "When the health check fails, WhatsApp the on-call group with the service name and the error." The agent sends to the group's
grp_id withdedupe_keyset to the incident id. - Daily revenue summary. "Every evening, send each branch manager their own numbers." One
sendkuy_send_batchcall, a different body per manager. - Debugging an integration. "Which WhatsApp messages failed in the last hour, and why?"
sendkuy_list_messages, thensendkuy_list_webhook_deliveries.
Configuration
| Variable | |
|---|---|
SENDKUY_API_KEY | Your API key. Without it the server still starts and lists its tools, and every call answers with an error until you set it. |
SENDKUY_BASE_URL | Only for a proxy or a mock server in tests. Defaults to https://app.sendkuy.com/api/v1. |
License
MIT
الأسئلة الشائعة
ما هو SendKuy؟
Send WhatsApp, SMS and email, verify OTP codes and run campaigns with SendKuy.
كيف أثبّت SendKuy؟
يعمل على جهازك. في Claude Code: claude mcp add sendkuy -e 'SENDKUY_API_KEY=<your sendkuy_api_key>' -- npx -y @sendkuy/mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج SendKuy إلى مفتاح API؟
نعم. يتطلب SENDKUY_API_KEY، وتضبطها في إعداداته.
هل SendKuy مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون SendKuy؟
ينشره sendkuy. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.