JoltSMS

@joltsms/mcp-server

Servidor MCP para JoltSMS — provisione números de telefone dedicados dos EUA com SIM real e receba códigos SMS/OTP por meio de agentes de IA.

Construído sobre o Model Context Protocol, este servidor dá aos agentes de IA (Claude Code, Claude Desktop, Cursor, etc.) a capacidade de alugar números de telefone, aguardar SMS recebidos, extrair códigos OTP e gerenciar cobrança — tudo por meio de chamadas de ferramentas padronizadas.

Início Rápido

1. Obtenha uma Chave de API

Crie uma conta JoltSMS e gere uma chave de API em Dashboard → Configurações → Chaves de API.

2. Configure Seu Cliente MCP

Adicione ao seu .mcp.json (Claude Code) ou às configurações do MCP (Claude Desktop, Cursor):

{
  "mcpServers": {
    "joltsms": {
      "command": "npx",
      "args": ["-y", "@joltsms/mcp-server"],
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      }
    }
  }
}

3. Use

Seu agente de IA agora tem acesso a todas as ferramentas JoltSMS. Experimente:

"Provisione um novo número de telefone com código de área 650 e aguarde um OTP"

Ferramentas

Ferramenta	Descrição
joltsms_list_numbers	Lista números ativos com rótulos de serviço, tags e contagens de não lidos
joltsms_get_number	Detalhes completos de um único número
joltsms_update_number	Define rótulo de serviço, tags ou notas em um número
joltsms_provision_number	Aluga um novo número dedicado dos EUA com SIM real ($50/mês)
joltsms_release_number	Cancela/libera um número no final do período de cobrança
joltsms_list_messages	Lista SMS recentes com códigos OTP analisados
joltsms_mark_read	Marca mensagens individuais ou em lote como lidas
joltsms_wait_for_sms	Faz polling até que um SMS chegue (ferramenta essencial para fluxos de OTP)
joltsms_get_latest_otp	Obtém o código de verificação analisado mais recente
joltsms_billing_status	Verifica todas as assinaturas com status de cobrança

Fluxo de Verificação de OTP

O caso de uso mais comum — verificação telefônica automatizada:

1. joltsms_provision_number({ area_code: "650" })
   → Number provisioning started! Phone: +16505551234

2. joltsms_update_number({ number_id: "+16505551234", service_name: "PayPal" })
   → Tagged for easy lookup later

3. [Agent enters phone number on PayPal and requests OTP]

4. joltsms_wait_for_sms({ number_id: "+16505551234", timeout_seconds: 120 })
   → SMS received after 8.2s: "Your PayPal code is 847291"
   → OTP Code: 847291

5. joltsms_mark_read({ number_id: "+16505551234" })
   → Inbox clean

6. [Agent enters 847291 on PayPal — verification complete]

Variáveis de Ambiente

Variável	Obrigatória	Descrição
JOLTSMS_API_KEY	Sim	Sua chave de API (jolt_sk_*)
JOLTSMS_API_URL	Não	URL base da API (padrão: https://api.joltsms.com)

Requisitos

• Node.js 18+
• Uma conta JoltSMS com método de pagamento cadastrado
• Seu primeiro número deve ser solicitado pelo Dashboard para concluir a verificação inicial 3D Secure

Documentação

• Documentação do Servidor MCP
• Referência da API
• Site da JoltSMS

Licença

MIT