# asterisk-mcp

MCP server for **Asterisk in Docker** on the ship VM (`shipPortal`). SSH + `docker exec` + `asterisk -rx`.

## Quick start

```bash
cd ~/Projects/asterisk-mcp
python3 -m venv .venv && .venv/bin/pip install -e .
```

### Connect

```text
asterisk_connect(
  ssh_host="10.20.30.222",
  ssh_key_path="/Users/nearxos/.ssh/id_ed25519",
  container="asterisk",
  name="golden-asterisk"
)
asterisk_test_connection()
asterisk_pjsip_show_endpoints()
```

## Tools

| Tool | Description |
|------|-------------|
| `asterisk_connect` / `asterisk_use_target` | Persisted targets |
| `asterisk_cli` | Arbitrary `asterisk -rx` |
| `asterisk_pjsip_show_endpoints` | Registration state |
| `asterisk_core_show_channels` | Active calls |
| `asterisk_get_logs` | Tail `/var/log/asterisk/full` |
| `asterisk_read_config` | Read file in container |
| `asterisk_module_reload` | Reload module (writes) |

## License

MIT