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, 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}" }
    }
  }
}

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.

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.

64 outils sont offerts, couvrant la liste ci-dessous ainsi que le courriel. Les 17 outils courriel n’apparaissent que si le courriel est activé sur votre compte.

  • L'envoi de SMS, la liste des messages et l'état de livraison
  • 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)

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 →