saperly

Name: saperly
Author: idanbier999

本地服务

github.com/idanbier999通信协作

代码仓库

关于 saperly

面向 AI Agent 的电话运营商：开通号码、拨打电话、发送短信，内置 TCPA 合规。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "idanbier999-saperly": {
      "command": "npx",
      "args": [
        "-y",
        "@saperly/mcp"
      ],
      "env": {
        "SAPERLY_API_KEY": "<SAPERLY_API_KEY>",
        "SAPERLY_BASE_URL": "<SAPERLY_BASE_URL>"
      }
    }
  }
}

启动命令npx -y @saperly/mcp

需要配置的环境变量

SAPERLY_API_KEY密钥Your Saperly API key (sk_live_... or sk_test_...). Get one at https://saperly.com/portal — 500 free credits on signup.

SAPERLY_BASE_URLOverride the Saperly API base URL. Optional — only set for local dev or staging environments.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@saperly/mcp0.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
mode	enum	否	text = 通过 webhook 进行 S2T+T2S，audio = 原始 WebSocket。默认为 text。text \| audio
name	string	是	线路的显示名称（例如 'support bot'）
voice	string	否	TTS 语音 ID。使用 saperly_list_voices 查看可选项。
webhookUrl	string	否	text 模式必填。你的服务器会在此处接收转录文本。
beginMessage	string	否	通话接通时 Agent 首先说的话。
contextLimit	number	否	对话记忆轮数（1-50）。默认值为 20。
systemPrompt	string	否	托管模式的系统提示词。用于指示 AI Agent 如何行动。
audioHandlerUrl	string	否	audio 模式必填。用于原始音频流传输的 WebSocket URL。
recordingEnabled	boolean	否	为此线路启用通话录音。
statusCallbackUrl	string	否	可选。接收通话生命周期事件。