Bond-OpenAI MCP
This server lets an MCP agent safely classify, preview, place, monitor, and cancel a single consented phone call and receive a structured result.
bond.classify_task: determine whether a task needs a phone call, needs more input, or is not a phone call.bond.create_phone_task: validate and preview a phone task; preview stores nothing, and confirmed creation uses an idempotency key to place at most one consented, allowlisted call.bond.get_phone_task_status: retrieve a structured result with status, outcome, and summary.bond.cancel_phone_task: cancel or hang up an active phone task.Built-in safeguards: consent confirmation, exact E.164 allowlist, verified caller ID, no recording, 180-second cap, one active call at a time, idempotent replay, and no blind redial.
Provides hosted speech recognition, dialogue, and text-to-speech for the voice agent during phone calls.
Provides PSTN telephony and verified-caller identity for the phone runtime, enabling the MCP server to place and manage consented phone calls.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bond-OpenAI MCP call the Italian restaurant on Main St to reserve a table for two at 7pm"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bond-OpenAI: a safe phone action for any agent
Agents can read, write and click. Then the workflow needs a phone call, and they stop.
A local MCP server that lets Codex, Bond or any MCP client place one consented, human-confirmed, time-boxed phone call and get a structured result back into the task. Finalist at the OpenAI Codex Hackathon.
Français : README.fr.md
The problem
Booking a restaurant, chasing an administration, confirming an appointment, asking a supplier for a quote: in many real workflows the blocking step is not the reasoning, it is calling a person. Agents can prepare everything up to that point and then hand the task back to you. Giving an agent a raw telephony API is not the answer: nothing stops it from dialing the wrong number, calling twice on a retry, recording without consent or talking for twenty minutes. The phone call has to be an action with the same guarantees you would expect from a careful assistant.
Related MCP server: voxaphone-mcp
How it solves it
Bond-OpenAI exposes the phone as four MCP tools with a fixed flow: classify → clarify → preview → explicit confirmation → verified call → structured result.
Agent task ("call the restaurant and reserve a table")
↓ MCP over stdio
Local Bond-OpenAI MCP
classify → clarify → preview → explicit confirmation → call
↓
Fredo phone runtime
Twilio verified caller ID + Deepgram voice agent, 180 s cap
↓
Structured result (status, outcome, summary) returned to the taskKey design decisions:
Two-step creation.
bond.create_phone_taskwithoutconfirmed: truereturns a preview and stores nothing. A human approves, the agent repeats the call withconfirmed: true. Rejecting the preview means zero carrier calls.Policy outside the model. Consent must be literal
true; the destination must be a canonical E.164 number on an exact allowlist; the caller ID is always the operator's verified number. The task input cannot change caller ID, recording or duration.Idempotent and single-flight. An idempotency key is required; a replay returns the stored result, a changed payload is rejected, a failed attempt is never redialed. One active call at a time, enforced in SQLite across processes.
Provider-neutral core.
policy,lifecycleandstoreimport no transport and no vendor SDK (pinned by a test). Twilio and Deepgram sit behind aPhoneProviderseam.
Try it (2 minutes, no credentials)
Requirements: Python 3.12+ and uv (the bootstrap script installs uv if it is missing, and cloudflared through Homebrew if Homebrew is present).
git clone https://github.com/Caezarr/Bond-OpenAI.git && cd Bond-OpenAI
./scripts/bootstrap.shWithout provider keys, the bootstrap ends with a diagnostic, not an error you need to fix:
"mcp": "ready",
"missing": [ "DEEPGRAM_API_KEY", "TWILIO_ACCOUNT_SID", ... ]
No demo relay profile is published. An operator must configure demo/profile.json or local provider variables.Now drive the MCP by hand in mock mode (a deterministic fake carrier, no network). The session classifies a task, asks for a preview, confirms it, then tries a number that is not on the allowlist:
cat > /tmp/bond-session.jsonl <<'EOF'
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bond.classify_task","arguments":{"task_text":"Call +15555550100 and reserve a table for two at 8pm"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"bond.create_phone_task","arguments":{"idempotency_key":"demo-1","task_input":{"task_id":"demo-1","caller_identity":"Assistant for Alex","destination_phone":"+15555550100","call_goal":"Reserve a table for two tonight at 8pm","consent_confirmed":true}}}}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"bond.create_phone_task","arguments":{"idempotency_key":"demo-1","task_input":{"task_id":"demo-1","caller_identity":"Assistant for Alex","destination_phone":"+15555550100","call_goal":"Reserve a table for two tonight at 8pm","consent_confirmed":true,"confirmed":true}}}}
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"bond.create_phone_task","arguments":{"idempotency_key":"demo-2","task_input":{"task_id":"demo-2","caller_identity":"x","destination_phone":"+15555550199","call_goal":"x","consent_confirmed":true,"confirmed":true}}}}
EOF
FREDO_TELEPHONY_PROVIDER=mock FREDO_ALLOWED_NUMBERS=+15555550100 FREDO_STATE_DIR="$(mktemp -d)" \
uv run bond-mcp serve < /tmp/bond-session.jsonlExpected structuredContent of the four responses (the process then keeps its carrier-callback server open; stop it with Ctrl-C):
{"classification": "phone_call"}
{"status": "needs_confirmation", "preview": {"destination_phone": "+15555550100", "caller_identity": "Assistant for Alex", "call_goal": "Reserve a table for two tonight at 8pm", "recorded": false, "max_duration_seconds": 180}}
{"task_id": "demo-1", "call_id": "<uuid>", "status": "dialing", "outcome": null, "summary": null, "recorded": false, "error": null, "replayed": false}
{"status": "error", "code": "destination_not_allowed", "message": "Destination is not pre-enrolled"}Run the offline test suite (fake carrier, no network):
uv run pytest # 90 passedReal calls
A real PSTN call needs a Twilio account with a verified caller number (TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE_NUMBER), a Deepgram key (DEEPGRAM_API_KEY), an exact allowlist of consenting numbers (FREDO_ALLOWED_NUMBERS), an endpoint secret (FREDO_ENDPOINT_SECRET) and a public HTTPS callback URL for Twilio (FREDO_PUBLIC_URL). See docs/ENV.md and docs/TELEPHONY.md. uv run bond-mcp doctor lists what is still missing.
Alternatively, an operator can host the demo relay, which holds the provider keys; clients then only need the relay URL and a scoped token in demo/profile.json. No public relay is configured in this repository today.
To connect an agent, print its MCP entry with uv run bond-mcp install --client codex|bond|generic --print (docs/MCP.md).
How it works
Tool | What it does |
|
|
| Preview without |
| Structured result: status, outcome, summary. |
| Hangs up an active call. |
server.py is a thin JSON-RPC adapter; policy.py validates and classifies; lifecycle.py (PhoneTaskService) runs preview, dial, status and cancel; store.py holds idempotency keys and the single-active-call guard in SQLite. fredo/ is the carrier runtime: Twilio REST calls, a signed status callback and media WebSocket, and a bridge to one Deepgram Voice Agent session that discloses it is a synthetic voice, does not record, and hangs up on silence. Terminal states are never overwritten. Input and result shapes are in schemas/.
docs/ARCHITECTURE.md is a five-minute read: components, the call state machine, trust boundaries, and where each safety invariant is enforced.
Proof in the repo
90 offline tests (
tests/), no network. Each safety invariant in docs/ARCHITECTURE.md maps to the code that enforces it and is pinned by a test: consent, allowlist, preview-before-dial, idempotency and replay, no blind redial, one active call, 180 s cap, verified caller ID, no recording, signed callbacks, no secrets in results.Static checks:
ruff(lint and format),mypy.CI (
.github/workflows/ci.yml) runs lint, format, mypy, pytest anduv buildon every push and pull request.Design decision record: docs/decisions/0001-verified-caller-identity.md.
Limits and status
One call at a time, 180 seconds maximum. This is a guarded action, not a dialer, and does not do unattended bulk calling.
Speech recognition, dialogue and synthesis are hosted by Deepgram; PSTN goes through Twilio. Nothing runs inference locally, and there is no recording or voice cloning.
Status is eventually consistent between callbacks and polling; the first terminal value wins.
The SQLite store is local to one machine; the demo relay keeps its own store.
Version 0.1.0. Provider versions and alternatives: docs/PROVIDER-MATRIX.md.
Development
uv sync --frozen --extra dev
uv run ruff check src tests && uv run ruff format --check src tests
uv run mypy
uv run pytest # offline: fake carrier, no network
uv buildHelp and how to report issues safely: SUPPORT.md, SECURITY.md. Contributions: CONTRIBUTING.md.
License
Apache License 2.0. Third-party notices: THIRD_PARTY_NOTICES.md.
Available Tools
4 toolsbond.cancel_phone_taskC
Cancel an active phone task.
Inputs: call_id (required).
bond.classify_taskC
Classify whether a task needs a phone call.
Inputs: task_text (required), context.
bond.create_phone_taskC
Validate, preview and create one consented phone task.
Inputs: task_input (required), idempotency_key (required).
bond.get_phone_task_statusC
Get a structured phone task result.
Inputs: call_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: classifying, creating, checking status, and canceling phone tasks. There is no functional overlap, and descriptions clearly differentiate them.
Three tools follow 'bond.<verb>_phone_task' pattern, but 'bond.classify_task' drops 'phone', causing a minor inconsistency. However, all use snake_case and the bond prefix.
Four tools is well-scoped for a phone task workflow—neither too few nor too many. Each tool serves a necessary step in the lifecycle.
Covers the primary lifecycle (classify, create, get status, cancel). Missing an update operation, but the domain likely doesn't require it; the set is complete for basic management.
Maintenance
Related MCP Connectors
Lets Claude, Cursor or any MCP client build voice agents and place real phone calls.
Give any AI agent a phone: make and answer calls, get through phone menus, and send texts.
Give AI agents real phone numbers, messages, and voice calls via MCP.
Phone, SMS and email for AI agents. One remote MCP endpoint, OAuth login, zero install.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to initiate and control outbound telephone calls and answer inbound calls through Telnyx and LiveKit, with realtime voice conversations powered by Gemini Live or OpenAI Realtime.MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLM agents to initiate real-time outbound WebRTC/SIP calls, execute operational actions mid-call, escalate to human operators, and access live call telemetry through MCP, with zero data-at-rest and TTL-bounded memory.MIT

call4meofficial
AlicenseNot gradedqualityBmaintenanceYour AI agent phones businesses for you: books, reschedules, cancels, asks, and waits on hold.18MIT- AlicenseNot gradedqualityCmaintenanceEnables AI agents to place phone calls and send SMS via Twilio with plan-then-confirm safety, dry-run mode, number allowlists, calling-hour guards, and an audit log.2MIT