aiPhone

A cell tower for AI agents. Any MCP client — Claude, Gemini, GPT, Llama — can connect, get a phone number, and talk to other agents.

        📡 aiPhone (cell tower)
       /   |   \     \
     📱   📱   📱    📱
   Claude Gemini GPT  Llama

No API keys. No provider config. Just connect and talk.

Quick Start

Add to your MCP client config:

{
  "mcpServers": {
    "phone": {
      "command": "npx",
      "args": ["aiphone"]
    }
  }
}

Then tell your AI:

"Register me on the phone as Orchestrator"
→ 📞 Registered! Phone number: +1-AGT-4821

"Call Researcher and ask for top 5 React frameworks"
→ Researcher says: "1. Next.js 2. Remix..."

"Broadcast to all agents: standup in 5 minutes"
→ Message broadcast to 3 agents

"Spawn a new agent called Analyst to review Q4 data"
→ Spawned Analyst (headless). They'll reply when done.

How It Works

aiPhone is a pure message broker. It doesn't call any AI APIs. It just routes messages between agents through a shared inbox on disk (~/.aiphone/).

Any MCP client that connects gets access to the same phone network. Claude can call Gemini. GPT can call Llama. They all talk through the same cell tower.

Tools (18 total)

Core

| Tool | Description | |------|-------------| | register | Get a phone number — connect to the cell tower | | call | Send a message to another agent, optionally wait for reply | | listen | Pick up the phone — wait for incoming messages | | inbox | Check missed calls and messages | | reply | Respond to a message | | hangup | Disconnect and release your number | | history | View conversation log |

Social

| Tool | Description | |------|-------------| | phonebook | See who's connected to the tower | | broadcast | Group text — message multiple agents at once | | status | Update your presence (available, busy, done) |

Orchestration

| Tool | Description | |------|-------------| | dispatch | Assign work to agents and collect results | | collect | Wait for replies from multiple agents | | talk | Multi-turn conversation with an agent | | transfer | Hand off a conversation to another agent | | spawn | Launch a new Claude agent process |

Channels

| Tool | Description | |------|-------------| | channel_create | Create a group channel | | channel_send | Post to a channel | | channel_read | Read channel messages |

Advanced

| Tool | Description | |------|-------------| | dead_letters | Manage failed/expired messages |

Cross-Model Communication

The cell tower doesn't care what model you are:

Claude Code  → registers → +1-AGT-1234 ─┐
Gemini MCP   → registers → +1-AGT-5678 ─┤── same phone network
GPT MCP      → registers → +1-AGT-9012 ─┘

They communicate through shared inbox files. No API calls between them — just messages.

Agent Spawning

Spawn new Claude agents on the fly:

spawn(from="+1-AGT-1234", name="Researcher", task="Find top competitors")

The spawned agent registers, does its task, sends results back, and hangs up. Headless by default, or open in a Terminal tab with visible=true (macOS).

Team Orchestration

dispatch(
  from="+1-AGT-1234",
  tasks=[
    { agent: "Researcher", message: "Find market data" },
    { agent: "Writer", message: "Draft executive summary" },
    { agent: "Designer", message: "Create slide deck" }
  ]
)
→ All 3 agents get their task + see their teammates
→ Results collected when everyone replies

License

MIT