SMS, OTP en webhooks voor Claude Code, Cursor en Windsurf
Koppel je Android aan je coding-assistent en verstuur onbeperkt SMS, valideer OTPs en ontvang antwoorden via webhooks — allemaal in dezelfde sessie. Eén SMS8-key, JSON-RPC-tools voor elke stap. Geen Twilio, geen A2P 10DLC, geen kosten per bericht.
Wat je assistent vanuit de editor kan doen
Elke tool draait door dezelfde send-pipeline als het SMS8-dashboard. Credits, retries, multi-device routing en webhook-signing werken precies hetzelfde als een directe API-call.
setup_sms8
De handshake. Checkt je API-key en geeft je devices, plan en integratiecontext terug.
send_sms
Stuur een SMS via een gekoppelde Android. Routeren per device of per SIM.
send_otp
Genereert de code en stuurt 'm. Lengte, geldigheid en aantal pogingen stel je zelf in.
verify_otp
Constant-time vergelijking met de laatst verstuurde code. Bij een mismatch krijg je het aantal pogingen terug.
wait_for_otp NIEUW
Blokkeert de agent tot er een SMS met code op je Android binnenkomt, en haalt de code er automatisch uit. Lost het probleem op voor autonome agents.
get_messages
Haalt recent ontvangen of verstuurde SMS op. Filter op richting of telefoonnummer.
list_devices
Lijst van gekoppelde Androids. Kies de afzender als je belasting wilt verdelen over meerdere SIMs.
get_balance NIEUW
Snelle saldocheck. SMS over, dagen tot verlenging, samenvatting in één regel.
create_webhook
Registreer een callback-URL voor binnenkomende SMS. Alleen HTTPS, SSRF-beveiligd, HMAC-ondertekend.
Lees de docs
Volledige API- en OTP-referentie met curl-voorbeelden, rate limits en het beveiligingsmodel.
Drie installatiewegen, jij kiest
SMS8 draait als gehoste MCP-server over HTTP, als Claude Code-plugin inclusief Skill, en als npx-launcher voor stdio-clients.
- Gehoste HTTP werkt in Claude Code, Cursor en Windsurf met een Bearer token
- Claude-plugin via
/plugin marketplace add 1fancy/sms8-sms-gateway - npx start de stdio-brug:
npx -y @sms8/mcp
{
"mcpServers": {
"sms8": {
"url": "https://mcp.sms8.io",
"transport": "http",
"headers": {
"Authorization":
"Bearer YOUR_SMS8_API_KEY"
}
}
}
}
Installeer via npm
Negen npm-pakketten dekken elke flow: AI-agent via MCP, terminalscripts, OTP-flows, React hooks + Capacitor en Cordova plugins voor Ionic apps. Eén API-sleutel, één gekoppelde Android-telefoon.
MCP-launcher voor Claude Code, Cursor, Windsurf, OpenCode. Plak in je MCP-configuratie en je AI-assistent krijgt 9 SMS-tools.
$ npx -y sms8-mcp
Terminal-CLI. Verstuur SMS, verstuur / verifieer / wacht op OTP’s, lees inbox, lijst van apparaten. Perfect voor scripts, cron, CI.
$ npx sms8-cli send +14155550100 "Hi"
React useSms8Otp() hook + kant-en-klare <OtpInput /> met separators, RTL, mask en render props.
$ npm i react-sms-otp
Zelfde code als react-sms-otp, zoekgeoptimaliseerd voor «sms otp verify» en «otp input».
$ npm i sms-otp-verify
Capacitor-plugin voor Ionic apps: native iOS Swift + Android Kotlin bridges met web-fallback.
$ npm i capacitor-sms-otp-send-verify
Cordova-plugin voor Ionic apps: native iOS Swift + Android Kotlin bridges voor OTP send/verify.
$ cordova plugin add cordova-plugin-sms-otp-send
OTP-gerichte variant van de CLI. Verstuur en verifieer OTP-codes via je eigen telefoon, zonder Twilio, zonder kosten per OTP.
$ npx sms-otp-using-myphone send +1234
Telefoon-als-gateway variant van de CLI. Zelfde backend, zoekgeoptimaliseerd voor teams die een telefoon-SMS-gateway zoeken.
$ npx phone-sms-gateway send +1234 "Hi"
Android-first variant van de CLI. Zelfde code, zoekgeoptimaliseerd voor developers die zoeken naar «SMS versturen vanaf Android».
$ npx send-sms-from-android send +1234 "Hi"
Of bekijk de broncode op GitHub ↗
Cases om direct te plakken
Telefoonverificatie
"Bouw SMS-verificatie in deze app via sms8 MCP. Gebruik send_otp op /signup, verify_otp op /verify-phone en toon het aantal pogingen bij een fout."
Bestelmeldingen
"Stuur de klant een SMS met track-and-trace zodra een bestelling verstuurd wordt, via sms8 MCP."
Tweezijdige support-inbox
"Registreer een webhook op sms8 MCP naar https://app.com/sms-in. Scaffold een handler die de HMAC checkt en binnenkomende SMS naar de support-queue stuurt."
Wachtwoordloze login
"Vervang de magic-link-login door OTP via sms8 MCP. 6-cijferige code, 5 minuten geldig."
Afspraakherinneringen
"Lees de afspraken van morgen uit de database en stuur 24 uur van tevoren een SMS-herinnering met send_sms."
2FA voor de admin
"Voeg SMS-2FA toe aan /admin via sms8 MCP. Lock het account na 5 mislukte verify_otp-pogingen."
SMS8 MCP vs Twilio vs MessageBird
| Functie | SMS8 MCP | Twilio | MessageBird |
|---|---|---|---|
| Ingebouwde MCP-server | Ja | Nee | Nee |
| Kosten per bericht | Geen | $0.0079+ | $0.05+ |
| A2P 10DLC verplicht | Nee | Ja | Ja |
| Nummer huren | Niet nodig | $1+ p/m | $2+ p/m |
| Setup-tijd | 60 seconden | Dagen tot weken | Dagen |
| OTP-verificatie | Inbegrepen, gratis | Aparte dienst | Aparte dienst |
| Open-source MCP-code | MIT | Nee | Nee |
Veilig out-of-the-box, geen verrassingen
Harde cap per nummer
Maximaal 5 OTPs per nummer per 24 uur. Niet ophoogbaar vanuit het account.
Race-condition-proof
Cooldown- en cap-checks draaien binnen DB-transacties met row locks.
OTP alleen via POST
GET geeft 405. Cookies worden genegeerd.
API-key verborgen
setup_sms8 toont alleen de laatste 4 tekens van je key.
Webhooks SSRF-veilig
Blokkeert loopback, RFC1918, CGNAT, link-local en IPv4-mapped IPv6.
HMAC-signed deliveries
Binnenkomende SMS en delivery-events komen ondertekend met HMAC-SHA256 binnen — niet te vervalsen.
Veelgestelde vragen
Wat is de SMS8 MCP-server?
Een Model Context Protocol-server op mcp.sms8.io zodat AI-coding-tools (Claude Code, Cursor, Windsurf, Codex, Devin) SMS kunnen sturen, OTPs kunnen genereren en webhooks kunnen registreren. Elk bericht gaat via jouw gekoppelde Android, niet via Twilio.
Heb ik A2P 10DLC nodig?
Nee. SMS8 gebruikt je eigen Android en SIM als gateway. Geen A2P 10DLC-registratie, geen kosten per bericht, geen huurnummers.
Hoe voeg ik SMS toe aan een Claude Code-project?
Voeg de MCP-server toe aan ~/.config/claude/mcp-servers.json met HTTP-transport naar https://mcp.sms8.io en je SMS8-key als Bearer token. Of run /plugin marketplace add 1fancy/sms8-sms-gateway en daarna /plugin install sms8-sms-gateway.
Werkt het met Cursor en Windsurf?
Ja. Beide ondersteunen MCP-servers over HTTP. Voeg https://mcp.sms8.io met je SMS8-key in de Bearer-header toe aan ~/.cursor/mcp.json of ~/.codeium/windsurf/mcp_config.json.
Is dit een Twilio-alternatief?
Ja. SMS8 draait op je eigen Android met de SIM die je al hebt. Geen kosten per bericht, geen A2P 10DLC, geen nummer dat je moet provisionen. Vlakke prijs vanaf $29/maand met onbeperkt SMS.
Is de broncode openbaar?
Ja, MIT-licentie op github.com/1fancy/sms8-sms-gateway.