SMS Vert Pro — Python & TypeScript

SMS Vert Pro — Serveur MCP Python

Serveur MCP (Model Context Protocol) en Python pour envoyer des SMS professionnels via SMS Vert Pro depuis n'importe quel agent IA : Claude, ChatGPT, LangChain, CrewAI, AutoGen, etc.

Also available in TypeScript/Node.js (npx @3-bees-online/mcp-server-smsvertpro) and PHP

Prérequis

1. Python 3.10+
2. Un compte SMS Vert Pro — inscription gratuite (10 SMS offerts)
3. Un token API Bearer — générez-le depuis l'API V2 de votre compte

Installation

git clone https://github.com/3-bees-online/mcp-server-smsvertpro-python.git
cd mcp-server-smsvertpro-python
pip install -r requirements.txt

Configuration

Définissez votre token API en variable d'environnement :

export SMSVERTPRO_API_TOKEN="votre_token_api_ici"

Claude Desktop

Ajoutez dans votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "smsvertpro": {
      "command": "python",
      "args": ["/chemin/vers/server.py"],
      "env": {
        "SMSVERTPRO_API_TOKEN": "votre_token_api_ici"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add smsvertpro -- python /chemin/vers/server.py

Puis configurez la variable d'environnement SMSVERTPRO_API_TOKEN.

Cursor / Windsurf

Ajoutez la configuration MCP dans les paramètres de votre éditeur en pointant vers python server.py avec la variable d'environnement SMSVERTPRO_API_TOKEN.

Outils disponibles

Outil	Description
send_sms	Envoyer un SMS (immédiat ou programmé)
check_credits	Consulter le solde de crédits
get_delivery_report	Rapport de délivrabilité d'une campagne
get_responses	Réponses SMS reçues (bidirectionnel)
verify_number	Vérifier le format d'un numéro (syntaxe)
get_blacklist	Liste des désabonnements (STOP)
generate_otp	Envoyer un code OTP par SMS
verify_otp	Vérifier un code OTP
cancel_sms	Annuler un SMS programmé ou une campagne

Exemples d'utilisation

Une fois le serveur MCP connecté, demandez simplement à votre agent IA :

• "Envoie un SMS au 33612345678 pour annoncer notre promo de printemps -20%"
• "Combien de crédits SMS il me reste ?"
• "Vérifie si le SMS de la campagne 12345 a été délivré"
• "Envoie un code OTP au 33698765432 pour confirmer l'inscription"

L'agent IA utilisera automatiquement les bons outils avec les bons paramètres.

Format des numéros

Les numéros de téléphone doivent être au format international sans le + :

• France : 33612345678 (pas 0612345678, pas +33612345678)
• Belgique : 32470123456
• Suisse : 41791234567

Sécurité

• Vérification SSL activée sur tous les appels API
• Validation des numéros de téléphone (format, longueur)
• Validation de l'expéditeur (alphanumérique, 11 caractères max)
• Validation des codes OTP (chiffres uniquement)
• Votre token API reste sur votre machine, il n'est jamais partagé avec l'agent IA
• Le serveur communique uniquement avec https://www.smsvertpro.com/api/v2/
• Pour les SMS marketing, ajoutez STOP 36173 à la fin du message (obligation légale)

Liens

• SMS Vert Pro
• Documentation API V2
• Intégration IA
• Tarifs SMS
• Version PHP

Licence

MIT — Voir LICENSE