Telep IO · CallSend

API & MCP documentation

Agent-drafted phone calls with a human-approved verbatim script.

Demo gateway: calls are drafts only — nothing is placed. Planned trust model: the agent drafts a verbatim TTS script; a human reviews the exact script and pays $0.99 before any call is placed. Provider: Twilio (number provisioning in progress; API not wired).

Connecting

MCP endpoint
https://api.muse.telep.io/mcp/call-send — streamable HTTP, JSON-RPC 2.0. Methods: initialize, tools/list, tools/call.
REST base
https://api.muse.telep.io/v1/call-send
OpenAPI
https://api.muse.telep.io/v1/call-send/openapi.json — exact request/response shapes for every REST route.
Auth
Authorization: Bearer <api-key> on every call. Calls are scoped to the key.

MCP tools

check_credentials

Validate the Twilio account SID and auth token. Does not place a call. Demo mode skips Twilio.

Takes no parameters.

create_call

Create a CallSend draft call that plays a verbatim, human-reviewed TTS script ($0.99 per call, up to ~5 minutes). Returns a review URL. Does not place anything — the human must review the script, destination number, and price and pay. V1 is a read-aloud script, not an autonomous conversation. Gateway fulfillment is currently stubbed.

ParameterTypeRequiredDescription
tostringyesDestination phone number, E.164 (starts with +)
scriptstringyesVerbatim script to be read aloud; reviewed by a human before anything is placed
voicestringnoTTS voice (default alloy)
recordbooleannoRecord the call (default false)

get_call

Get a CallSend call you created on this API key (status: draft, paid, queued, completed, failed).

ParameterTypeRequiredDescription
idstringyes—

list_calls

List CallSend calls created with this API key.

Takes no parameters.

Example: list tools over MCP

curl -X POST https://api.muse.telep.io/mcp/call-send   -H "Authorization: Bearer $TELEP_API_KEY"   -H "Content-Type: application/json"   -H "Accept: application/json, text/event-stream"   -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}'

REST example

Create via POST https://api.muse.telep.io/v1/call-send/calls:

curl -X POST https://api.muse.telep.io/v1/call-send/calls   -H "Authorization: Bearer $TELEP_API_KEY"   -H "Content-Type: application/json"   -d '{"to":"+15555550100","script":"example"}'

Every REST route is described exactly in the OpenAPI document.

Demo status

Demo gateway: calls are drafts only — nothing is placed. Planned trust model: the agent drafts a verbatim TTS script; a human reviews the exact script and pays $0.99 before any call is placed. Provider: Twilio (number provisioning in progress; API not wired).

Pricing: $0.99 per call (planned). Nothing is billed while the gateway is a stub.

Related