TeleSign MCP

Servidor MCP para Serviços TeleSign

Documentação

Servidor MCP TeleSign

Um servidor Model Context Protocol (MCP) que fornece integração perfeita com as APIs TeleSign para assistentes de IA como Claude da Anthropic, ChatGPT da OpenAI ou Gemini do Google. Habilite sua IA para enviar mensagens SMS, verificar números de telefone, avaliar risco de fraude e muito mais.

O que é MCP?

O Model Context Protocol é um padrão aberto que permite que assistentes de IA se conectem com segurança a fontes de dados e ferramentas externas. Este servidor implementa MCP para dar aos assistentes de IA acesso direto às APIs de comunicação e verificação da TeleSign.

🔨 Recursos

Ferramentas Disponíveis

Ferramenta	Descrição
`verifyapi_send_otp`	Envie um código de acesso único via SMS, voz, WhatsApp, Viber, RCS ou e-mail com suporte automático a fallback
`verifyapi_check_code`	Verifique um código OTP inserido pelo usuário
`verifyapi_get_status`	Verifique o status de uma verificação em andamento
`phoneid_get_info`	Obtenha detalhes do número de telefone, incluindo tipo (celular/fixo/VoIP), operadora e localização
`intelligence_assess_risk`	Obtenha pontuação de risco de fraude (0-1000) com recomendação de permitir/sinalizar/bloquear
`messaging_send_sms`	Envie mensagens SMS (OTP, alertas ou marketing)
`docs_search`	Pesquise na documentação TeleSign
`docs_get`	Recupere a documentação completa para um tópico

Principais Capacidades

Verificação OTP Multicanal - Envie códigos de verificação via SMS, voz, WhatsApp, Viber, RCS ou e-mail com fallback automático entre canais
Inteligência Telefônica - Identifique tipo de número de telefone, operadora e localização geográfica
Prevenção de Fraude - Pontuação de risco em tempo real para detectar números de telefone fraudulentos
Mensagens SMS - Envie mensagens transacionais ou de marketing
Documentação Integrada - Acesse a documentação da API TeleSign diretamente pelo assistente de IA

🛠️ Instalação

Pré-requisitos

Node.js 18+
Cursor, Claude Code, VSCode, Windsurf ou outro Cliente MCP
Uma conta TeleSign com credenciais de API (Cadastre-se aqui)

Configuração

Clone o repositório:

git clone https://github.com/mdp18/telesign-mcp.git
cd telesign-mcp

Instale as dependências:
```
npm install
```
Compile o projeto:
```
npm run build
```

Configuração

Variáveis de Ambiente

Defina suas credenciais da API TeleSign:

export TELESIGN_CUSTOMER_ID="your-customer-id"
export TELESIGN_API_KEY="your-api-key"

Configuração do Claude Desktop

Adicione isto ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "telesign": {
      "command": "node",
      "args": ["/path/to/telesign-mcp/build/index.js"],
      "env": {
        "TELESIGN_CUSTOMER_ID": "your-customer-id",
        "TELESIGN_API_KEY": "your-api-key"
      }
    }
  }
}

Exemplos de Uso

Após a configuração, você pode pedir ao Claude para:

"Envie um OTP para +15551234567 via SMS com fallback de voz após 30 segundos"
"Verifique o código 123456 para o ID de referência abc-123"
"Obtenha informações sobre o número de telefone +15551234567"
"Verifique a pontuação de risco de fraude para +15551234567"
"Envie um SMS para +15551234567 dizendo 'Seu pedido foi enviado'"

📚 Documentação da API

O servidor inclui documentação integrada acessível pelas ferramentas docs_search e docs_get. Tópicos disponíveis:

verify-api - Endpoints e fluxos de verificação OTP
phone-id - Detalhes de consulta de número de telefone
intelligence - Pontuação de risco e detecção de fraude
messaging-sms - Guia de mensagens SMS
status-codes - Referência de códigos de resposta da API

🤝 APIs Suportadas

Atualmente Funcionais

API Verify - Verificação OTP multicanal (SMS, voz, WhatsApp, Viber, RCS, e-mail) com suporte a fallback
API Phone ID - Inteligência de número de telefone com complementos de atributos de identidade (troca de SIM, desativação de número, informações de contato, histórico de portabilidade, etc.)
API Intelligence - Pontuação de risco de fraude e recomendações
API Messaging - Envio básico de SMS (/v1/messaging)

Em Breve

💻 Desenvolvimento

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server directly
npm start

📄 Licença

Apache 2.0 - Consulte LICENSE para detalhes.

🛟 Suporte

⚠️ Aviso Legal

Este é um projeto de código aberto conduzido pela comunidade e não é oficialmente afiliado, endossado ou apoiado pela TeleSign. O(s) autor(es) não possuem nem reivindicam quaisquer direitos sobre a marca, nome ou identidade visual da TeleSign. "TeleSign" e quaisquer logotipos associados são marcas registradas da TeleSign Corporation.

Este projeto é fornecido "no estado em que se encontra", sem garantia de qualquer tipo. Use por sua conta e risco. Para suporte oficial da TeleSign não relacionado a este servidor MCP, entre em contato diretamente com a TeleSign.