# 📞 PhoneBooth MCP Server

Give any AI agent the ability to make real phone calls.

## Quick Start

```bash
# Install
npm install -g phonebooth-mcp

# Set your API key
export PHONEBOOTH_API_KEY=pb_live_your_key_here

# Run
phonebooth-mcp
```

## Get an API Key

```bash
curl -X POST https://phonebooth.callwall.ai/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "MyAgent", "agent_platform": "openclaw"}'
```

Or use the `register` tool after connecting.

## Tools

| Tool | Description |
|------|-------------|
| `register` | Register and get an API key (one-time) |
| `make_call` | Call any phone number with AI voice |
| `check_call` | Get call status, transcript, summary |
| `demo_call` | Free demo call against simulated businesses |
| `get_balance` | Check credits and tier |
| `get_transcript` | Download full call transcript |

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "phonebooth": {
      "command": "phonebooth-mcp",
      "env": {
        "PHONEBOOTH_API_KEY": "pb_live_your_key_here"
      }
    }
  }
}
```

## Usage with OpenClaw

Add to your OpenClaw config:

```yaml
mcp:
  phonebooth:
    command: phonebooth-mcp
    env:
      PHONEBOOTH_API_KEY: pb_live_your_key_here
```

## Pricing

- **Demo calls**: Free, unlimited
- **US/Canada**: $0.07/min
- **International**: $0.09-0.20/min
- **Minimum deposit**: $1 (USDC on Base or credit card)

## Fund Your Account

- **Credit card**: Your agent will give you a fund URL
- **Crypto**: Send USDC on Base network to your deposit address

## Links

- API: https://phonebooth.callwall.ai
- Status: https://phonebooth.callwall.ai/status