- Category: communication
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 24
- Triggers: 0
- Slug:
SAPERLY_MCP - Version: 00000000_00
Tools
Assign number connection
Assign number connection
Create connection
Create connection
Slug:
SAPERLY_MCP_CREATE_CONNECTIONCreate a connection. hosted = an in-network AI assistant; manual = your own brain via BYO-LLM.Input Parameters
Hosted lines: the agent’s spoken language as a BCP-47 tag (e.g. “en”, “es”, “en-US”). Sets the in-network transcription hint (which language the caller speaks). Omit to let the carrier auto-detect.
The TCPA disclosure spoken as the line’s first, uninterruptible utterance when compliance is on.
Hosted lines: auto-reply to inbound SMS with the line’s own LLM (off by default). Manual lines forward inbound to their webhook brain regardless of this flag.
Optional client idempotency key — a retried tool call with the same key + arguments returns the original result instead of acting again (e.g. re-charging).
Office volume, 0.1–1.0 in steps of 0.1 (default 0.2). Supplying volume alone enables office ambience.
Manual mode: the webhook-brain URL Saperly POSTs each turn to (signed with the connection’s manualSecret) when no live agent socket is connected. The serverless brain endpoint (e.g. a Base44 backend function).
Delete connection
Delete connection
Get call
Get call
Get connection
Get connection
Get number
Get number
Get usage
Get usage
List calls
List calls
Slug:
SAPERLY_MCP_LIST_CALLSList the calls in this workspace.List connections
List connections
Slug:
SAPERLY_MCP_LIST_CONNECTIONSList the connections (call/message handlers) configured in this workspace.List custom voices
List custom voices
Slug:
SAPERLY_MCP_LIST_CUSTOM_VOICESList this workspace’s private voices and their processing status. Upload recordings through the dashboard or multipart POST /custom-voices. Only active voices can be selected.List messages
List messages
List numbers
List numbers
Slug:
SAPERLY_MCP_LIST_NUMBERSList the active phone numbers (lines) provisioned in this workspace.List voices
List voices
Place call
Place call
Provision number
Provision number
Slug:
SAPERLY_MCP_PROVISION_NUMBEROrder a new phone number and add it to this workspace. Charges the prepaid balance. The first number needs no card; provisioning a SECOND number requires a saved payment method on file (otherwise it fails with PaymentMethodRequired).Input Parameters
Optional client idempotency key — a retried tool call with the same key + arguments returns the original result instead of acting again (e.g. re-charging).
The monthly price (cents) you expect. If the live price is higher, the order is rejected with PriceChanged unless approveHigherPrice is set.
Release number
Release number
Search available numbers
Search available numbers
Set caller id name
Set caller id name
Slug:
SAPERLY_MCP_SET_CALLER_ID_NAMESet (or clear) a line’s outbound CALLER ID NAME — the 1–15 letter/number/space display name (CNAM) shown alongside the number on the called party’s phone. Unlike the SMS sender name this is NOT free per-call text: it’s a listing registered to the number, so display is best-effort (the recipient’s carrier decides via a CNAM dip; mainly US & Canada, and it takes time to propagate — many mobile carriers may not show it). Pass an empty string or null to clear it (show the bare number). A bad value returns InvalidCallerIdName. Line-reconfiguration, so a number-scoped key is bounded to its allow-list.Input Parameters
Caller ID name (1–15 letters/digits/spaces) registered as the line’s CNAM listing, or an empty string to clear it (show the bare number).
Set sms sender
Set sms sender
Slug:
SAPERLY_MCP_SET_SMS_SENDERSet (or clear) a line’s alphanumeric SMS sender name — the 1–11 letter/number label recipients see as the “from” on INTERNATIONAL SMS only. US & Canada carriers don’t allow alphanumeric senders, so US/Canada recipients always see the phone number. It is one-way (recipients can’t reply to a name). Pass an empty string or null to clear it (revert to sending from the phone number). A bad value returns InvalidSmsSenderId. Line-reconfiguration, so a number-scoped key is bounded to its allow-list.Input Parameters
Alphanumeric sender name (1–11 letters/digits) for international SMS, or an empty string to clear it (send from the phone number).
Speak into call
Speak into call
Slug:
SAPERLY_MCP_SPEAK_INTO_CALLSpeak a line into a live call. NOTE: out-of-band speech injection is not available — the carrier owns the in-network audio loop and only pulls the brain on a caller turn. In manual mode the agent speaks by REPLYING on its turn (the BYO-LLM / agent-as-channel path); Saperly never holds the media path.Input Parameters
Sync connection
Sync connection
Transfer call
Transfer call
Slug:
SAPERLY_MCP_TRANSFER_CALLBlind-transfer a live call to another destination — an E.164 phone number or a sip: URI. A Call Control action (signaling only): the carrier re-bridges the leg to the destination; Saperly never touches the audio (the no-media rule). Works across every backend — hosted, manual, and openai_realtime — because it acts on the call’s bound carrier leg. Returns CallStartFailed if the call has no live leg or the carrier transfer fails.Input Parameters
Update connection
Update connection
Slug:
SAPERLY_MCP_UPDATE_CONNECTIONUpdate a connection’s name, instructions, compliance/disclosure — or switch its mode between hosted (an in-network AI assistant) and manual (your own brain via BYO-LLM). A mode switch reconciles automatically.Input Parameters
Hosted lines: the agent’s spoken language as a BCP-47 tag (e.g. “en”, “es”, “en-US”) — the in-network transcription hint. Omit to leave it unchanged; pass an empty string ("") to RESET it to auto-detect.
Hosted lines: auto-reply to inbound SMS with the line’s own LLM (off by default). Manual lines forward inbound to their webhook brain regardless of this flag.
Optional client idempotency key — a retried tool call with the same key + arguments returns the original result instead of acting again (e.g. re-charging).
Office volume, 0.1–1.0 in steps of 0.1 (default 0.2). Supplying volume alone enables office ambience.
Manual mode: the webhook-brain URL Saperly POSTs each turn to (signed with the connection’s manualSecret) when no live agent socket is connected. The serverless brain endpoint (e.g. a Base44 backend function).