Assign number connection
Attach a connection (the handler that answers calls) to a number — i.e. configure the line.
ActionTry it
Integrate Saperly MCP
with your AI CRM
Manage Saperly phone numbers, connections, calls, SMS and usage through its official MCP server using your scoped workspace API key.
Explore Triggers and Actions
Create connection
Create a connection. hosted = an in-network AI assistant; manual = your own brain via BYO-LLM.
ActionTry it
Delete connection
Delete a connection.
ActionTry it
Get call
Fetch one call record by its Saperly id.
ActionTry it
Get connection
Fetch one connection by its Saperly id.
ActionTry it
Get number
Fetch one phone number by its Saperly id.
ActionTry it
Get usage
Summarize calls, messages, and the current balance for this workspace.
ActionTry it
List calls
List the calls in this workspace.
ActionTry it
List connections
List the connections (call/message handlers) configured in this workspace.
ActionTry it
List custom voices
List 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.
ActionTry it
List messages
List SMS messages in this workspace, optionally filtered to one number.
ActionTry it
List numbers
List the active phone numbers (lines) provisioned in this workspace.
ActionTry it
List voices
List stock voices and ready private voices. Pass an id as voiceId to create_connection or update_connection. Upload recordings in the dashboard or POST /custom-voices (multipart); private voices are hosted-only.
ActionTry it
Place call
Dial an outbound call from one of your numbers. The connection answers it.
ActionTry it
Provision number
Order 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).
ActionTry it
Release number
Release a phone number and stop billing it.
ActionTry it
Search available numbers
Search available inventory for numbers available to provision, priced for this workspace.
ActionTry it
Send sms
Send an SMS from one of your numbers.
ActionTry it
Set caller id name
Set (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.
ActionTry it
Set sms sender
Set (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.
ActionTry it
Speak into call
Speak 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.
ActionTry it
Sync connection
Reconcile a connection — create/update its assistant and mint its manual-mode secret.
ActionTry it
Transfer call
Blind-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.
ActionTry it
Update connection
Update 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.
ActionTry it
How the Saperly MCP integration works
The Saperly MCP integration connects your Dench AI CRM directly to Saperly MCP, so agents can read and act on your Saperly MCP data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
24 actions are available for agents to invoke on your behalf. Every call runs through Saperly MCP's own authorization, scoped to the account you connect.
Set up Saperly MCP in Dench
- 1
Sign in to your Dench workspace and open Integrations.
- 2
Find Saperly MCP and click Connect — you'll authorize access through Saperly MCP's own sign-in flow. No API keys or code required.
- 3
Ask an agent to use Saperly MCP in chat, or call it from an automation.
- 4
Manage or disconnect the connection any time from workspace settings.
Frequently asked questions
How does the Saperly MCP integration work with Dench?
The Dench Saperly MCP integration connects your AI CRM to Saperly MCP, so AI agents can work with your Saperly MCP data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
What actions can AI agents perform with Saperly MCP via Dench?
The Saperly MCP integration currently exposes 24 actions, including Assign number connection, Create connection, Delete connection, Get call, Get connection, and Get number. Agents invoke them on your behalf from chat or from automations.
Do I need to write code to connect Saperly MCP to Dench?
No. You connect Saperly MCP from your Dench workspace using Saperly MCP's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Is the Saperly MCP integration secure?
Connections are authorized through Saperly MCP's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Saperly MCP connection from your workspace settings at any time.