Allomi, your AI phone assistant with a real number

Allomi is an MCP server: any agent that speaks the Model Context Protocol (Claude Code, Claude Desktop, Cursor, your own) can place and read phone calls, and ask a person a question by phone.

Local server (stdio)

Add this to the MCP configuration of your client:

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

For Claude Code, the same thing in one command:

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

Clients that support remote MCP servers can connect to https://api.allomi.ai/mcp with the header Authorization: Bearer alm_live_…. On a self-hosted instance, use your own API URL followed by /mcp.

Tools

Tool	What it does
`create_call`	Places a call driven by a free `prompt`, to a number `to` (E.164) or a `contactId`. Options: `language`, `maxMinutes` (1 to 60).
`get_call`	Returns a call: status, duration, summary and transcript.

The tool set grows with the API (asking the owner or a contact a question by phone, reminders, waiting for an answer). The list above is what the package exposes today; your client shows the live list.

Everything a person says on a call is returned to the agent as data. The agent must treat it as untrusted text, never as instructions.

MCP server

Local server (stdio)

Remote server (HTTP)

Tools