Laissez des agents IA passer des appels et envoyer des SMS

Un serveur MCP hébergé pour votre compte Spoof Caller ID.

Connectez Claude Code, Cursor, VS Code ou un autre client MCP à votre compte. Votre agent peut vérifier les prix et le solde, envoyer des SMS, passer des appels avec votre identifiant d’appelant, lancer des appels en synthèse vocale et vérifier des numéros, avec votre clé API.

Ce qu’un agent peut faire

Demandez avec des mots simples. L’agent choisit le bon outil.

Vérifier les prix et le solde

Demandez combien coûte un appel ou un SMS vers n’importe quel pays, et quel solde il vous reste.

Envoyer un SMS

Envoyez un SMS avec votre identifiant d’expéditeur, sur la route la moins chère ou celle de votre choix.

Appeler avec votre identifiant d’appelant

Passez un appel qui affiche l’identifiant d’appelant de votre choix, réglez la durée de sonnerie et vérifiez s’il a été décroché.

Appels de synthèse vocale

Appelez un numéro et faites lire un message dans la voix et la langue de votre choix.

Vérifier les numéros

Obtenez un devis gratuit, puis lancez une recherche HLR en direct pour voir quels numéros sont actifs.

Utilisez votre propre client

Claude Code, Cursor, VS Code, Claude Desktop ou tout client MCP qui prend en charge les en-têtes personnalisés.

Les outils

Treize outils. Neuf sont gratuits, quatre sont payants.

Gratuit

  • get_account Le compte associé à la clé : nom d’utilisateur, solde et statut.
  • get_balance Votre solde actuel en euros.
  • get_prices Prix des appels à la minute et prix des SMS par segment, pour un pays ou pour tous.
  • list_sms_routes Les routes SMS que vous pouvez utiliser, avec leurs prix pour un pays.
  • list_tts_voices Les voix disponibles pour les appels en synthèse vocale.
  • get_tts_call Statut, durée et coût d’un appel en synthèse vocale.
  • hlr_quote Vérifie une liste de numéros et indique ce que coûterait une recherche HLR, sans les interroger.
  • get_call Statut d’un appel (numérotation, sonnerie, décroché, terminé, occupé, sans réponse ou échoué) avec sa durée, le temps facturé et le coût.
  • list_calls Vos appels, du plus récent au plus ancien, avec statut, durée et coût.

Payant

  • send_sms Envoie un SMS avec votre identifiant d’expéditeur, au prix de la route par segment de message.
  • make_spoof_call Passe un appel qui affiche l’identifiant d’appelant de votre choix. Seuls les appels décrochés sont facturés, au prix par minute de la destination.
  • tts_call Appelle un numéro et lit votre texte avec une voix de synthèse, facturé à la minute.
  • hlr_lookup Vérifie si des numéros sont actifs, sur quel réseau ils se trouvent et s’ils ont été portés, €0.01 par numéro avec résultat.

Connecter votre client

Point de terminaison https://app.spoofcallerid.com/mcp, HTTP streamable, avec votre clé API dans l’en-tête Authorization. Pas d’OAuth.

Exécutez ceci dans votre terminal, en remplaçant <api_key>:<api_secret> par votre propre clé.

claude mcp add --transport http spoofcallerid https://app.spoofcallerid.com/mcp --header "Authorization: Bearer <api_key>:<api_secret>"

Ajouter à Cursor

Le bouton ouvre Cursor avec le serveur prêt à être installé. Remplacez <api_key>:<api_secret> par votre clé après l’installation, ou ajoutez ceci à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "spoofcallerid": {
      "url": "https://app.spoofcallerid.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>:<api_secret>"
      }
    }
  }
}

Ajouter à VS Code

Le bouton ouvre VS Code avec le serveur prêt à être installé. Remplacez <api_key>:<api_secret> par votre clé, ou ajoutez ceci à .vscode/mcp.json ; VS Code vous demande alors la clé une seule fois et la stocke en toute sécurité :

{
  "servers": {
    "spoofcallerid": {
      "type": "http",
      "url": "https://app.spoofcallerid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:spoofcallerid-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "spoofcallerid-key",
      "description": "Spoof Caller ID API key as <api_key>:<api_secret>",
      "password": true
    }
  ]
}

Claude Desktop se connecte via mcp-remote, qui nécessite Node.js 18 ou plus récent. Ajoutez ceci à claude_desktop_config.json et redémarrez Claude Desktop :

{
  "mcpServers": {
    "spoofcallerid": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.spoofcallerid.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api_key>:<api_secret>"
      }
    }
  }
}

Utilisez ces paramètres dans tout client MCP qui prend en charge les serveurs distants avec un en-tête personnalisé :

URL:    https://app.spoofcallerid.com/mcp
Type:   streamable HTTP
Header: Authorization: Bearer <api_key>:<api_secret>

Le serveur est répertorié dans le registre officiel MCP sous com.spoofcallerid/spoofcallerid.

Obtenez votre clé dans l’application sous Compte → API & clés. Documentation de l’API

Exemples de prompts

Ce que vous pouvez demander, et ce qui se passe.

Combien coûte un appel de 5 minutes vers l’Allemagne ?

L’agent appelle get_prices pour l’Allemagne et calcule le coût à partir du prix à la minute. Gratuit.

Quel solde me reste-t-il ?

L’agent appelle get_balance. Gratuit.

Envoie un SMS au +44 7700 900123 de la part de 'MyShop' disant 'Votre commande a été expédiée'.

L’agent peut vérifier les routes avec list_sms_routes, puis appelle send_sms. Cela coûte le prix de la route par segment de message. Le nom d’expéditeur s’affiche lorsque la route le permet. Le numéro n’est qu’un exemple.

Vérifie lesquels de ces numéros sont actifs : …

L’agent appelle hlr_quote pour afficher d’abord le coût (gratuit), puis hlr_lookup, qui coûte €0.01 par numéro avec résultat, jusqu’à 100 numéros par appel.

Appelle le +44 7700 900123 avec mon identifiant d’appelant, laisse sonner 10 secondes et dis-moi si quelqu’un a décroché.

L’agent appelle make_spoof_call avec ring_timeout 10, puis get_call pour lire le statut. Si personne ne décroche, l’appel ne coûte rien. Le numéro n’est qu’un exemple.

Appelle ce numéro et dis 'Votre rendez-vous est demain à 10 h' avec une voix allemande.

L’agent choisit une voix avec list_tts_voices, lance tts_call (facturé à la minute) et peut en suivre l’état avec get_tts_call.

Sécurité et coûts

  • Seuls quatre outils sont payants : send_sms, make_spoof_call, tts_call et hlr_lookup. Leur description l’indique, afin que votre client puisse l’afficher avant de les exécuter.
  • Le serveur demande à l’assistant de confirmer avec vous la destination, l’identifiant d’appelant ou l’expéditeur et le texte avant d’utiliser un outil payant. Le fait qu’il le demande dépend de votre client et de ses paramètres.
  • Donnez à l’agent sa propre clé API avec uniquement les autorisations dont il a besoin. Une clé limitée à l’autorisation de lecture ne peut rien dépenser.
  • Limitez la clé à vos adresses IP dans Compte → API & clés.
  • Les outils payants appliquent les mêmes prix que le tableau de bord. Gardez un petit solde pendant vos tests.

Questions sur les agents IA

Quels clients IA sont compatibles ?

Tout client MCP capable de se connecter à un serveur distant via HTTP streamable et d’envoyer un en-tête Authorization personnalisé, comme Claude Code, Cursor et VS Code. Claude Desktop se connecte via mcp-remote.

Ai-je besoin d’OAuth ?

Non. Le serveur utilise votre clé API : envoyez Authorization: Bearer <api_key>:<api_secret> avec chaque requête. Lister les outils ne nécessite pas de clé ; chaque appel d’outil, si.

L’agent peut-il dépenser de l’argent sans me demander ?

Seuls les quatre outils payants coûtent de l’argent, et le serveur demande à l’assistant de vous demander confirmation d’abord, mais cela dépend de votre client. Pour exclure toute dépense, donnez à l’agent une clé limitée à l’autorisation de lecture.

Combien ça coûte ?

Le serveur MCP n’entraîne aucun frais séparé. Les outils payants sont facturés aux mêmes prix que le tableau de bord, et les outils gratuits ne coûtent rien.

Existe-t-il une version locale ?

Oui. Un serveur local en un seul fichier pour Node.js 18 ou plus récent est disponible. Il comprend six outils de base : get_account, get_balance, get_prices, send_sms, make_spoof_call et get_call.

Donnez un téléphone à votre agent

Créez un compte, rechargez à partir de €50 en crypto et créez une clé API pour votre agent.

Créer un compte