SMS8 - SMS GATEWAY using your phone

Server MCP SMS8

Gateway SMS → sms8.io  ·  Gateway SMS MCP untuk vibe coder & developer → mcp.sms8.io

Kirim SMS, terbitkan dan verifikasi OTP, tunggu kode masuk, dan konfigurasikan webhook dari Claude Code, Cursor, Windsurf, OpenCode, dan alat coding AI lainnya yang mendukung Model Context Protocol. SMS dirutekan melalui ponsel Android yang dipasangkan melalui platform SMS8.

Server live: https://mcp.sms8.io Dasbor: https://app.sms8.io Situs pemasaran: https://sms8.io

Mengapa menggunakan ini

Sedang membangun aplikasi dan ingin notifikasi SMS, OTP, pesan dua arah, atau verifikasi telepon agen otonom? Sebagian besar opsi memaksa Anda mendaftar ke program operator, menyediakan nomor telepon, membayar per pesan, atau menyewa SIM sekali pakai per sesi. SMS8 merutekan SMS melalui ponsel yang sudah Anda miliki. Server MCP memberi asisten AI Anda sembilan alat yang dapat dipanggil langsung, sehingga menambahkan SMS ke proyek hanya butuh satu prompt, bukan satu jam kerja integrasi.

Apa yang Anda dapatkan

Alat	Tujuan
setup_sms8	Memvalidasi kunci API, mengembalikan konteks akun dan contoh kode
send_sms	Mengirim satu SMS melalui perangkat Android yang dipasangkan
send_otp	Menghasilkan dan mengirim kode verifikasi
verify_otp	Membandingkan kode yang diketik dengan OTP terbaru yang diterbitkan
wait_for_otp	BARU. Memblokir hingga OTP tiba di Android yang dipasangkan; mengekstrak kodenya
get_messages	Mengembalikan SMS masuk atau terkirim terbaru
list_devices	Mencantumkan perangkat Android yang dipasangkan
get_balance	BARU. Pemeriksaan kredit dan perpanjangan ringan
create_webhook	Mendaftarkan URL callback untuk SMS masuk dan peristiwa pengiriman

Semua alat berbagi jalur pengiriman yang sama dengan dasbor SMS8. Kredit, percobaan ulang, perutean multi-perangkat, dan penandatanganan webhook bekerja identik dengan panggilan API langsung.

SMS8 vs Twilio vs MessageBird

Kemampuan	SMS8	Twilio	MessageBird
Server MCP bawaan	Ya	Tidak	Tidak
Biaya per pesan	Tidak ada	$0,0079+	$0,05+
A2P 10DLC diperlukan	Tidak	Ya	Ya
Penyediaan nomor telepon	Tidak diperlukan	$1+/bln	$2+/bln
Waktu penyiapan	60 detik	Hari hingga minggu	Hari
Verifikasi OTP bawaan	Ya	Layanan ekstra	Layanan ekstra
Kode MCP sumber terbuka	MIT	Tidak	Tidak

Instal melalui npm

Enam paket mencakup setiap alur — pilih yang sesuai dengan proyek Anda.

Paket	Perintah jalankan	Kasus penggunaan
sms8-mcp	npx -y sms8-mcp	Peluncur MCP untuk Claude Code, Cursor, Windsurf, OpenCode
sms8-cli	npx sms8-cli send +1234 "hi"	CLI terminal untuk kirim / OTP / kotak masuk / perangkat
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (pemisah, RTL, masker, render props)
sms-otp-verify	npm i sms-otp-verify	Kode yang sama, nama bertarget SEO untuk pencarian "sms otp verify" / "otp input"
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Plugin Capacitor untuk aplikasi Ionic — iOS Swift + Android Kotlin native + fallback web
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Plugin Cordova untuk aplikasi Ionic — iOS Swift + Android Kotlin native
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	Merek khusus OTP dari CLI yang sama
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	Merek ponsel-sebagai-gateway dari CLI yang sama
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	Merek khusus Android dari CLI yang sama

Contoh MCP (Claude Code, Cursor, Windsurf — bentuk konfigurasi yang sama):

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "sms8-mcp"],
      "env": { "SMS8_API_KEY": "sk_xxx" }
    }
  }
}

Contoh CLI:

export SMS8_API_KEY=sk_xxx
npx sms8-cli send +14155550100 "Hello"
CODE=$(npx sms8-cli otp wait +Google --timeout=120)

Contoh React:

import { OtpForm } from 'react-sms-otp';

<OtpForm
  apiKey={process.env.NEXT_PUBLIC_SMS8_API_KEY!}
  onVerified={(phone) => router.push('/dashboard')}
/>

Sumber untuk keenam paket ada di npm-packages/.

SDK iOS + Android

Untuk aplikasi seluler native, folder sdks/ mengirimkan SDK Kotlin (Android) dan Swift (iOS) dengan API kirim / verifikasi + pembantu isi-otomatis SMS (Google SMS Retriever di Android, tipe konten oneTimeCode di iOS).

SDK	Instal	Isi-otomatis
sms8-swift	Swift Package Manager — lihat README	Tampilan SwiftUI OTPTextField iOS
sms8-android	JitPack — lihat README	SMSRetriever.start(activity) — tidak perlu izin SMS

Kedua SDK berlisensi MIT, berbagi kunci API SMS8 yang sama, dan menargetkan kasus penggunaan alternatif Twilio-Verify yang sama.

Mulai cepat

1. Dapatkan akun SMS8

Daftar di app.sms8.io. Uji coba gratis 5 hari, tanpa kartu kredit. Pasangkan ponsel Android Anda melalui QR dan salin kunci API Anda dari Profil lalu API.

2. Tambahkan server MCP ke alat Anda

HTTP Terhosting (Claude Code, Cursor, Windsurf, Codex, Devin)

{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

Plugin Claude Code (satu perintah)

/plugin marketplace add 1fancy/sms8-sms-gateway
/plugin install sms8-sms-gateway

Kemudian export SMS8_API_KEY=sk_xxx di shell Anda sebelum meluncurkan Claude Code.

npx untuk klien stdio

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "@sms8/mcp"],
      "env": { "SMS8_API_KEY": "sk_your_key" }
    }
  }
}

3. Wisaya penyiapan

Dasbor di app.sms8.io/mcp-setup.php mengisi JSON untuk setiap alat AI, menampilkan QR pemasangan perangkat jika diperlukan, dan menyertakan formulir uji SMS langsung.

4. Tanyakan AI Anda

Add SMS verification to my signup flow using the sms8 MCP.

AI akan memanggil setup_sms8, lalu send_otp dan verify_otp, dan menulis kode produksi yang berfungsi pada percobaan pertama.

Kasus penggunaan

Ini adalah prompt satu baris nyata yang dapat Anda tempelkan ke Claude Code, Cursor, atau Windsurf.

Verifikasi telepon saat pendaftaran

Wire phone-number verification into this app using the sms8 MCP. Use
send_otp on /signup, verify_otp on /verify-phone. Render the remaining
attempts on error.

Notifikasi pengiriman pesanan

When an order ships, send the customer an SMS with their tracking link
via the sms8 MCP.

Kotak masuk dukungan dua arah

Register a webhook with the sms8 MCP at https://my-app.com/sms-inbox.
Scaffold the handler that verifies the HMAC signature and routes inbound
SMS to the support queue.

Login tanpa kata sandi melalui SMS

Replace the magic-link email login with SMS OTPs using the sms8 MCP.
6-digit code, 5-minute expiry, 5 attempts.

2FA SMS untuk halaman admin

Add SMS 2FA to /admin login via the sms8 MCP. Lock the account after
5 failed verify_otp attempts.

Contoh kode siap pakai

Setiap file di examples/ siap produksi, tanpa dependensi, dan dapat disalin-tempel. Ini adalah yang dihasilkan AI setelah jabat tangan setup_sms8.

• php-send.php: kelas Sms8Sender minimal dengan send, sendOtp, verifyOtp
• js-fetch.js: klien Node / browser / Cloudflare Worker (ESM dan CommonJS)
• otp-flow.php: alur verifikasi telepon lengkap (startSignup + verifySignup)
• webhook-handler.php: penangan SMS masuk dengan pemeriksaan tanda tangan HMAC

Pertanyaan yang sering diajukan

Apa itu server MCP SMS8?

Titik akhir HTTPS di mcp.sms8.io yang mengimplementasikan Model Context Protocol. Alat coding AI memanggil antarmuka JSON-RPC-nya untuk mengirim SMS, menerbitkan OTP, dan mengonfigurasi webhook. SMS dirutekan melalui ponsel Android yang dipasangkan melalui platform SMS8.

Apa bedanya dengan Twilio?

SMS8 menggunakan ponsel Android Anda sendiri sebagai gateway dengan kartu SIM yang sudah ada. Tidak ada biaya operator per pesan, tidak ada pendaftaran A2P 10DLC, dan tidak ada nomor telepon yang perlu disediakan. Anda membayar paket tetap dan mengirim SMS tanpa batas. Server MCP menyediakan tujuh alat yang dapat dipanggil langsung oleh asisten AI Anda, yang tidak ditawarkan Twilio.

Apakah ini berfungsi dengan Claude Code?

Ya. Tambahkan server MCP ke ~/.config/claude/mcp-servers.json dengan transport HTTP yang mengarah ke https://mcp.sms8.io dan kunci API SMS8 Anda sebagai token Bearer. Atau jalankan /plugin marketplace add 1fancy/sms8-sms-gateway diikuti dengan /plugin install sms8-sms-gateway.

Apakah ini berfungsi dengan Cursor dan Windsurf?

Ya. Keduanya mendukung server MCP HTTP. Tambahkan https://mcp.sms8.io dengan kunci API Anda sebagai header Bearer ke ~/.cursor/mcp.json (Cursor) atau ~/.codeium/windsurf/mcp_config.json (Windsurf). Wisaya penyiapan di app.sms8.io/mcp-setup.php mengisi JSON per alat.

Bisakah AI menambahkan verifikasi OTP secara otomatis?

Ya. Skill Claude Code yang dibundel (skills/send-sms/SKILL.md) mengajarkan asisten kapan harus memanggil send_otp dan verify_otp, dan cara membungkus rute pendaftaran atau login yang ada dengan langkah verifikasi. Prompt seperti "tambahkan verifikasi telepon ke /signup" sudah cukup.

Apakah kode sumbernya publik?

Ya, berlisensi MIT. Server, semua tujuh implementasi alat, peluncur npm (@sms8/mcp), manifes plugin Claude Code, dan kode contoh ada di repo ini.

Apa yang terjadi dengan kunci API saya?

Kunci API Anda mengautentikasi setiap panggilan alat MCP melalui header Authorization: Bearer (atau X-Api-Key). Server terhosting memvalidasinya terhadap akun SMS8 Anda, lalu merutekan panggilan melalui jalur pengiriman SMS8 yang ada. Respons setup_sms8 hanya mengembalikan empat karakter terakhir kunci Anda, sehingga tidak pernah bocor ke riwayat obrolan AI atau log.

Apakah ini aman digunakan di produksi?

Ya. Pertahanan sisi server meliputi:

• Pembatasan laju per kunci yang diwarisi dari API SMS8
• Batas keras 5 OTP per nomor telepon per 24 jam, tidak dapat dikonfigurasi pengguna
• Cooldown kirim ulang 30 hingga 600 detik (default 60 detik)
• Titik akhir OTP hanya POST; GET mengembalikan 405; cookie diabaikan
• Pemeriksaan batas laju yang dibungkus transaksi dengan kunci baris; panggilan bersamaan tidak dapat melampaui batas
• Tanda tangan webhook HMAC-SHA256
• Daftar blokir SSRF komprehensif di create_webhook yang mencakup RFC1918, CGNAT, link-local, IPv4-mapped IPv6, dan host yang di-resolve DNS
• CORS hanya diiklankan untuk metode penemuan; tools/call menghilangkan CORS sehingga halaman web berbahaya tidak dapat mendorong pengiriman SMS

Bisakah saya menghosting sendiri server MCP?

Ya. Kloning repo, atur SMS8_APP_PATH ke direktori instalasi SMS8 Anda, dan jalankan:

git clone https://github.com/1fancy/sms8-sms-gateway.git
cd sms8-sms-gateway
export SMS8_APP_PATH=/path/to/your/sms8-install
php -S 127.0.0.1:8080 index.php

Server terhosting di mcp.sms8.io gratis dan lebih mudah bagi sebagian besar pengguna.

Apa itu "vibe coding"?

Vibe coding adalah mengirimkan perangkat lunak yang berfungsi dengan menjelaskan apa yang Anda inginkan dalam bahasa Inggris biasa kepada asisten AI alih-alih menulis setiap baris secara manual. SMS8 MCP membuat salah satu permintaan paling umum ("tambahkan notifikasi SMS") menjadi mungkin tanpa pernah menyentuh portal operator atau dokumen A2P.

Keamanan dan rahasia

Repositori ini tidak berisi rahasia. Semua kredensial berada di variabel lingkungan atau konfigurasi MCP alat AI Anda:

SMS8_API_KEY=sk_…        # from app.sms8.io → Profile → API
SMS8_WEBHOOK_SECRET=…    # from app.sms8.io → Webhook

Untuk detail keamanan lengkap, lihat bagian FAQ di atas. Ringkasan audit keamanan terpisah tersedia berdasarkan permintaan.

Tata letak repositori

.
├── README.md                       this file
├── LICENSE                         MIT
├── index.php                       MCP server entry (JSON-RPC dispatcher)
├── landing.html                    marketing landing at mcp.sms8.io
├── .claude-plugin/plugin.json      Claude Code plugin manifest
├── .mcp.json                       MCP server config referenced by the plugin
├── skills/send-sms/SKILL.md        teaches Claude when to invoke SMS8 tools
├── npm-packages/                   five published npm packages
│   ├── sms8-mcp/                   MCP stdio bridge (sms8-mcp)
│   ├── sms8-cli/                   universal CLI (sms8)
│   ├── sms-otp-using-myphone/      OTP-only brand of the CLI
│   ├── phone-sms-gateway/          phone-as-gateway brand of the CLI
│   └── send-sms-from-android/      Android-first brand of the CLI
├── lib/                            Auth, JsonRpc, ToolRegistry
├── tools/                          7 tool implementations
└── examples/                       PHP and JS drop-in samples

Peta jalan

• Server MCP HTTP live di mcp.sms8.io
• Titik akhir OTP dengan batas penyalahgunaan per telepon
• Paket npm sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
• Plugin dan Skill Claude Code
• Dukungan MMS
• SMS masuk dirutekan otomatis ke AI untuk pembuatan balasan
• Batas laju per alat dapat dikonfigurasi di dasbor
• Contoh kode dalam Python, Go, dan Ruby

Berkontribusi

Issue dan pull request diterima di github.com/1fancy/sms8-sms-gateway. Buka diskusi sebelum perubahan yang lebih besar.

Lisensi

MIT. Lihat LICENSE.

Kata kunci

model context protocol, server mcp, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms gateway, android sms gateway, alternatif twilio, vibe coding, integrasi sms ai, notifikasi sms, kirim sms dari claude, kirim sms dari cursor, api verifikasi telepon, sms otp, sms 2fa, webhook sms, sms masuk, sms dua arah, sms tanpa batas, tanpa biaya per pesan, tanpa A2P 10DLC, alat coding ai, sms8