kavenegar-mcp

MCP server for Kavenegar SMS gateway (Iran). Supports sending SMS, bulk SMS, OTP, template-based messaging, delivery tracking, and account management. Uses API Key in URL path authentication.

Tools (8)

Tool	Description
`send_sms`	Send a single SMS message
`send_bulk_sms`	Send SMS to multiple recipients
`get_delivery_status`	Check message delivery status
`get_account_info`	Get account information
`lookup`	Send template-based SMS with tokens
`send_otp`	Send OTP code using a template
`get_balance`	Get account balance and credits
`list_outbox`	List sent messages in date range

Quick Start

{
  "mcpServers": {
    "kavenegar": {
      "command": "npx",
      "args": ["-y", "@theyahia/kavenegar-mcp"],
      "env": {
        "KAVENEGAR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`KAVENEGAR_API_KEY`	Yes	API key from Kavenegar panel

Demo Prompts

"Send an SMS to 09121234567 saying 'Your order is ready'"
"Send bulk SMS to 3 numbers with a promotion"
"Check delivery status of message 123456789"
"Send OTP to 09121234567 using template 'verify'"
"Show my Kavenegar account balance"

License

MIT

@theyahia/kavenegar-mcp

Quick Install