Put Vii on your own line.
One API for calls, texts and the record of what happened. Or connect your AI assistant through MCP and let it use the phone with your permission.
Three ways to start.
Use one, or combine them.
- A voice line. Send a command, propose an outreach, confirm it, and read the outcome.
- Text. Send an SMS or WhatsApp message and receive the reply through the same API.
- MCP. Expose calls, notes, reminders, orders and catalogs to Claude, ChatGPT or your own agent.
Authentication uses a Firebase ID token for app users, or a personal MCP key (vr_mcp_...) for assistants. Keys are scoped and can be revoked.
# See what the MCP server offers
curl https://api.voicereach.app/mcp \
-H "Accept: application/json"
const res = await fetch("https://api.voicereach.app/mcp", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer vr_mcp_..."
},
body: JSON.stringify({
jsonrpc: "2.0", id: 1, method: "tools/call",
params: { name: "vii_notes_list", arguments: {} }
})
});
const data = await res.json();
import requests
r = requests.post(
"https://api.voicereach.app/vii/command",
headers={"Authorization": "Bearer <id-token>"},
json={"text": "call me in 10 minutes to take a break"},
)
print(r.json())
Tools your assistant can use.
Read-only by default. Outreach always needs a proposal and a confirmation.
| Tool | What it does | Access |
|---|---|---|
| search_businesses | Find a business by name, category or city | Public |
| get_business_catalog | Read products, prices and stock | Public |
| create_business_order_inquiry | Send an order inquiry to a business | Public |
| vii_notes_list | Read your private notes | Personal key |
| vii_reminders_create | Create a reminder after confirmation | Personal key |
| vii_propose_outreach | Propose a call or text, with a read-back | Personal key |
| vii_confirm_outreach | Confirm a proposed outreach | Personal key |
| merchant_list_inbox | List live leads and cases | Merchant key |
Nothing happens by accident.
The API follows the same rules as the phone line.
- Propose, then confirm. Any call or message to a person needs a read-back and an explicit confirmation.
- Scoped keys. A key can be limited to reads, notes, outreach or the store. Revoke it at any time.
- Rate limits. 60 requests a minute per key, with clear errors and recovery hints.
- Recoverable errors. Tool errors return an actionable message so the agent can adjust without guessing.
Built for real telephony
Carrier connections, recorded outcomes, per-tenant isolation and a durable job queue. You do not run a gateway or a media server.
Voice notes, transcripts and case records are available through the API and MCP.
Build with VoiceReach.
Tell us what you are building and we will send you access.