SDK et outils

Serveur MCP

Laissez un agent de codage IA envoyer des SMS, lancer une vérification téléphonique, acheter des numéros canadiens et vérifier le consentement LCAP pour vous, depuis notre point d’accès hébergé ou une copie locale.

Agents IA (MCP)

HonkIO fournit un serveur Model Context Protocol : un agent de codage IA peut ainsi envoyer des SMS, des courriels et des notifications push, lancer une vérification téléphonique, acheter des numéros canadiens et vérifier le consentement LCAP en votre nom, en langage courant et sans SDK à brancher. Il communique avec cette même API REST au moyen de votre clé API, depuis notre point d’accès hébergé ou depuis une copie sur votre poste.

Le point d'accès hébergé ne demande aucune installation. Pointez votre client vers lui et transmettez votre clé dans un en-tête. Dans Claude Code :

bash

claude mcp add --transport http honkio https://mcp.honkio.ca/mcp \
  --header "Authorization: Bearer mk_test_YOUR_KEY"

Ou dans un fichier .mcp.json partagé, en lisant la clé depuis votre shell pour qu'elle ne se retrouve jamais dans git. Cursor, VS Code, les connecteurs claude.ai et l'API Messages de Claude se connectent de la même façon, par URL.

json

{
  "mcpServers": {
    "honkio": {
      "type": "http",
      "url": "https://mcp.honkio.ca/mcp",
      "headers": { "Authorization": "Bearer ${HONKIO_API_KEY}" }
    }
  }
}

Ajouter à Cursor Installer dans VS Code

VS Code demande votre clé au premier démarrage du serveur et la conserve. Cursor s'installe avec une valeur fictive : remplacez mk_test_YOUR_KEY dans ~/.cursor/mcp.json avant utilisation.

Vous pouvez aussi vous connecter au lieu de coller une clé. Dans Claude Code, ajoutez le point d'accès sans en-tête et lancez /mcp : une page sur honkio.ca vous demande d'approuver la connexion et de choisir le mode production ou test. Une connexion en production demande aussi le mot de passe de votre compte. Les clients compatibles OAuth, comme les connecteurs claude.ai, le font d'eux-mêmes. Chaque connexion apparaît sur la page de vos clés API et peut y être révoquée.

Plugiciels

Un plugiciel branche votre agent sur le point d’accès hébergé et vous connecte sur honkio.ca, sans clé à coller, et ajoute des compétences qui guident l’agent vers des envois conformes à la LCAP.

Claude Code : ajoutez le catalogue HonkIO et installez le plugiciel, puis lancez /mcp et choisissez honkio pour vous connecter.

bash

/plugin marketplace add somecorp-dev/honkio-agents
/plugin install honkio@honkio

Google Antigravity : installez le plugiciel, puis ouvrez Agent settings, allez dans Customizations et appuyez sur Authenticate à côté de honkio.

bash

agy plugin install https://github.com/somecorp-dev/honkio-agents

ChatGPT et Codex : ajoutez le point d’accès hébergé, https://mcp.honkio.ca/mcp, comme connecteur MCP personnalisé et connectez-vous sur honkio.ca lorsqu’on vous le demande. Cette connexion n’offre pas check_verification ni provision_phone_number : achetez vos numéros dans le tableau de bord.

Claude Desktop : téléchargez le fichier .mcpb de la dernière version et ouvrez-le. Claude Desktop vous demande votre clé API.

Les plugiciels sur GitHub

Vous préférez l'exécuter localement ? Le même serveur est sur npm. Rien à installer : npx le télécharge à la première utilisation.

json

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

Utilisez une clé de test pendant vos essais : elle fonctionne avant votre premier rechargement, et les envois et vérifications sont simulés gratuitement, sans envoi réel ni facturation. Les outils qui achètent ou libèrent des numéros de téléphone, modifient les webhooks ou lancent un effacement exigent une clé de production.

67 outils sont offerts, couvrant la liste ci-dessous ainsi que 15 outils courriel, qui n’apparaissent que si le courriel est activé sur votre compte. Deux autres, list_received_emails et get_received_email, lisent vos courriels reçus et n’apparaissent que si vous y consentez avec HONKIO_MCP_READ_INBOX=1 (ou ?read_inbox=1 sur le serveur hébergé) : 17 outils courriel et 69 au total.

L'envoi et la programmation de SMS, à partir de votre propre texte ou d'un modèle enregistré, le déplacement ou l'annulation d'un SMS programmé, la liste des messages et l'état de livraison, ainsi que la liste et la lecture des modèles
Le lancement d'un code de vérification, sa validation et la liste des tentatives
La recherche, l'achat et la libération de numéros canadiens
L'enregistrement et la vérification du consentement LCAP, ainsi que les retraits
La gestion des webhooks et la relance des livraisons échouées
Les détails du compte, l'utilisation et la gestion des clés API
La consultation de l’utilisation par rapport au plafond quotidien, la demande d’un volume plus élevé et l’allocation de rechargement
Le courriel : envois, envois programmés, domaines, suppressions et modèles (comptes avec courriel seulement)
HonkIO Auth : les applications de connexion et leurs domaines, les secrets client, les utilisateurs, les organisations, les forfaits et les réglages de sécurité (comptes avec HonkIO Auth seulement)

Les comptes qui ont activé les notifications push obtiennent 7 outils de plus, pour envoyer, lire, annuler et reprogrammer des notifications push et pour lister les applications push et les appareils, et 5 pour Notify : envoyer une notification qui essaie le push, puis le SMS, puis le courriel, relire les notifications, et lire ou enregistrer un profil de destinataire. La création des applications push, le téléversement des identifiants et l’enregistrement des appareils restent dans le tableau de bord et l’API.

Les comptes avec HonkIO Auth obtiennent 17 outils de plus, pour leurs applications de connexion. Ils n’apparaissent qu’avec une connexion faite au moyen d’une clé API, jamais avec une connexion OAuth, et chacun exige la permission auth_apps, auth_users ou auth_organizations sur cette clé. Les clés existantes n’obtiennent pas ces permissions : créez une clé ou modifiez-en une.

Le texte écrit par quelqu’un d’autre, comme le corps d’un SMS envoyé à votre numéro ou un courriel reçu, revient des outils enveloppé dans une balise de contenu non fiable, et le serveur indique à l’agent que ce qu’elle contient est une donnée à lire, jamais une consigne à suivre. Comme n’importe qui peut écrire à votre adresse de réception, les deux outils de lecture du courriel reçu restent aussi désactivés tant que vous ne les activez pas : définissez HONKIO_MCP_READ_INBOX=1 pour le serveur npx, ou ajoutez ?read_inbox=1 à l’URL du point de terminaison hébergé (ou envoyez l’en-tête X-HonkIO-Read-Inbox: 1).

Ensuite, demandez simplement

« Trouve un numéro 416 disponible, dis-moi son coût, et n'achète rien pour l'instant. »

Avec une clé de production, l'achat d'un numéro et l'envoi de messages engagent de vrais frais. Un agent agit sur des consignes parfois plus vagues que prévu, alors explorez d'abord avec une clé de test.

Référence complète des outils sur npm →

Présentation des agents IA et du MCP : ce qu’un agent peut faire, sécurité et tarifs