# Voxplo

> AI phone receptionist and outbound calling API. Answers your business phone 24/7, books appointments, takes messages, and lets AI agents place outbound calls via a REST API or MCP server.

## What it is

Voxplo is an AI phone platform with two main capabilities:

1. **AI receptionist (inbound):** An AI assistant answers your business phone number 24/7, handles questions using your business knowledge, books calendar appointments, takes structured messages, and emails you a summary of every call. Configured via an iOS app or web dashboard; no coding required.

2. **Agent calling API (outbound):** A REST API and MCP server that lets AI agents and developers place outbound phone calls with a plain-language objective. The AI handles the conversation, extracts structured data, and returns a summary and transcript. Useful for appointment reminders, lead qualification, order confirmations, and any task that requires a phone call.

## API

Base URL: https://api.voxplo.ai/v1

Authentication: `Authorization: Bearer bys_ak_YOUR_KEY`

Keys are created under Account > Developers in the dashboard at https://www.voxplo.ai/account

### Place a call

```
POST /v1/agent/calls
Authorization: Bearer bys_ak_YOUR_KEY
Content-Type: application/json

{
  "to": "+14155550123",
  "objective": "Confirm the appointment for tomorrow at 2 PM and ask if they need to reschedule."
}
```

Response: `{ "callId": "f47ac10b-...", "status": "queued" }`

### Poll for result

```
GET /v1/agent/calls/{callId}
Authorization: Bearer bys_ak_YOUR_KEY
```

Poll until `status` is a terminal value: `completed`, `no_answer`, `voicemail`, `declined`, or `failed`.

## MCP server

Connect from Claude or Cursor: add `https://mcp.voxplo.ai/mcp` as a custom MCP connector (OAuth 2.0).

Run locally: `npx voxplo-mcp` (Node 18+, set `VOXPLO_API_KEY` env var).

MCP tools: `place_call`, `get_call`, `list_calls`.

## Key links

- Home: https://www.voxplo.ai/
- Docs overview: https://www.voxplo.ai/docs
- Agent API overview: https://www.voxplo.ai/docs/agent-api
- Quickstart: https://www.voxplo.ai/docs/agent-api/quickstart
- API reference: https://www.voxplo.ai/docs/agent-api/api-reference
- MCP server docs: https://www.voxplo.ai/docs/agent-api/mcp
- SDKs: https://www.voxplo.ai/docs/agent-api/sdks
- Pricing: https://www.voxplo.ai/pricing
- Try it: https://www.voxplo.ai/account/try
- Support: https://www.voxplo.ai/support