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»).

NPM package @sendkuy/mcp
Claude Code
claude mcp add sendkuy -e 'SENDKUY_API_KEY=<your sendkuy_api_key>' -- npx -y @sendkuy/mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "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.

المحتويات
  1. SendKuy MCP server
  2. Get a key
  3. Install
  4. Tools
  5. Examples
  6. Configuration
  7. License

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

ToolWhat it doesScopes
sendkuy_get_accountPlan, credits per channel, usage this period, the key's scopesaccount:read
sendkuy_send_messageOne body to 1–100 recipients, contacts or a group, on one channelmessages:write
sendkuy_send_batchUp to 500 messages with different content, answered row by rowmessages:write
sendkuy_get_messagesStatus of up to 20 messages by idmessages:read
sendkuy_list_messagesRecent messages by channel, status and timemessages:read
sendkuy_cancel_messageCancel a message not sent yetmessages:write
sendkuy_send_verificationSend an OTP codeverifications:write
sendkuy_check_verificationCheck the code a user typedverifications:write
sendkuy_check_whatsapp_numbersWhich numbers are on WhatsAppnumbers:read
sendkuy_find_contactsA contact by phone or external_idcontacts:read
sendkuy_list_templatesSaved message templatestemplates:read
sendkuy_list_groupsContact groups and their sizegroups:read
sendkuy_list_campaignsCampaigns prepared in the dashboardcampaigns:read
sendkuy_start_campaignStart a campaigncampaigns:write
sendkuy_get_campaignProgress and delivery statscampaigns:read
sendkuy_control_campaignPause, resume or cancelcampaigns:write
sendkuy_list_webhook_deliveriesWebhooks and their latest delivery attemptswebhooks: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 with dedupe_key set to the incident id.
  • Daily revenue summary. "Every evening, send each branch manager their own numbers." One sendkuy_send_batch call, a different body per manager.
  • Debugging an integration. "Which WhatsApp messages failed in the last hour, and why?" sendkuy_list_messages, then sendkuy_list_webhook_deliveries.

Configuration

Variable
SENDKUY_API_KEYYour 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_URLOnly 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.