PlaceCall

PlaceCall

PlaceCall 可让你的 Agent 致电美国商家，处理预订、收集信息并获取报价。你会收到处理结果和通话记录。前 250 通电话免费。由前 Google Maps 和 Search 开发者打造。

curl -s -X POST https://api.voygr.tech/calls \
  -H "X-API-Key: $PLACECALL_API_KEY" -H "Content-Type: application/json" \
  -H "X-Client-Surface: gh-repo" \
  -H "X-Client-Agent: ${CLAUDECODE:+claude-code}${CURSOR_AGENT:+cursor}${CODEX_SANDBOX:+codex}${GEMINI_CLI:+gemini-cli}" \
  -d '{"target_phone":"+1XXXXXXXXXX","brief":"Call this restaurant and ask what time the kitchen closes tonight.","language":"en"}'

如上所示，原始 API 通过 X-API-Key 标头接收你的密钥。前往 https://api.voygr.tech/checkout 获取密钥；密钥会通过电子邮件发送给你。下面的插件和 MCP 连接器则会通过浏览器让你登录。如果你的 Agent 没有浏览器，可以通过电子邮件验证码注册：请参阅 通过电子邮件验证码注册。

PlaceCall 的功能

向 PlaceCall 提供一个美国电话号码（或电话号码列表），以及用通俗英语描述的任务，例如 咨询、询价或预订。它会拨打电话、操作 IVR 和等待接通，并与商家交谈。

没有电话号码？也可以描述地点，例如“芝加哥一家浪漫的餐厅，周六晚上 8 点”。PlaceCall 会查找候选地点，说明选择它们的原因，并为你撰写通话概要。

在 brief 中写明完整任务：要询问的内容、通话对象、姓名、日期、人数、回拨号码、你希望达到的结果，以及如何结束通话。机器人只会读取 brief。如果还需要更多信息，它会在通话过程中询问你。

支持的任务

• 预订、取消或改期餐桌和预约
• 核实信息、跟进订单、查询库存、获取报价
• 同时联系多家商家
• 在你没有电话号码时，推荐最佳场所、服务或供应商
• 汇报通话情况，并在需要时于通话过程中提出问题

你会收到什么

每通电话都会返回 17 种已验证结果之一，以及完整的通话记录和录音。失败的通话会附带失败原因，例如通话中断、线路忙、进入语音信箱或拨错号码。

安装

Claude Code、Codex 和 Cursor 插件包含技能和 PlaceCall MCP 服务（https://api.voygr.tech/mcp）。你只需通过浏览器登录一次。首次登录会创建一个含免费额度的 PlaceCall 账户，因此无需复制密钥。claude.ai 和 ChatGPT 连接器的工作方式相同。仅使用技能的方式（复制技能、Codex 技能安装程序、OpenClaw）则会改用密钥调用 API；请参阅获取密钥。Gemini CLI 扩展也包含 MCP 服务，但会将你的密钥发送到服务端，且不支持通过浏览器登录。

登录后即可查找地点、拨打电话和跟进通话。少数 API 选项仍需在所有使用方式中提供密钥：关闭录音或更改开场提示、取消通话，以及列出你的通话。

Claude Code（推荐）

此插件会通过本仓库自动更新。只需运行两条命令即可安装；无需使用 Shell 或 git：

/plugin marketplace add voygr-tech/placecall
/plugin install placecall@placecall

Claude Code 会询问安装位置。选择用户范围（“为你安装”），除非你想将其限制在某个仓库中。然后运行 /mcp， 选择 placecall 服务并登录。该技能可通过 /placecall:placecall 调用；每当你要求 Claude 打电话时，它也会自动使用该技能。

如果你在 6.1.0 之前安装了插件，请运行 /plugin marketplace update placecall 并重启 Claude Code。如果你已经导出了密钥，则无需登录：该技能会在每次通话中继续使用你的密钥、现有账户和额度。如果没有密钥，请使用 /mcp 登录。

Claude Code（不使用插件）

git clone https://github.com/voygr-tech/placecall && cd placecall
./install.sh     # copies skills/placecall/SKILL.md -> ~/.claude/skills/placecall/

install.sh 只会将 skills/placecall/SKILL.md 复制到你的技能目录（不联网，也没有其他副作用），因此你也可以手动复制该文件。然后启动新的 Claude Code 会话，因为技能会在启动时加载。复制的文件不会自动更新。如果你想在我们发布新技能和修复后及时获取更新，请使用上面的插件。

Cowork

使用 Claude 连接器。按照下方 claude.ai 聊天中的说明添加一次，它就会出现在 Claude 聊天、Cowork 和 Claude Desktop 中。无需密钥，也无需终端。

该插件也可以安装到 Cowork 中（Customize > Plugins > Add marketplace，粘贴 voygr-tech/placecall，然后点击 Install）。它会添加有关撰写简报和跟进通话的技能指南，并连接到同一个 PlaceCall 服务。二选一安装，不要同时安装：如果两者都安装，Agent 会看到两个提供相同工具的 PlaceCall 服务。

需要仅 API 提供的选项（关闭录音、自定义开场通知、取消通话）？请安装插件而非连接器，并为该技能提供密钥。将密钥和沙盒允许列表都放入 ~/.claude/settings.json。Cowork 没有终端，因此 获取密钥中的 export 无处可运行，而 Bash 沙盒会阻止我们调用 API，除非你允许：

{
  "env": { "PLACECALL_API_KEY": "<your key>" },
  "sandbox": { "network": { "allowedDomains": ["api.voygr.tech"] } }
}

之后重启 Cowork。

• env 会将密钥放在重启后仍可保留的位置。在 shell 中设置密钥不会传递到桌面应用，因为桌面应用无法访问该 shell。
• allowedDomains 会预先允许访问 api.voygr.tech。Claude Code 不会预先允许任何域名，因此如果没有此设置，你在首次通话时会看到权限提示。如果你的组织设置了 strictAllowlist 或 allowManagedDomainsOnly，通话会被阻止，且不会出现提示。有人称之为“深层管理员设置”。

密钥会以明文形式保存在该文件中，信任级别与 获取密钥中的 600 环境文件相同。 如果希望文件权限一致，请运行 chmod 600 ~/.claude/settings.json。

claude.ai 聊天

所有套餐均可通过自定义连接器登录使用。

个人套餐：Settings > Connectors > Add custom connector。 Team/Enterprise：由所有者在 Organization settings > Connectors 下添加一次，然后每位成员使用自己的 PlaceCall 账户登录。

1. 将名称设为 PlaceCall，URL 设为 https://api.voygr.tech/mcp。保留 Claude 检测到的登录设置。
2. 点击 Add，然后使用 Google 或电子邮件登录。首次登录时，你需要接受服务条款和隐私政策，系统会为你创建一个附带免费额度的 PlaceCall 账户。
3. 允许访问。PlaceCall 会出现在聊天的工具菜单中，你可以用它查找值得致电的地点、拨打电话（它总会先确认），以及获取结果。

想要整个工作区共用一个 API 密钥？添加连接器时选择 No sign-in，并添加携带密钥的 x-api-key 请求头。之后所有通话都会计入该密钥。

ChatGPT

在网页版 ChatGPT 中将 PlaceCall 添加为自定义应用。自定义应用取决于你的 ChatGPT 套餐。

1. 打开 Plugins，然后依次点击 + > Create plugin > Create MCP App。
2. 将名称设为 PlaceCall，服务器 URL 设为 https://api.voygr.tech/mcp，身份验证选择 OAuth。保留 ChatGPT 检测到的 OAuth 设置，接受自定义应用提示，然后点击 Create。
3. 使用 Google 或电子邮件登录。首次登录时，你需要接受服务条款和隐私政策，系统会为你创建一个附带免费额度的 PlaceCall 账户。
4. 在聊天中，从工具菜单选择 PlaceCall。

任意 MCP 客户端（Cursor、Windsurf、MCP Inspector 等）

将客户端指向 https://api.voygr.tech/mcp（流式 HTTP 传输）。它已列入官方 MCP Registry，名称为 io.github.voygr-tech/placecall。如果客户端支持 OAuth，请使用 OAuth 登录；否则，请在每个请求中通过以下任一请求头发送密钥：

X-API-Key: <your key>

或使用 Authorization: Bearer <your key>。

Claude Code 使用自己的 MCP 配置（不会读取 claude.ai 连接器），因此请用一条命令在其中添加：

claude mcp add --transport http --scope user placecall https://api.voygr.tech/mcp

然后在 Claude Code 中运行 /mcp，选择 placecall 并登录。若要改用密钥，请添加 --header "X-API-Key: <your key>"。--scope user 会使其在每个项目中都可用。本页顶部的插件仍是 Claude Code 更全面的方案，因为它除了四个工具外，还包含完整技能。

Codex

与 Claude Code 使用相同的插件。在 Shell 中运行以下命令：

codex plugin marketplace add voygr-tech/placecall
codex plugin add placecall@placecall
codex mcp login placecall

最后一条命令会打开浏览器登录页面。如果你的 Codex 没有 plugin 命令，请更新 Codex，或使用下方的技能安装程序。

若只想安装技能并使用密钥，请在 Codex 内输入以下内容，而不是在 Shell 中输入。 $skill-installer 是 Codex 自带的系统技能，因此无需预先进行任何 设置：

$skill-installer install the skill at https://github.com/voygr-tech/placecall/tree/main/skills/placecall and name it placecall

它是一个技能，而不是命令，因此需要使用普通英语描述需求。它会替你运行安装 程序，并告知技能的安装位置。无需重启：技能会在下一轮对话中生效，并响应 $placecall。

如果 Codex 无法理解上述描述，请在常规 Shell 中自行运行安装程序脚本：

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --url https://github.com/voygr-tech/placecall/tree/main/skills/placecall \
  --name placecall

安装程序不会覆盖已有文件，因此如果你已在 ~/.codex/skills 中安装了 placecall（或较早版本的 callwright）技能，请先将其删除，否则安装 会中止。不要在 Codex 上运行 install.sh；该脚本用于 Claude Code。

2026 年 10 月，技能文件夹从 skills/call 移到了 skills/placecall， 因此仍包含 .../tree/main/skills/call 的安装命令已无法找到它。你已经安装的 副本仍可正常使用，并且仍会响应 $placecall。若要获取更新版本，请删除旧副本， 然后从上方的 skills/placecall URL 重新安装。

对于不支持 $skill-installer 的旧版 Codex，或者想在任何 Codex 上使用替代方案时， 请将此仓库的 AGENTS.md 粘贴到项目的 AGENTS.md 中。

Hermes Agent

只需一条命令，它会提示你输入密钥，而不是要求在命令行中提供，因此密钥不会留在 Shell 历史记录中：

hermes mcp add placecall --url https://api.voygr.tech/mcp/ --auth header

请保留 URL 末尾的斜杠。对“此服务是否需要身份验证？”回答 Y，在密码输入提示处粘贴密钥， 然后对启用全部四个工具回答 Y。Hermes 会将密钥存储在 ~/.hermes/.env 中（变量名为 MCP_PLACECALL_API_KEY），并且只在 config.yaml 中写入 ${...} 引用，因此密钥值不会出现在配置文件中。运行 hermes mcp test placecall 进行验证，然后启动新会话，因为工具会在会话开始时加载。

不要在 Hermes 上使用技能安装方式。Hermes 自带的扫描器会拒绝 hermes skills install placecall：根据该扫描器的设计，任何会通过 curl 向非本地环回主机发送 API 密钥的技能都会被判定为严重问题，而我们的技能每次调用时 都会这样做。MCP 不使用 Shell，也不会在请求中携带环境变量，因此不受此规则限制。

Gemini CLI

此仓库也提供 Gemini CLI 扩展：包括技能和 PlaceCall MCP 服务。在 Shell 中安装：

gemini extensions install https://github.com/voygr-tech/placecall

安装时会要求输入 PlaceCall API 密钥，并将其保存在系统密钥链中 （之后可通过 gemini extensions config placecall 更改）。Gemini 只会将 该密钥传递给 MCP 服务。技能中的 curl 命令会在 Shell 中运行，并从中读取 PLACECALL_API_KEY，因此也请导出该变量（参见获取密钥）。 如果已导出密钥但未将其存储，MCP 服务也会从环境变量中获取密钥。

Cursor

此仓库也提供 Cursor 插件（.cursor-plugin/plugin.json）：包括技能和 PlaceCall MCP 服务 https://api.voygr.tech/mcp，它通过 OAuth 为你登录，因此插件不需要 持有密钥。要在 Cursor Marketplace 上架前加载该插件，请将其克隆到 Cursor 的本地插件文件夹， 然后运行 Developer: Reload Window：

git clone https://github.com/voygr-tech/placecall ~/.cursor/plugins/local/placecall

技能中的 curl 命令会从 Cursor Agent 运行时所处的环境中读取 PLACECALL_API_KEY。若要向 MCP 服务提供密钥而不是登录，请参阅任何 MCP 客户端。

任意 Agent / 普通 shell

无需安装任何内容：API 使用纯 HTTP。 skills/placecall/SKILL.md 是完整参考资料，能够使用 shell 工具的模型可以直接根据它拨打电话。

你这边没有 shell？拥有自己的计算机的助手（例如 Meta Muse） 可以直接从此仓库集成：将仓库 URL 粘贴到聊天中，并让它使用 PlaceCall 拨打电话。如果它提供安全的凭据存储功能来保存 API key，请使用该功能，切勿将 key 粘贴到聊天中。

已知可通过这种方式使用的有：Meta Muse、OpenClaw（DeepSeek 后端）。Hermes 需要使用上面的 MCP 路由，而不是 skill。如果你是构建此集成的 Agent，请在每个请求中发送 X-Client-Surface: <your-platform>，这样我们就能了解哪些平台需要优化。

Apify Store（无需代码，适合整份列表）

你有的是商家列表，而不是 Agent？Apify Store 上的 PlaceCall 会致电列表中的每家商户，询问你设置的问题，并为每通电话返回一行结果。无需 PlaceCall key：由 Apify 运行并向你收费。

1. 打开 Actor 并点击 Try for free（需要 Apify 账户）。
2. 添加列表：上传 CSV、链接 Google Sheet、粘贴行，或使用其他 Actor 的数据集，例如 Google Maps 结果。
3. 输入问题，勾选 Check my list, don't call，然后点击 Start。你可以免费查看每家商户会被询问的具体内容。
4. 接受 PlaceCall 条款，取消勾选后重新开始。

每通接通并进行真实对话的电话收费 $0.10；未接电话、语音信箱 和占线均免费。每个 Apify 账户的前 10 通电话免费，之后需要付费 Apify 套餐。连接到 Apify MCP 服务 的 Agent 也可以查找并运行它。

获取 key（自助服务）并进行设置

通过插件或连接器登录了？只有在需要使用 MCP 工具不提供的选项时才需要 key：关闭录音或更改开场提示、取消通话，以及列出通话记录。仅使用 skill 的方式和原始 API 则始终需要 key 才能拨打电话。你无需联系任何人。如果没有浏览器，你的 Agent 可以通过电子邮件验证码注册。 否则：

1. 打开 https://api.voygr.tech/checkout?src=gh-repo 并点击 "Get free API key" （姓名 + 电子邮件）。
2. key 将通过电子邮件发送。新 key 包含的内容和当前额度价格会显示在结账页面上。
3. 丢失了 key？https://api.voygr.tech/recover 会通过电子邮件向你发送新的 key。
4. 需要更多额度？在同一个 https://api.voygr.tech/checkout?src=gh-repo 页面充值（由 Stripe 托管的付款）。

然后在 shell 中设置 key：

仅为当前会话设置：

export PLACECALL_API_KEY="<your key>"

保存一次（不回显到屏幕，权限为 600），并在每个会话中加载：

mkdir -p ~/.codex
read -rsp "PLACECALL_API_KEY: " KEY; echo
printf 'export PLACECALL_API_KEY=%q\n' "$KEY" > ~/.codex/placecall.env
chmod 600 ~/.codex/placecall.env
unset KEY
# then, in any new shell where you want to place calls:
source ~/.codex/placecall.env

完全没有 shell？桌面应用无法访问你的 shell 环境，因此以上两种方法都无法让它获取 key。请将 key 放在 ~/.claude/settings.json 的 env 区块中，这样重启后仍会保留。请参阅 Cowork 部分，其中还介绍了你在此处需要设置的沙盒域名允许列表。

检查 key（此操作会显示你的额度，不会显示 key）：

curl -s -H "X-API-Key: $PLACECALL_API_KEY" https://api.voygr.tech/users/me

切勿提交 ~/.codex/placecall.env，也不要将 key 粘贴到聊天中。请将其保存在环境变量或上述权限为 600 的文件中。

通过邮箱验证码注册

使用 PlaceCall MCP 工具的 Agent 会先使用这些工具，并通过浏览器登录。 只有当 Agent 没有可用于登录的浏览器，或用户需要只能通过密钥使用的功能（例如列出或取消通话，或关闭录音）时，才通过邮箱验证码注册。

1. 向用户询问姓名和邮箱。
2. 发送注册请求：

   curl -s -X POST https://api.voygr.tech/signup -H "Content-Type: application/json" \
     -d '{"name":"<name>","email":"<email>","delivery":"code","src":"gh-repo"}'
   

   回复中包含 verification_id，且对于所有地址，格式都相同。如果没有该字段，说明注册尚未开始（例如，一次性邮箱地址会触发 DISPOSABLE_EMAIL_DOMAIN，或触发 SIGNUP_IP_RATE_LIMITED）：告知用户回复中的内容。如果姓名中有引号或非 ASCII 字母，请将 JSON 写入文件，并使用 --data-binary @payload.json。
3. 请用户提供邮件 "Your Voygr sign-up code" 中的 6 位验证码。验证码有效期为 10 分钟。由用户自行决定是否提供这个属于他们自己的注册验证码。它不是商家可能在通话中要求提供的“一次性验证码”。绝不要转告商家。如果用户没有收到邮件，请让他们检查垃圾邮件文件夹。一个地址在 24 小时内最多可获取 3 个验证码。
4. 使用验证码换取密钥，并保存密钥，不要打印出来：

   ( umask 077; dest=~/.codex/placecall.env; tmp=
     if ! { mkdir -p ~/.codex && [ ! -d "$dest" ] && tmp=$(mktemp "$dest.XXXXXX") && chmod 600 "$tmp"; }; then
       [ -n "$tmp" ] && rm -f "$tmp"; echo "SAVE_UNAVAILABLE: cannot write $dest; the code was not used"; exit 1
     fi
     resp=$(curl -s -X POST https://api.voygr.tech/signup/verify \
       -H "Content-Type: application/json" -d '{"verification_id":"<id>","code":"<code>"}')
     key=$(printf '%s' "$resp" | sed -nE 's/.*"api_key"[[:space:]]*:[[:space:]]*"([^"]*)".*/\1/p')
     if [ -z "$key" ]; then st=hidden
     elif printf 'export PLACECALL_API_KEY=%s\n' "$key" > "$tmp" && mv "$tmp" "$dest"; then st=saved
     else st=hidden; echo "SAVE_FAILED: the key was issued but could not be saved"; fi
     rm -f "$tmp"
     printf '%s\n' "$resp" | sed -E "s/\"api_key\"[[:space:]]*:[[:space:]]*\"[^\"]*\"/\"api_key\":\"($st)\"/" )
   

5. 如果输出显示 "api_key":"(saved)"，请告知用户密钥已保存到 ~/.codex/placecall.env，并且输入验证码即表示接受 API 条款（https://voygr.tech/terms-api）。如果回复中有 "replaced_previous_key":true，请告知用户旧密钥已失效。

如果步骤 4 返回错误，请读取其中的 error_code：

• CODE_INCORRECT：请用户重新核对验证码。attempts_remaining 会说明还剩多少次尝试机会。
• CODE_INVALID_OR_EXPIRED：从步骤 2 重新开始。
• SIGNUP_CAPPED、SIGNUP_VERIFY_UNAVAILABLE 或 account_status_unavailable：等待一分钟，然后使用同一验证码重试步骤 4。
• KEY_EXPIRED 或 ACCOUNT_WITHOUT_PLACECALL：告知用户，并让他们联系 [email protected]。
• ROTATION_FAILED 或其他错误：告知用户回复中的内容。

如果步骤 4 改为打印 SAVE_ 行，则密钥尚未保存：

• SAVE_UNAVAILABLE：验证码尚未使用。修复文件夹或磁盘问题，然后使用同一验证码重试步骤 4。
• SAVE_FAILED：密钥已发放，但无法保存。告知用户；如果回复中有 "replaced_previous_key":true，还要说明旧密钥已失效。修复问题后，从步骤 2 重新开始。新验证码会替换丢失的密钥。

在 2026 年 8 月之前安装了这个项目？

本项目在 2026-08 之前名为 Callwright，仓库地址为 voygr-tech/callwright-skill。

• 现有配置会继续正常工作。install.sh 会复制技能，而不是创建链接，因此旧副本会保留安装时的状态，重命名也不会导致它无法运行。但同一副本永远不会获取新技能或修复，这正是需要迁移的原因。
• 迁移时，请先删除旧副本。它仍然是可用的电话技能，如果保留，Agent 就会有两个此类技能，路由也会变得模糊。现在 install.sh 会在检测到旧副本时发出警告。

  rm -rf ~/.claude/skills/callwright ~/.claude/skills/callwright-skill
  

  然后安装上方的插件，并使用新名称重新导出密钥： PLACECALL_API_KEY。密钥本身不变，只是变量改了名称，因此无需重新发放密钥。

如果你之前从其他人那里安装过电话通话技能（例如 ai-call-agent），也请将其移除或禁用，原因相同。

重要提示

• 呼叫成功获取内容（回答、拒绝或预订）时，费用为 10 个额度。每次呼叫运行期间会占用 30 个额度，结束时会释放未使用的部分。未获取任何内容的呼叫免费；被叫方接听后 30 秒内取消也免费；接听后 30 秒或更久才取消则会收费。地点建议使用同一额度余额：每次已应答的 POST /v1/places/suggest 消耗 5 个额度（运行期间占用 15 个额度）；未返回卡片或被拒绝时不收费。由于占用的额度高于实际费用，即使余额看起来足以支付费用，也可能返回 402（通过 GET /users/me 查询余额；费率和充值可自行管理，地址为 https://api.voygr.tech/checkout?src=gh-repo）。免费层级的额度共用：250 次免费呼叫相当于 2,500 个额度，地点建议也从这 2,500 个额度中扣除。
• 呼叫状态变为 completed 后，结果和转录文本可能还要片刻才会填充，因此请轮询 GET /calls/{id}，直到 outcome_type 不再为 null。此后的一两分钟内，检查呼叫录音仍可能为转录文本添加标记。transcript_status 显示 final 后，转录文本即为完整内容。
• 接受 13 种语言代码（en、es、fr、de、hi、ru、pt、ja、it、nl、sr、tr、pl），以及 auto（默认值：呼叫使用英语，期间不会切换语言；如需使用西班牙语呼叫，请发送 es）。en 最可靠；其他语言尽力支持。
• 只能呼叫你有权呼叫的号码；每次呼叫都会拨打真实电话。仅支持美国境内的目的地，但 IN、LA、MN、MT、NE 除外；默认情况下，每次呼叫开始时都会播放线路正在录音的通知（英语和西班牙语通知中还会提到 PlaceCall）。可选字段 disclosure 和 record_call 可修改或关闭这段开场通知；请参阅技能中的“开场通知”部分。

网络访问

此 skill 不包含任何可独立运行的内容。它提供的是 Agent 遵循的指令，可通过已连接插件的 PlaceCall MCP 工具执行，也可在自己的 shell 中使用 curl 执行。所有请求都通过 HTTPS 发送到唯一主机：api.voygr.tech。不会向其他任何地方发送数据。

• MCP 服务：Claude Code、Codex 和 Cursor 插件以及 Gemini CLI 扩展会注册 https://api.voygr.tech/mcp。suggest_places 会发送自然语言形式的请求和可选的位置；place_call 会发送要拨打的号码、简要说明和语言；get_call_result 会发送通话 ID；answer_question 会发送通话 ID、问题 ID 和你的回答。

• 通话：POST /calls 会发送要拨打的号码、简要说明和语言。GET /calls、GET /calls/{id}、GET /calls/{id}/events（通话期间轮询）、POST /calls/{id}/answer（回复通话 Agent 在通话过程中提出的问题）、POST /calls/{id}/cancel 和 GET /calls/{id}/recording 用于跟踪和读取通话。

• 查找可拨打的地点：POST /v1/places/suggest 会发送自然语言形式的请求，以及你提供的名称和回拨号码。

• 账户：GET /users/me、GET /v1/usage、GET /checkout/packs、GET /skills/{id}/manifest 和 PUT /users/me/limits。

• 通过电子邮件验证码注册：POST /signup 会发送你的姓名和电子邮件，POST /signup/verify 会发送电子邮件中的验证码。

在 MCP 服务上，Claude Code、Codex 和 Cursor 插件会通过 OAuth 为你登录，客户端发送的是由此获得的访问令牌，而不是密钥。Gemini CLI 扩展则会在 X-API-Key 标头中发送你的密钥。除了两次注册请求外，每个 curl 请求都会在 X-API-Key 标头中携带你的密钥；注册请求不发送密钥，而 POST /signup/verify 会返回密钥。无论哪种方式，PLACECALL_API_KEY 都只会发送到 api.voygr.tech。POST /calls 还会发送三个绝不会影响身份验证或计费的标头：Idempotency-Key，确保重试不会重复拨号；X-Client-Surface，标明这些指令来自哪个列表页面；以及 X-Client-Agent，标明拨打电话所用的工具（claude-code、cursor、codex 或 gemini-cli，根据 CLAUDECODE、CURSOR_AGENT、CODEX_SANDBOX 和 GEMINI_CLI 中设置的变量确定；只发送名称，绝不发送变量值）。

此 skill 唯一读取的本地文件是 ~/.codex/placecall.env，其中保存了你的密钥；仅当 PLACECALL_API_KEY 未设置时才会读取。通过电子邮件验证码注册也会写入该文件。install.sh 不会发起网络请求。本 README 中的结账、密钥恢复和文档链接都是供你打开的页面；此 skill 不会获取这些页面。

在我们的服务端，通话会拨打真实电话并录音。录音和转录内容会保留 90 天。安全报告请参阅：SECURITY.md。

完整参考文档：skills/placecall/SKILL.md（Claude Code） · AGENTS.md（Codex）。

在线 API 文档：https://api.voygr.tech/docs。使用你的 PlaceCall 密钥登录，即你设置为 PLACECALL_API_KEY 的同一个密钥。

如果 PlaceCall 对你有用，请为此仓库点个 star。这会给我们很大帮助。