convez.ai
MCP ServerIntegração & APIsIntermediário
rchanllc

JoltSMS MCP Server

rchanllc/joltsms-mcp-server

Provisione números telefônicos reais e receba SMS/OTP em agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra JoltSMS para provisionar números de telefone reais com SIM nos EUA e receber SMS/códigos OTP através de agentes de IA. Permite que Claude e outras ferramentas de IA alugem números telefônicos, gerenciem SMS recebidos e extraiam automaticamente códigos de verificação.

Instalação

$npx convez-ai rchanllc/joltsms-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
1
Acompanhando
0
Saúde
50%
Último commit
há 1 semana
Versão
v1.0.2
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de verificação de contas por telefone em workflows de IA
  • Extração automática de códigos OTP de múltiplos serviços
  • Testes de integração que exigem números telefônicos reais
  • Automação de processos que necessitam receber SMS programaticamente

Veredito

Ferramenta especializada e bem-estruturada para cenários específicos de automação que requerem números telefônicos reais. Ideal para agentes de IA que precisam navegar fluxos de verificação telefônica, com implementação clara via MCP. Custo mensal obrigatório ($50/mês por número) limita viabilidade econômica para uso experimental.

README

A tradução para o português deste README ainda está na fila.

@joltsms/mcp-server

MCP server for JoltSMS — provision dedicated real-SIM US phone numbers and receive SMS/OTP codes through AI agents.

Built on the Model Context Protocol, this server gives AI agents (Claude Code, Claude Desktop, Cursor, etc.) the ability to rent phone numbers, wait for incoming SMS, extract OTP codes, and manage billing — all through standardized tool calls.

Quick Start

1. Get an API Key

Create a JoltSMS account and generate an API key at Dashboard → Settings → API Keys.

2. Configure Your MCP Client

Add to your .mcp.json (Claude Code) or MCP settings (Claude Desktop, Cursor):

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

3. Use It

Your AI agent now has access to all JoltSMS tools. Try:

"Provision a new phone number with area code 650 and wait for an OTP"

Tools

ToolDescription
joltsms_list_numbersList active numbers with service labels, tags, and unread counts
joltsms_get_numberFull details for a single number
joltsms_update_numberSet service label, tags, or notes on a number
joltsms_provision_numberRent a new dedicated real-SIM US number ($50/mo)
joltsms_release_numberCancel/release a number at end of billing period
joltsms_list_messagesList recent SMS with parsed OTP codes
joltsms_mark_readMark single or bulk messages as read
joltsms_wait_for_smsPoll until an SMS arrives (key tool for OTP flows)
joltsms_get_latest_otpGet the most recent parsed verification code
joltsms_billing_statusCheck all subscriptions with billing health

OTP Verification Workflow

The most common use case — automated phone verification:

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]

Environment Variables

VariableRequiredDescription
JOLTSMS_API_KEYYesYour API key (jolt_sk_*)
JOLTSMS_API_URLNoAPI base URL (defaults to https://api.joltsms.com)

Requirements

  • Node.js 18+
  • A JoltSMS account with a payment method on file
  • Your first number must be ordered through the Dashboard to complete initial 3D Secure verification

Documentation

License

MIT

Ver o original no GitHub

Bom para

Relacionados