Platfone - Receive SMS & Virtual Numbers MCP

officiel

Plateforme de numéros de téléphone virtuels pour agents IA — louez des numéros dans plus de 200 pays, recevez des SMS et gérez l'ensemble du cycle de vie d'activation.

GitHub

Que pouvez-vous faire avec Platfone Receive SMS & Virtual Numbers MCP ?

Vérifier le solde du compte — Demandez à l'IA de récupérer vos fonds totaux, réservés et disponibles à l'aide de get_balance.
Vérifier le coût et la disponibilité — Consultez le prix et la disponibilité des numéros pour une paire pays et service avec check_price avant de commander.
Commander un numéro virtuel — Louez un numéro de téléphone temporaire par pays et nom de service via order_number pour recevoir un ID d'activation et un numéro de téléphone.
Interroger les SMS reçus — Vérifiez si un code SMS est arrivé pour une activation à l'aide de check_sms, avec le statut et des conseils d'interrogation renvoyés.
Demander un nouveau SMS — Déclenchez une nouvelle tentative gratuite pour recevoir un autre SMS sur le même numéro avec retry_activation.
Annuler et rembourser — Libérez une activation active et récupérez les fonds réservés à l'aide de cancel_activation avant qu'un SMS ne soit reçu.

Documentation

Serveur MCP Platfone

Platfone fournit des numéros de téléphone virtuels pour la vérification de comptes, les tests et les flux d’automatisation. Le serveur MCP Platfone permet aux agents IA d’obtenir des numéros temporaires et de recevoir des SMS depuis des clients compatibles MCP comme Claude, VS Code Copilot, Codex, etc.

📖 Documentation · 🔧 Guide d’installation · 🔑 Obtenir une clé API · 📦 npm

Pourquoi MCP ?

Au lieu d’intégrer l’API manuellement, les agents IA peuvent :

Commander des numéros de manière autonome par pays et nom de service
Attendre les codes SMS
Réessayer ou annuler les activations

Le tout via des appels d’outils structurés — sans backend personnalisé requis.

Fonctionnalités

Cycle de vie complet d’activation — de la commande d’un numéro à la réception du SMS
Catalogue mis en cache avec ETag — les pays et services sont mis en cache en mémoire avec une durée de vie de 5 minutes et un rafraîchissement conditionnel basé sur ETag — jamais envoyé à l’agent
Entrées conviviales — utilisez « Israël » ou « Telegram » au lieu d’identifiants ; les noms sont résolus automatiquement côté serveur
Double transport — stdio et http à partir d’une seule base de code
Authentification par clé API — fonctionne avec votre clé API Platfone existante

Installation

Consultez le Guide d’installation complet pour des instructions détaillées.

Démarrage rapide

NPM :

PLATFONE_API_KEY=your_key npx @platfone/mcp

Consignes pour l’agent

Appelez toujours check_price en premier pour vérifier le coût et la disponibilité
Appelez ensuite order_number pour louer un numéro
Appelez check_sms jusqu’à ce que le SMS soit reçu ou expiré
Utilisez retry_activation si aucun SMS n’arrive
Utilisez cancel_activation pour libérer les fonds si vous n’en avez plus besoin

Outils

Outil	Description
`get_balance`	Vérifier le solde du compte : fonds totaux, réservés et disponibles.
`check_price`	Vérifier le prix et la disponibilité d’une paire pays + service avant de commander.
`order_number`	Commander un numéro de téléphone virtuel. Accepte les noms (« Israël ») ou les identifiants (« il »). Renvoie `activation_id` + `phone`.
`check_sms`	Interroger l’état d’activation. Renvoie le code SMS lorsqu’il est reçu, ou l’état actuel avec des instructions d’interrogation.
`retry_activation`	Demander un autre SMS sur le même numéro. Gratuit.
`cancel_activation`	Annuler une activation en cours avant la réception du SMS. Rembourse le montant réservé.

Remarque : Les catalogues de pays et de services sont mis en cache côté serveur et résolus automatiquement à partir de noms lisibles. L’agent ne reçoit jamais le catalogue complet — uniquement les identifiants résolus ou des indications de désambiguïsation.

Flux typique de l’agent IA

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

Étapes optionnelles :

retry_activation — demander un autre SMS sur le même numéro (gratuit)
cancel_activation — annuler avant l’arrivée du SMS (rembourse le solde)

Développement

Consultez le Guide de développement complet pour les instructions de configuration et les conseils de test.

Dépannage

Erreur	Solution
`UnauthorizedException`	Vérifiez que votre `PLATFONE_API_KEY` est valide
`PaymentRequiredException`	Rechargez votre solde Platfone
`NoNumbersAvailableException`	Essayez un autre pays ou service
`TooManyRequestsException`	Limite de débit atteinte — attendez et réessayez
`MaxPriceExceededException`	Réessayez `order_number` avec le `max_price` suggéré et le `order_id` renvoyé
`TooManyActivationsException`	Nombre maximal d’activations simultanées atteint — annulez ou attendez l’expiration

Licence

Voir LICENSE.md. Sous licence MIT.

L’utilisation de l’API Platfone est soumise aux Conditions d’utilisation et à la Politique de confidentialité.