# اس‌ام‌اس دات آی‌آر (SMS.ir)

ارسال پیامک و کد تأیید از حساب SMS.ir، گزارش تحویل، پیامک‌های دریافتی و مانده اعتبار؛ ارسال پیش‌فرض خاموش است

- نوع: سرور MCP
- دسته: پیامک و پیام‌رسان
- منبع: جامعه
- سازنده: ali.toghiani.dev (https://github.com/ali-toghiani)
- مجوز: MIT
- زبان: Python
- آخرین بررسی: 2026-10-16
- صفحه: https://mcpfarsi.ir/servers/sms-ir/
- مخزن: https://github.com/ali-toghiani/sms-ir-mcp
- وب‌سایت سرویس: https://sms.ir

## هشدارها

- نیاز به کلید API: برای کار کردن، کلید حساب خودتان در این سرویس لازم است.
- تغییر در حساب شما: بعضی ابزارهایش کاری انجام می‌دهند (مثلاً پیام می‌فرستند)، نه فقط خواندن.

## نصب

- اجرا (stdio): `python -m sms_ir_mcp --transport stdio`
- این سرور بستهٔ آماده ندارد. مخزن را با git clone بگیرید، در پوشهٔ آن یک محیط مجازی پایتون (python -m venv .venv) بسازید و pip install -e . را اجرا کنید. بعد در تنظیمات، به‌جای python مسیر کامل پایتونِ .venv را بگذارید. پایتون ۳.۱۰ یا بالاتر لازم است.
- متغیر محیطی `SMSIR_API_KEY` (لازم، محرمانه): کلید API؛ رمزی که SMS.ir در پنل کاربری‌تان به شما می‌دهد
- متغیر محیطی `SMSIR_DEFAULT_LINE_NUMBER` (اختیاری): خط پیش‌فرض ارسال (اختیاری)
- متغیر محیطی `SMSIR_ALLOW_SEND` (اختیاری): تا true نباشد هیچ پیامکی فرستاده نمی‌شود

## ابزارها

- `get_balance`: مانده اعتبار پیامک
- `list_lines`: خط‌های ارسال حساب
- `get_message_report`: وضعیت تحویل یک پیامک ارسال‌شده
- `get_pack_report`: نتیجهٔ ارسال برای هر گیرنده در یک ارسال گروهی
- `list_sent_messages`: پیامک‌های ارسال‌شدهٔ امروز یا بایگانی
- `list_sent_packs`: ارسال‌های گروهی امروز یا بایگانی
- `list_inbound_messages`: پیامک‌های دریافتی
- `extract_latest_otp`: پیدا کردن آخرین کد یک‌بارمصرف در پیامک‌های دریافتی
- `health_check`: بررسی اتصال و درستی کلید، بدون هزینه
- `reload_config`: خواندن دوبارهٔ تنظیمات بدون راه‌اندازی دوباره
- `send_sms`: ارسال یک متن به یک یا چند گیرنده (هزینه دارد)
- `send_verification_code`: ارسال کد تأیید با قالب (هزینه دارد)
- `send_personalized_sms`: ارسال متن جداگانه برای هر گیرنده (هزینه دارد)
- `cancel_scheduled_send`: لغو یک ارسال زمان‌بندی‌شده که هنوز انجام نشده

## نمونه پرسش‌ها

- مانده اعتبار پیامک حسابم در SMS.ir چقدر است؟
- پیامک‌هایی که امروز فرستادم تحویل شده‌اند؟
- آخرین کد تأییدی که روی خط من آمده چیست؟

## توضیحات

با این ابزار، دستیار هوش مصنوعی شما به حساب SMS.ir وصل می‌شود: مانده اعتبار و خط‌های ارسال را می‌بیند، گزارش تحویل پیامک‌ها و پیامک‌های دریافتی را می‌خواند و در صورت اجازهٔ شما پیامک یا کد تأیید می‌فرستد. SMS.ir از سامانه‌های پیامک ایران است.

ارسال پیامک هزینه دارد و برگشت‌پذیر نیست. این سرور برای همین دو قفل دارد: تا SMSIR_ALLOW_SEND را true نکنید هیچ پیامکی فرستاده نمی‌شود، و هر ارسال هم باید جداگانه تأیید شود. لغو ارسال زمان‌بندی‌شده هم تأیید لازم دارد. باز هم از برنامه‌ای استفاده کنید که پیش از اجرای هر قابلیت از شما تأیید می‌گیرد.

- سرور روی کامپیوتر شما اجرا می‌شود و از API رسمی SMS.ir استفاده می‌کند، اما سازندهٔ آن یک توسعه‌دهندهٔ مستقل است.
- شماره‌ها، متن پیامک‌ها، کلید و کدهای تأیید در گزارش‌های سرور پوشانده می‌شوند.
- سرور در دقیقه حداکثر ۶۰ درخواست می‌فرستد؛ برای ارسال‌های پرتعداد، `SMSIR_RATE_LIMIT_PER_MINUTE` را بیشتر کنید.