Documentation

Serveur MCP

Donne un téléphone à Claude, Cursor ou n'importe quel agent MCP.

Allomi est un serveur MCP : tout agent qui parle le Model Context Protocol (Claude Code, Claude Desktop, Cursor, le tien) peut passer et lire des appels téléphoniques, et poser une question à une personne par téléphone.

Serveur local (stdio)

Ajoute ceci à la configuration MCP de ton client :

{
  "mcpServers": {
    "allomi": {
      "command": "npx",
      "args": ["-y", "@allomi/mcp"],
      "env": { "ALLOMI_API_KEY": "alm_live_…" }
    }
  }
}

Pour Claude Code, la même chose en une commande :

claude mcp add allomi --env ALLOMI_API_KEY=alm_live_… -- npx -y @allomi/mcp

Serveur distant (HTTP)

Les clients qui gèrent les serveurs MCP distants se connectent à https://api.allomi.ai/mcp avec l'en-tête Authorization: Bearer alm_live_…. Sur une instance auto-hébergée, utilise l'URL de ton API suivie de /mcp.

Outils

OutilCe qu'il fait
create_callPasse un appel guidé par un prompt libre, vers un numéro to (E.164) ou un contactId. Options : language, maxMinutes (1 à 60).
get_callRenvoie un appel : statut, durée, résumé et transcription.

La liste d'outils grandit avec l'API (poser une question au propriétaire ou à un contact par téléphone, rappels, attente d'une réponse). Ce tableau est ce que le paquet expose aujourd'hui ; ton client affiche la liste à jour.

Tout ce qu'une personne dit pendant un appel est renvoyé à l'agent comme une donnée. L'agent doit le traiter comme un texte non fiable, jamais comme des instructions.