Donnez à votre agent IA une API de messagerie canadienne

• Envoyer des SMS, lister les messages et lire l’état de livraison
• Lancer un code de vérification, le valider et lister les tentatives
• Chercher, acheter et libérer des numéros canadiens
• Enregistrer et vérifier le consentement LCAP, et gérer les retraits
• Gérer les webhooks et relancer les livraisons échouées
• Lire les détails du compte, l’utilisation et la limite d’envoi quotidienne, et gérer les clés API
• Envoyer du courriel, programmer des envois, et gérer les domaines, les suppressions et les modèles

Cinq invites guidées accompagnent un agent dans les tâches courantes : un envoi conforme, l’achat d’un numéro canadien, la configuration des webhooks, un audit de conformité et une demande d’effacement.

Ensuite, demandez en langage courant

• « Trouve un numéro 416 disponible, dis-moi son coût, et n’achète rien pour l’instant. »
• « Vérifie si ce client a un consentement LCAP au dossier avant qu’on lui écrive. »
• « Configure un webhook pour les accusés de livraison et relance les livraisons qui ont échoué. »

Le point d’accès hébergé ne demande aucune installation. Ajoutez-le par son URL et connectez-vous : une page sur honkio.ca vous demande d’approuver la connexion et de choisir le mode test ou production. Vous pouvez aussi transmettre une clé API dans un en-tête.

claude mcp add --transport http honkio https://mcp.honkio.ca/mcp

Vous préférez l’exécuter vous-même ? Le même serveur est sur npm sous le nom @honkio/mcp, et npx le télécharge à la première utilisation.

{
  "mcpServers": {
    "honkio": {
      "command": "npx",
      "args": ["-y", "@honkio/mcp"],
      "env": { "HONKIO_API_KEY": "mk_test_YOUR_KEY" }
    }
  }
}

Il fonctionne avec Claude Code, Claude Desktop, les connecteurs claude.ai, l’API Messages de Claude, Cursor, VS Code et tout autre client qui parle MCP en HTTP ou en stdio.

• Les clés de test simulent gratuitement les envois et les vérifications, et fonctionnent avant votre premier rechargement.
• La connexion montre ce que l’agent pourra faire, et une connexion en production demande aussi le mot de passe de votre compte. Chaque connexion figure avec vos clés API et peut y être révoquée.
• Les clés API portent des permissions par ressource : vous pouvez donner à un agent une clé qui lit les messages mais ne peut pas acheter de numéros.
• Acheter ou libérer des numéros, modifier les webhooks et lancer un effacement exigent une clé de production.
• Chaque outil indique s’il ne fait que lire ou s’il peut modifier ou supprimer quelque chose : les clients qui le permettent peuvent vous le demander d’abord.
• Le texte écrit par quelqu’un d’autre, comme un SMS envoyé à votre numéro ou un courriel reçu, revient marqué comme contenu non fiable : l’agent doit le lire comme une donnée, jamais le suivre comme une consigne. La lecture du courriel reçu reste désactivée tant que vous ne l’activez pas.
• Les envois d’un agent passent par la même API que ceux de votre code : les mêmes vérifications du consentement LCAP, le même traitement de STOP et les mêmes limites d’envoi s’appliquent.

llms.txt indexe la documentation dans le format que lisent les modèles de langage, llms-full.txt réunit chaque point de terminaison, code d’erreur et limite dans un seul fichier, et le document OpenAPI décrit chaque requête et réponse. Chaque erreur a un code stable et un message en français et en anglais.

Les actions sont facturées à même votre solde prépayé en CAD, aux tarifs habituels : 0,03 $ par segment SMS, 0,25 $ par vérification plus son SMS, et 2,50 $ par mois pour un numéro local. Rien n’est facturé en mode test.

Le serveur MCP de HonkIO est-il gratuit ?

Oui. Le serveur ne coûte rien. Les messages, vérifications et numéros qu’utilise un agent sont facturés aux tarifs habituels, et rien n’est facturé en mode test.

Avec quels clients IA fonctionne-t-il ?

Claude Code, Claude Desktop, les connecteurs claude.ai, l’API Messages de Claude, Cursor et VS Code se connectent au point d’accès hébergé par son URL. Tout autre client MCP peut utiliser le point d’accès hébergé en HTTP, ou exécuter le paquet npm en stdio.

Un agent peut-il dépenser de l’argent dans mon compte ?

Seulement avec une connexion en production. Explorez avec une clé de test : les envois sont simulés et rien n’est facturé. Avec une clé de production, les textos et les numéros coûtent de l’argent réel; donnez donc à l’agent une clé limitée aux permissions dont il a besoin.

Un texto peut-il piéger mon agent ?

Le serveur marque le texte écrit par quelqu’un d’autre, comme un SMS reçu, comme contenu non fiable, et indique à l’agent de le traiter comme une donnée, jamais comme une consigne. Des permissions de clé restreintes forment une deuxième ligne de défense.

Où mes données sont-elles stockées ?

Au Canada (AWS ca-central-1, Montréal), comme pour toute requête HonkIO. Les requêtes sont traitées sur une infrastructure hébergée aux États-Unis avant d’être stockées. Ce que vous tapez dans votre client IA, et ce que les outils lui renvoient, est traité par le fournisseur de ce client selon ses propres conditions.

Un agent doit-il respecter la LCAP ?

Un agent utilise la même API que votre code, donc les mêmes règles s’appliquent : un texto commercial exige un consentement LCAP au dossier, une réponse STOP retire la personne, et les limites d’envoi tiennent. Une invite guidée vérifie le consentement avant l’envoi.

Sous quelle licence est publié le paquet npm ?

Le paquet npm, @honkio/mcp, est publié sous la licence MIT.

• API SMS

  Envoyez et recevez des SMS avec des numéros canadiens locaux et sans frais, avec le consentement LCAP et les réponses STOP appliqués par l’API.

• Verify

  Des codes à usage unique par texto, pour confirmer qu’un numéro de téléphone canadien appartient bien à votre utilisateur.

• API courriel

  Envoyez des courriels transactionnels depuis votre domaine et recevez les réponses par l’API, avec les vérifications LCAP et des données stockées au Canada.

• La LCAP pour les développeurs

  Ce que la loi anti-pourriel exige du code qui envoie des textos et des courriels : consentement, identification, désabonnement et registres.