SMS8 - SMS GATEWAY using your phone

Servidor MCP SMS8

Gateway SMS → sms8.io  ·  Gateway SMS MCP para vibe coders e desenvolvedores → mcp.sms8.io

Envie SMS, emita e verifique OTPs, aguarde códigos recebidos e configure webhooks a partir do Claude Code, Cursor, Windsurf, OpenCode e qualquer outra ferramenta de codificação com IA que utilize o Model Context Protocol. O SMS é roteado através de um telefone Android pareado via plataforma SMS8.

Servidor ativo: https://mcp.sms8.io Painel: https://app.sms8.io Site de marketing: https://sms8.io

Por que usar

Está criando um aplicativo e quer notificações por SMS, OTPs, mensagens bidirecionais ou verificação de telefone por agente autônomo? A maioria das opções exige que você se registre em programas de operadoras, provisione números de telefone, pague por mensagem ou alugue um SIM descartável por sessão. O SMS8 roteia SMS através de um telefone que você já possui. O servidor MCP oferece ao seu assistente de IA nove ferramentas que ele pode chamar diretamente, então adicionar SMS a um projeto leva um prompt em vez de uma hora de trabalho de integração.

O que você obtém

Ferramenta	Finalidade
setup_sms8	Valida a chave da API, retorna o contexto da conta e exemplos de código
send_sms	Envia um SMS através de um dispositivo Android pareado
send_otp	Gera e envia um código de verificação
verify_otp	Compara um código digitado com o último OTP emitido
wait_for_otp	NOVO. Bloqueia até que um OTP chegue no Android pareado; extrai o código
get_messages	Retorna SMS recentes da caixa de entrada ou enviados
list_devices	Lista dispositivos Android pareados
get_balance	NOVO. Verificação leve de crédito e renovação
create_webhook	Registra uma URL de callback para SMS recebidos e eventos de entrega

Todas as ferramentas compartilham o mesmo pipeline de envio do painel SMS8. Créditos, novas tentativas, roteamento multi-dispositivo e assinatura de webhook funcionam de forma idêntica a uma chamada direta da API.

SMS8 vs Twilio vs MessageBird

Capacidade	SMS8	Twilio	MessageBird
Servidor MCP integrado	Sim	Não	Não
Taxa por mensagem	Nenhuma	$0,0079+	$0,05+
A2P 10DLC necessário	Não	Sim	Sim
Provisionamento de número de telefone	Não necessário	$1+/mês	$2+/mês
Tempo de configuração	60 segundos	Dias a semanas	Dias
Verificação OTP integrada	Sim	Serviço extra	Serviço extra
Código MCP open-source	MIT	Não	Não

Instalar via npm

Seis pacotes cobrem todos os fluxos — escolha o que se adequa ao seu projeto.

Pacote	Comando de execução	Caso de uso
sms8-mcp	npx -y sms8-mcp	Lançador MCP para Claude Code, Cursor, Windsurf, OpenCode
sms8-cli	npx sms8-cli send +1234 "hi"	CLI de terminal para enviar / OTP / caixa de entrada / dispositivos
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (separadores, RTL, máscara, render props)
sms-otp-verify	npm i sms-otp-verify	Mesmo código, nome direcionado a SEO para buscas "sms otp verify" / "otp input"
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Plugin Capacitor para aplicativos Ionic — nativo iOS Swift + Android Kotlin + fallback web
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Plugin Cordova para aplicativos Ionic — nativo iOS Swift + Android Kotlin
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	Marca somente OTP da mesma CLI
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	Marca telefone-como-gateway da mesma CLI
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	Marca Android-first da mesma CLI

Exemplo MCP (Claude Code, Cursor, Windsurf — mesmo formato de configuração):

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

Exemplo CLI:

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

Exemplo React:

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

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

O código-fonte de todos os seis pacotes está em npm-packages/.

SDKs iOS + Android

Para aplicativos móveis nativos, a pasta sdks/ fornece SDKs Kotlin (Android) e Swift (iOS) com a API enviar / verificar + auxiliares de preenchimento automático de SMS (Google SMS Retriever no Android, tipo de conteúdo oneTimeCode no iOS).

SDK	Instalação	Preenchimento automático
sms8-swift	Swift Package Manager — veja README	iOS OTPTextField visualização SwiftUI
sms8-android	JitPack — veja README	SMSRetriever.start(activity) — sem necessidade de permissão de SMS

Ambos os SDKs são MIT, compartilham a mesma chave de API SMS8 e visam os mesmos casos de uso alternativos ao Twilio Verify.

Início rápido

1. Obtenha uma conta SMS8

Cadastre-se em app.sms8.io. Teste gratuito de 5 dias, sem cartão de crédito. Pareie seu telefone Android via QR e copie sua chave de API em Perfil depois API.

2. Adicione o servidor MCP à sua ferramenta

HTTP hospedado (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 (um comando)

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

Depois export SMS8_API_KEY=sk_xxx no seu shell antes de iniciar o Claude Code.

npx para clientes stdio

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

3. Assistente de configuração

O painel em app.sms8.io/mcp-setup.php preenche previamente o JSON para cada ferramenta de IA, mostra o QR de pareamento do seu dispositivo se necessário e inclui um formulário de teste de SMS ao vivo.

4. Pergunte à sua IA

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

A IA chamará setup_sms8, depois send_otp e verify_otp, e escreverá código de produção que funciona na primeira tentativa.

Casos de uso

Estes são prompts reais de uma linha que você pode colar no Claude Code, Cursor ou Windsurf.

Verificação de telefone no cadastro

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.

Notificações de envio de pedido

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

Caixa de entrada de suporte bidirecional

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 sem senha por SMS

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

SMS 2FA para páginas de administração

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

Exemplos de código prontos para uso

Cada arquivo em examples/ está pronto para produção, sem dependências e pode ser copiado e colado. Estes são os que a IA gera após um handshake setup_sms8.

• php-send.php: classe Sms8Sender mínima com send, sendOtp, verifyOtp
• js-fetch.js: cliente Node / navegador / Cloudflare Worker (ESM e CommonJS)
• otp-flow.php: fluxo completo de verificação de telefone (startSignup + verifySignup)
• webhook-handler.php: manipulador de SMS recebido com verificação de assinatura HMAC

Perguntas frequentes

O que é o servidor MCP SMS8?

Um endpoint HTTPS em mcp.sms8.io que implementa o Model Context Protocol. Ferramentas de codificação com IA chamam sua interface JSON-RPC para enviar SMS, emitir OTPs e configurar webhooks. O SMS é roteado através de um telefone Android pareado via plataforma SMS8.

Como isso é diferente do Twilio?

O SMS8 usa seu próprio telefone Android como gateway com seu cartão SIM existente. Não há taxas de operadora por mensagem, nem registro A2P 10DLC, nem número de telefone para provisionar. Você paga um plano fixo e envia SMS ilimitados. O servidor MCP expõe sete ferramentas que seu assistente de IA pode chamar diretamente, o que o Twilio não oferece.

Isso funciona com o Claude Code?

Sim. Adicione o servidor MCP ao ~/.config/claude/mcp-servers.json com o transporte HTTP apontando para https://mcp.sms8.io e sua chave de API SMS8 como token Bearer. Ou execute /plugin marketplace add 1fancy/sms8-sms-gateway seguido de /plugin install sms8-sms-gateway.

Isso funciona com o Cursor e Windsurf?

Sim. Ambos suportam servidores MCP HTTP. Adicione https://mcp.sms8.io com sua chave de API como cabeçalho Bearer ao ~/.cursor/mcp.json (Cursor) ou ~/.codeium/windsurf/mcp_config.json (Windsurf). O assistente de configuração em app.sms8.io/mcp-setup.php preenche previamente o JSON por ferramenta.

A IA pode adicionar verificação OTP automaticamente?

Sim. A Skill Claude Code incluída (skills/send-sms/SKILL.md) ensina o assistente quando chamar send_otp e verify_otp, e como envolver uma rota de cadastro ou login existente com a etapa de verificação. Um prompt como "adicione verificação de telefone ao /signup" é suficiente.

O código-fonte é público?

Sim, licenciado sob MIT. O servidor, todas as sete implementações de ferramentas, o lançador npm (@sms8/mcp), o manifesto do plugin Claude Code e o código de exemplo estão neste repositório.

O que acontece com minha chave de API?

Sua chave de API autentica cada chamada de ferramenta MCP através de um cabeçalho Authorization: Bearer (ou X-Api-Key). O servidor hospedado a valida em relação à sua conta SMS8 e, em seguida, roteia a chamada através do pipeline de envio SMS8 existente. A resposta setup_sms8 retorna apenas os últimos quatro caracteres da sua chave, para que nunca vaze para o histórico de chat da IA ou logs.

É seguro usar em produção?

Sim. As defesas do lado do servidor incluem:

• Limite de taxa por chave herdado da API SMS8
• Limite rígido de 5 OTPs por número de telefone a cada 24 horas, não configurável pelo usuário
• Tempo de espera de reenvio de 30 a 600 segundos (padrão 60 segundos)
• Endpoints OTP somente POST; GET retorna 405; cookies ignorados
• Verificações de limite de taxa encapsuladas em transação com bloqueios de linha; chamadas concorrentes não podem ultrapassar os limites
• Assinaturas de webhook HMAC-SHA256
• Lista de bloqueio SSRF abrangente em create_webhook cobrindo RFC1918, CGNAT, link-local, IPv4 mapeado em IPv6 e hosts resolvidos por DNS
• CORS anunciado apenas para métodos de descoberta; tools/call omite CORS para que uma página web maliciosa não possa acionar envios de SMS

Posso auto-hospedar o servidor MCP?

Sim. Clone o repositório, defina SMS8_APP_PATH para o diretório de instalação do SMS8 e execute:

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

O servidor hospedado em mcp.sms8.io é gratuito e mais fácil para a maioria dos usuários.

O que é "vibe coding"?

Vibe coding é entregar software funcional descrevendo o que você quer em linguagem natural para um assistente de IA, em vez de escrever cada linha manualmente. O SMS8 MCP torna uma das solicitações mais comuns ("adicione notificações por SMS") possível sem nunca precisar acessar um portal de operadora ou lidar com papelada A2P.

Segurança e segredos

Este repositório não contém segredos. Todas as credenciais residem em variáveis de ambiente ou na configuração MCP da sua ferramenta de IA:

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

Para detalhes completos de segurança, veja a seção de Perguntas Frequentes acima. Um resumo de auditoria de segurança separado está disponível mediante solicitação.

Layout do repositório

.
├── 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

Roteiro

• Servidor MCP HTTP ativo em mcp.sms8.io
• Endpoints OTP com limite de abuso por telefone
• Pacotes npm sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
• Plugin e Skill Claude Code
• Suporte a MMS
• SMS recebido roteado automaticamente para IA para geração de resposta
• Limites de taxa por ferramenta configuráveis no painel
• Exemplos de código em Python, Go e Ruby

Contribuindo

Issues e pull requests são bem-vindos em github.com/1fancy/sms8-sms-gateway. Abra uma discussão antes de mudanças maiores.

Licença

MIT. Veja LICENSE.

Palavras-chave

model context protocol, servidor mcp, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, api sms, api otp, gateway sms, gateway sms android, alternativa twilio, vibe coding, integração ia sms, notificações sms, enviar sms do claude, enviar sms do cursor, api de verificação de telefone, sms otp, 2fa sms, webhook sms, sms recebido, sms bidirecional, sms ilimitado, sem taxas por mensagem, sem A2P 10DLC, ferramentas de codificação ia, sms8