Skip to content
Back to search

placecall

MarketplaceWorks with Claude CodeGitHub

VOYGR's marketplace for PlaceCall. Give your agent a phone.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/voygr-tech/placecall with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/voygr-tech/placecall'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/voygr-tech--placecall/badge.svg)](/listings/voygr-tech--placecall)

HTML

<a href="/listings/voygr-tech--placecall"><img src="/api/listings/voygr-tech--placecall/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The Claude Code, Codex and Cursor plugins carry the skill and the PlaceCall MCP server (`https://api.voygr.tech/mcp`). You sign in once in a browser; the first sign-in creates a PlaceCall account with free credits, so there is no key to copy. The claude.ai connector works the same way, and so does PlaceCall in the OpenAI plugin directory, which ChatGPT and Codex share. The directory listing carries the MCP server but not the skill. The skill-only routes (a copied skill, the Codex skill installer, OpenClaw) call the API with a key; see [Get a key](#get-a-key-self-serve-and-set-it). A few options need a key on every route: switching off recording, changing the opening notice, canceling a call, and listing your calls.

Claude Code (recommended)

Two commands install it, with no shell or git:

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

For the Anthropic plugin directory, submit the `claude-directory` folder. It connects to `https://api.voygr.tech/claude/mcp`, where every call is prepared first (`prepare_call`) and placed only with the plan the user approved (`place_call` with its `plan_id`), with the same browser sign-in and an MCP-only skill. The root marketplace retains the API-key instructions for clients that need API-only options.

Choose user scope ("Install for you") unless you want it confined to one repository. Then run `/mcp`, pick the `placecall` server and sign in. The skill answers to `/placecall:placecall`, and Claude uses it on its own when you ask to call someone.

Claude Code does not update a plugin from a third-party marketplace such as this one until you turn auto-update on for that marketplace. To update now, run this in your shell, then start a new Claude Code session:

claude plugin marketplace update placecall
claude plugin update placecall@placecall

Inside a session, `/plugin` > **Marketplaces** > `placecall` > **Update marketplace** does the same, and **Enable auto-update** on that screen keeps the plugin current from then on. Update any install older than 6.6.0 (2026-11-05): those copies wait for the `outcome_type` field, which the API stopped sending on 2026-11-12, so they never report a result. A key you already exported keeps working with its account and credits; without one, sign in with `/mcp`.

Claude Code, without the plugin

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

`install.sh` only copies `skills/placecall/SKILL.md` into your skills dir (no network, no other side effects); copying by hand works too. Skills load at startup, so start a new Claude Code session. A copy never updates itself: to update it, run `install.sh` again from a fresh `git pull`.

Cowork

Use the Claude connector. Add it once as in [claude.ai chat](#claudeai-chat) below, and it is there in Claude chat, Cowork and Claude Desktop. No key, no terminal.

The plugin also installs in Cowork (**Customize** > **Plugins** > **Add marketplace**, paste `voygr-tech/placecall`, **Install**). It adds the skill and connects the same server. Install one or the other; with both, your agent sees two PlaceCall servers offering the same tools.

Need one of the key-only options? Install the plugin instead of the connector and give the skill a key. Cowork has no terminal for the `export` in [Get a key](#get-a-key-self-serve-and-set-it), and its Bash sandbox blocks our API until allowed, so put both in `~/.claude/settings.json` and restart Cowork:

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

`env` keeps the key across reboots; a desktop app never sees your shell. `allowedDomains` pre-allows `api.voygr.tech`; Claude Code pre-allows none, so without it the first call prompts for permission. If your organization sets

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 37 lines
  1. {
  2. "name": "placecall",
  3. "description": "VOYGR's marketplace for PlaceCall. Give your agent a phone.",
  4. "owner": {
  5. "name": "VOYGR",
  6. "url": "https://voygr.tech"
  7. },
  8. "plugins": [
  9. {
  10. "name": "placecall",
  11. "displayName": "PlaceCall",
  12. "source": "./",
  13. "description": "PlaceCall makes AI phone calls that book, confirm, and reach US businesses. It places a real outbound call and returns a structured outcome plus a full transcript. Sign in on first use, no API key needed.",
  14. "version": "6.6.3",
  15. "author": {
  16. "name": "VOYGR",
  17. "url": "https://voygr.tech"
  18. },
  19. "homepage": "https://github.com/voygr-tech/placecall",
  20. "repository": "https://github.com/voygr-tech/placecall",
  21. "license": "MIT",
  22. "keywords": [
  23. "phone",
  24. "calls",
  25. "voice",
  26. "telephony",
  27. "booking",
  28. "reservations",
  29. "appointments"
  30. ],
  31. "category": "productivity",
  32. "skills": [
  33. "./skills/placecall"
  34. ]
  35. }
  36. ]
  37. }
README.md · README · 497 lines
  1. # PlaceCall
  2. PlaceCall lets your agent call US businesses to handle reservations, gather
  3. information and get quotes. You get back the outcome and a transcript. First
  4. 250 calls free. Built by ex-Google Maps and Search developers.
  5. ```sh
  6. curl -s -X POST https://api.voygr.tech/calls \
  7. -H "X-API-Key: $PLACECALL_API_KEY" -H "Content-Type: application/json" \
  8. -H "X-Client-Surface: gh-repo" \
  9. -H "X-Client-Agent: ${CLAUDECODE:+claude-code}${CURSOR_AGENT:+cursor}${CODEX_SANDBOX:+codex}${GEMINI_CLI:+gemini-cli}" \
  10. -H "X-Client-Version: placecall-skill/6.6.3" \
  11. -d '{"target_phone":"+1XXXXXXXXXX","brief":"Call this restaurant and ask what time the kitchen closes tonight.","language":"en"}'
  12. ```
  13. The raw API takes your key in the `X-API-Key` header. Get one at
  14. <https://api.voygr.tech/checkout>; it arrives by email. The plugins and MCP
  15. connectors below sign you in through a browser instead. An agent with no
  16. browser can [sign you up by email code](#sign-up-by-email-code).
  17. ## What PlaceCall does
  18. Give PlaceCall a US number (or a list) and a task in plain English: an
  19. inquiry, a quote request or a booking. It dials, navigates IVRs and hold, and
  20. talks to the business.
  21. No number? Describe the place instead, for example "a romantic restaurant in
  22. Chicago, Saturday 8pm". PlaceCall finds candidates, explains its picks and
  23. writes the call brief.
  24. Apart from an optional list of `items`, the bot reads only the `brief`. Put
  25. the full job in it: what to ask, who it's
  26. for, names, dates, party size, callback number, the outcome you want and how
  27. to wrap up.
  28. ## What it handles
  29. - Book, cancel or reschedule tables and appointments
  30. - Verify info, follow up on orders, check stock, get quotes
  31. - Contact many businesses at once
  32. - Recommend the best venue, service or vendor when you don't have a number
  33. - Report what happened, and raise a question mid-call if needed
  34. ## What you get back
  35. Every call returns a labelled outcome, the full transcript and the recording.
  36. A failed call comes back with its reason: dropped, busy, voicemail or a wrong
  37. number.
  38. ## Install
  39. The Claude Code, Codex and Cursor plugins carry the skill and the PlaceCall
  40. MCP server (`https://api.voygr.tech/mcp`). You sign in once in a browser; the
  41. first sign-in creates a PlaceCall account with free credits, so there is no key
  42. to copy. The claude.ai connector works the same way, and so does PlaceCall in
  43. the OpenAI plugin directory, which ChatGPT and Codex share. The directory
  44. listing carries the MCP server but not the skill. The skill-only
  45. routes (a copied skill, the Codex skill installer, OpenClaw) call the API with a
  46. key; see [Get a key](#get-a-key-self-serve-and-set-it). A few options need a
  47. key on every route: switching off recording, changing the opening notice,
  48. canceling a call, and listing your calls.
  49. ### Claude Code (recommended)
  50. Two commands install it, with no shell or git:
  51. ```
  52. /plugin marketplace add voygr-tech/placecall
  53. /plugin install placecall@placecall
  54. ```
  55. For the Anthropic plugin directory, submit the `claude-directory` folder. It
  56. connects to `https://api.voygr.tech/claude/mcp`, where every call is prepared
  57. first (`prepare_call`) and placed only with the plan the user approved
  58. (`place_call` with its `plan_id`), with the same browser sign-in and an
  59. MCP-only skill. The root
  60. marketplace retains the API-key instructions for clients that need API-only
  61. options.
  62. Choose user scope ("Install for you") unless you want it confined to one
  63. repository. Then run `/mcp`, pick the `placecall` server and sign in. The
  64. skill answers to `/placecall:placecall`, and Claude uses it on its own when
  65. you ask to call someone.
  66. Claude Code does not update a plugin from a third-party marketplace such as
  67. this one until you turn auto-update on for that marketplace. To update now,
  68. run this in your shell, then start a new Claude Code session:
  69. ```sh
  70. claude plugin marketplace update placecall
  71. claude plugin update placecall@placecall
  72. ```
  73. Inside a session, `/plugin` > **Marketplaces** > `placecall` > **Update
  74. marketplace** does the same, and **Enable auto-update** on that screen keeps
  75. the plugin current from then on. Update any install older than 6.6.0
  76. (2026-11-05): those copies wait for the `outcome_type` field, which the API
  77. stopped sending on 2026-11-12, so they never report a result. A key you
  78. already exported keeps working with its account and credits; without one,
  79. sign in with `/mcp`.
  80. ### Claude Code, without the plugin
  81. ```sh
  82. git clone https://github.com/voygr-tech/placecall && cd placecall
  83. ./install.sh # copies skills/placecall/SKILL.md -> ~/.claude/skills/placecall/
  84. ```
  85. `install.sh` only copies `skills/placecall/SKILL.md` into your skills dir (no
  86. network, no other side effects); copying by hand works too. Skills load at
  87. startup, so start a new Claude Code session. A copy never updates itself: to
  88. update it, run `install.sh` again from a fresh `git pull`.
  89. ### Cowork
  90. Use the Claude connector. Add it once as in [claude.ai chat](#claudeai-chat)
  91. below, and it is there in Claude chat, Cowork and Claude Desktop. No key, no
  92. terminal.
  93. The plugin also installs in Cowork (**Customize** > **Plugins** > **Add
  94. marketplace**, paste `voygr-tech/placecall`, **Install**). It adds the skill
  95. and connects the same server. Install one or the other; with both, your agent
  96. sees two PlaceCall servers offering the same tools.
  97. Need one of the key-only options? Install the plugin instead of the connector
  98. and give the skill a key. Cowork has no terminal for the `export` in
  99. [Get a key](#get-a-key-self-serve-and-set-it), and its Bash sandbox blocks our
  100. API until allowed, so put both in `~/.claude/settings.json` and restart
  101. Cowork:
  102. ```json
  103. {
  104. "env": { "PLACECALL_API_KEY": "<your key>" },
  105. "sandbox": { "network": { "allowedDomains": ["api.voygr.tech"] } }
  106. }
  107. ```
  108. `env` keeps the key across reboots; a desktop app never sees your shell.
  109. `allowedDomains` pre-allows `api.voygr.tech`; Claude Code pre-allows none, so
  110. without it the first call prompts for permission. If your organization sets
  111. `strictAllowlist` or `allowManagedDomainsOnly`, the call is blocked with no
  112. prompt (the "deep admin setting" people report).
  113. The key sits in plaintext in that file, like the `600` env file in
  114. [Get a key](#get-a-key-self-serve-and-set-it).
  115. `chmod 600 ~/.claude/settings.json` if you want matching permissions.
  116. ### claude.ai chat
  117. Works on every plan through a custom connector with sign-in.
  118. Personal plans: **Settings** > **Connectors** > **Add custom connector**.
  119. Team/Enterprise: an Owner adds it once under **Organization settings** >
  120. **Connectors**, and each member signs in with their own PlaceCall account.
  121. 1. Name it `PlaceCall`, URL `https://api.voygr.tech/mcp`. Keep the sign-in
  122. setting Claude detects.
  123. 2. **Add**, then sign in with Google or email. The first sign-in accepts the
  124. Terms of Service and Privacy Policy and creates your account with free
  125. credits.
  126. 3. Allow access. PlaceCall appears in the chat's tools menu and always
  127. confirms before placing a call.
  128. One API key for a whole workspace? Add the connector with **No sign-in** and a
  129. Request header `x-api-key` carrying your key. All calls then bill to that key.
  130. ### ChatGPT
  131. PlaceCall is in the ChatGPT plugin directory.
  132. 1. Open **Plugins**, search for PlaceCall and press **+** on the one by
  133. Voygr Tech, inc, or go straight to
  134. <https://chatgpt.com/plugins?search=placecall>.
  135. 2. Sign in with Google or email, then press **Allow** to let ChatGPT use your
  136. PlaceCall account. The first sign-in accepts the terms and creates your
  137. account with free credits.
  138. 3. In a chat, type `@PlaceCall` and ask for a call.
  139. Added PlaceCall as a custom app before it was listed? Remove that custom app,
  140. so ChatGPT has one PlaceCall to choose.
  141. If the directory listing isn't available to you, add PlaceCall as a custom
  142. app in ChatGPT on the web instead. Custom apps depend on your ChatGPT plan.
  143. 1. Open **Plugins**, then **+** > **Create plugin** > **Create MCP App**.
  144. 2. Name it `PlaceCall`, server URL `https://api.voygr.tech/mcp`,
  145. authentication **OAuth**. Leave the OAuth settings ChatGPT discovers as they
  146. are, accept the custom-app notice, and **Create**.
  147. 3. Sign in with Google or email. The first sign-in accepts the terms and
  148. creates your account with free credits.
  149. 4. In a chat, pick PlaceCall from the tools menu.
  150. ### Any MCP client (Cursor, Windsurf, MCP Inspector, ...)
  151. Point the client at `https://api.voygr.tech/mcp` (streamable HTTP transport).
  152. It is in the official MCP Registry as `io.github.voygr-tech/placecall`. Sign
  153. in with OAuth where your client supports it, or send your key on every request
  154. in either header:
  155. ```
  156. X-API-Key: <your key>
  157. ```
  158. or `Authorization: Bearer <your key>`.
  159. Claude Code keeps its own MCP config (claude.ai connectors do not carry
  160. over), so add it there:
  161. ```sh
  162. claude mcp add --transport http --scope user placecall https://api.voygr.tech/mcp
  163. ```
  164. Then run `/mcp`, pick `placecall` and sign in. To use a key instead, add
  165. `--header "X-API-Key: <your key>"`. `--scope user` makes it available in every
  166. project. The plugin above is still the richer path for Claude Code: it adds
  167. the full skill to the four tools.
  168. ### Codex
  169. PlaceCall is in the OpenAI plugin directory. Type this inside Codex (not your
  170. shell):
  171. ```
  172. /plugins
  173. ```
  174. Open the **OpenAI Curated** tab, pick PlaceCall and choose **Install plugin**.
  175. Codex opens ChatGPT: press **Connect**, sign in and press **Allow**. Then start
  176. a new Codex session and type `@PlaceCall`.
  177. Codex and ChatGPT share the directory, so a PlaceCall you add in ChatGPT
  178. (<https://chatgpt.com/plugins?search=placecall>) shows up in Codex as
  179. installed.
  180. If Codex answers `Unknown tool`, open PlaceCall's page in ChatGPT's
  181. **Plugins** and check that its app is connected; press **Connect** if it is
  182. not. If `@PlaceCall` ends up in another phone-call app, remove that app.
  183. #### The plugin from this repo
  184. The directory listing has the MCP server only. The plugin in this repo, the
  185. same one as Claude Code's, also carries the PlaceCall skill. Install one or
  186. the other: with both, Codex has two sets of PlaceCall tools. Run these in your
  187. shell:
  188. ```sh
  189. codex plugin marketplace add voygr-tech/placecall
  190. codex plugin add placecall@placecall
  191. codex mcp login placecall
  192. ```
  193. The last command opens the browser sign-in. If your Codex has no `plugin`
  194. command, update Codex or use the skill installer below.
  195. To install only the skill and use a key, type this inside Codex (not your
  196. shell); `$skill-installer` is bundled with Codex:
  197. ```
  198. $skill-installer install the skill at https://github.com/voygr-tech/placecall/tree/main/skills/placecall and name it placecall
  199. ```
  200. It expects plain English, installs the skill and reports where it landed. No
  201. restart: `$placecall` works from your next turn.
  202. If Codex does not understand the phrasing above, run the installer's script
  203. from a normal shell:
  204. ```sh
  205. python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  206. --url https://github.com/voygr-tech/placecall/tree/main/skills/placecall \
  207. --name placecall
  208. ```
  209. The installer refuses to overwrite: delete any existing `placecall` (or older
  210. `callwright`) skill in `~/.codex/skills` first. Don't run `install.sh` on
  211. Codex; that script is for Claude Code.
  212. The skill folder moved from `skills/call` to `skills/placecall` in October 2026;
  213. an install line that still says `.../tree/main/skills/call` finds nothing. An
  214. installed copy keeps working as `$placecall`. For newer versions, delete it
  215. and reinstall from the `skills/placecall` URL above.
  216. On older Codex without `$skill-installer`, or on any Codex, paste this repo's
  217. [`AGENTS.md`](./AGENTS.md) into your project's `AGENTS.md`.
  218. ### Hermes Agent
  219. One command. It prompts for the key, so nothing lands in your shell history:
  220. ```sh
  221. hermes mcp add placecall --url https://api.voygr.tech/mcp/ --auth header
  222. ```
  223. Keep the trailing slash on the URL. Answer `Y` to "Does this server require
  224. authentication?", paste the key at the masked prompt, and `Y` to enable all
  225. four tools. Hermes stores the key in `~/.hermes/.env` (as
  226. `MCP_PLACECALL_API_KEY`) and writes only a `${...}` reference into
  227. `config.yaml`. Verify with `hermes mcp test placecall`, then start a new
  228. session; tools load at session start.
  229. Do not use the skill route on Hermes. Its scanner refuses
  230. `hermes skills install placecall`, because the skill sends an API key with
  231. `curl` to a non-loopback host; the MCP route has no shell and no env var in
  232. the request.
  233. ### Gemini CLI
  234. This repo is also a Gemini CLI extension: the skill plus the PlaceCall MCP
  235. server. Install it from your shell:
  236. ```sh
  237. gemini extensions install https://github.com/voygr-tech/placecall
  238. ```
  239. The install asks for your PlaceCall API key and keeps it in the system keychain
  240. (change it later with `gemini extensions config placecall`). Gemini hands that
  241. key to the MCP server only. The skill's `curl` commands read
  242. `PLACECALL_API_KEY` from your shell, so export it as well (see
  243. [Get a key](#get-a-key-self-serve-and-set-it)). A key that is exported but not
  244. stored reaches the MCP server too.
  245. ### Cursor
  246. This repo is also a Cursor plugin (`.cursor-plugin/plugin.json`): the skill
  247. plus the PlaceCall MCP server at `https://api.voygr.tech/mcp`. The server signs
  248. you in with OAuth, so the plugin holds no key. Until it is in the Cursor
  249. Marketplace, clone it into Cursor's local plugins folder and run
  250. **Developer: Reload Window**:
  251. ```sh
  252. git clone https://github.com/voygr-tech/placecall ~/.cursor/plugins/local/placecall
  253. ```
  254. The skill's `curl` commands read `PLACECALL_API_KEY` from the environment
  255. Cursor's agent runs in. To send a key to the MCP server instead of signing in,
  256. see [Any MCP client](#any-mcp-client-cursor-windsurf-mcp-inspector-).
  257. ### Any agent / plain shell
  258. Nothing to install: the API is plain HTTP. `skills/placecall/SKILL.md` is the
  259. full reference, and a model with a shell tool can place calls straight from it.
  260. No shell on your side? Assistants with their own computer (e.g. Meta Muse)
  261. integrate from this repo: paste the repo URL into the chat and ask it to use
  262. PlaceCall for phone calls. Put the API key in its secure credential storage,
  263. never in the chat.
  264. Known to work this way: Meta Muse, OpenClaw (DeepSeek backend). Hermes needs
  265. the MCP route above. If you are an agent building this integration, send
  266. `X-Client-Surface: <your-platform>` on every request so we can see which
  267. surfaces need love.
  268. ### Apify Store (no code, a whole list)
  269. Have a list of businesses rather than an agent? [PlaceCall on the Apify Store](https://apify.com/voygr/placecall)
  270. calls every business on it, asks your questions and returns one row per call.
  271. No PlaceCall key: Apify runs it and bills it.
  272. 1. Open the Actor and press **Try for free** (you need an Apify account).
  273. 2. Bring the list: upload a CSV, link a Google Sheet, paste rows, or use another
  274. Actor's dataset, for example Google Maps results.
  275. 3. Type your questions, keep **Check my list, don't call** ticked and press
  276. **Start**. You see what each business would be asked, for free.
  277. 4. Accept the PlaceCall terms, untick the check and start again.
  278. $0.10 per call that reaches a real conversation; unanswered calls, voicemail
  279. and busy lines are free. The first 10 calls on each Apify account are free,
  280. then you need a paid Apify plan. Agents connected to the
  281. [Apify MCP server](https://mcp.apify.com) can find and run it too.
  282. ## Get a key (self-serve) and set it
  283. Signed in through a plugin or connector? You need a key only for the
  284. key-only options under [Install](#install). The skill-only routes and the raw
  285. API need one for every call. No browser? Your agent can
  286. [sign you up by email code](#sign-up-by-email-code). Otherwise:
  287. 1. Open <https://api.voygr.tech/checkout?src=gh-repo> and click **"Get free API key"**
  288. (name + email).
  289. 2. The key arrives by email; the checkout page lists what it includes and the
  290. credit rates.
  291. 3. Lost the key? <https://api.voygr.tech/recover> emails you a new one.
  292. 4. Need more credits? Top up on the same <https://api.voygr.tech/checkout?src=gh-repo>
  293. page (Stripe-hosted payment).
  294. Set it for the current session:
  295. ```sh
  296. export PLACECALL_API_KEY="<your key>"
  297. ```
  298. Or save it once (no echo to screen, `600` permissions) and load it in each
  299. session:
  300. ```sh
  301. mkdir -p ~/.codex
  302. read -rsp "PLACECALL_API_KEY: " KEY; echo
  303. printf 'export PLACECALL_API_KEY=%q\n' "$KEY" > ~/.codex/placecall.env
  304. chmod 600 ~/.codex/placecall.env
  305. unset KEY
  306. # then, in any new shell where you want to place calls:
  307. source ~/.codex/placecall.env
  308. ```
  309. No shell at all? Put the key in the `env` block of `~/.claude/settings.json`;
  310. see [Cowork](#cowork), which also covers the sandbox domain allowlist.
  311. To check the key (this prints your quota, never the key):
  312. ```sh
  313. curl -s -H "X-API-Key: $PLACECALL_API_KEY" https://api.voygr.tech/users/me
  314. ```
  315. Never commit `~/.codex/placecall.env` or paste the key into chat.
  316. ### Sign up by email code
  317. The MCP tools and their browser sign-in come first. Use the email code only
  318. when the agent has no browser, or the user needs one of the key-only
  319. options. The steps live in [the skill's sign-up
  320. section](./skills/placecall/SKILL.md#sign-up-by-email-code). In short: the
  321. agent sends the sign-up request, the user reads a 6-digit code from their
  322. email, and the agent exchanges it for a key and saves it. `AGENTS.md` carries
  323. the same steps for Codex.
  324. ## Installed this before August 2026?
  325. This project was called Callwright until 2026-08, and the repo lived at
  326. `voygr-tech/callwright-skill`.
  327. - Your existing setup keeps working: `install.sh` copies the skill, so the
  328. rename cannot break an older copy. That copy never gets fixes, which is the
  329. reason to migrate.
  330. - To migrate, delete the old copy first, or your agent has two phone skills
  331. and ambiguous routing. `install.sh` warns if it finds one.
  332. ```sh
  333. rm -rf ~/.claude/skills/callwright ~/.claude/skills/callwright-skill
  334. ```
  335. Then install the plugin above and re-export your key under its new name,
  336. `PLACECALL_API_KEY`. The key itself is unchanged.
  337. If you installed a phone-call skill from someone else (e.g. `ai-call-agent`),
  338. remove or disable that too, for the same reason.
  339. ## Good to know
  340. - A call costs 10 credits when it obtains something (an answer, a refusal or
  341. a booking), otherwise nothing. It holds 30 credits while it runs and
  342. releases the rest when it ends. A cancel is free within 30 seconds of the
  343. callee answering and charged from 30 seconds on. An answered
  344. `POST /v1/places/suggest` costs 5 credits (15 held), nothing when refused or
  345. empty, from the same balance. Holds exceed charges, so `402` can come back
  346. while the balance still covers the charge alone. `GET /users/me` shows your
  347. balance; rates and top-ups are at <https://api.voygr.tech/checkout?src=gh-repo>.
  348. The free tier is one pot: 250 free calls is 2,500 credits, and suggestions
  349. spend from the same 2,500.
  350. - After a call reaches `completed`, the outcome and transcript can land a
  351. moment after the status flips, so poll `GET /calls/{id}` until `result` is
  352. non-null. Any non-null `result` is final for that call. The transcript is
  353. complete once `transcript_status` reads `final`, usually a minute or two
  354. later.
  355. - 13 language codes are accepted: `en`, `es`, `fr`, `de`, `hi`, `ru`, `pt`,
  356. `ja`, `it`, `nl`, `sr`, `tr`, `pl`. The default, `auto`, runs the call in
  357. English and does not switch mid-call; send `es` for a call in Spanish. `en`
  358. is the most reliable; non-English is best-effort.
  359. - Only call numbers you're authorized to call; every call rings a real phone.
  360. US destinations only, except IN, LA, MN, MT, NE. By default every call opens
  361. with a notice that the line is recorded (in English and Spanish it also names
  362. PlaceCall). The optional `disclosure` and `record_call` fields change or
  363. switch off that opening; see the skill's "Opening notice" section.
  364. ## Network access
  365. The skill is instructions your agent follows, through the MCP tools or
  366. `curl`; nothing runs on its own. Every request goes over HTTPS to one host,
  367. `api.voygr.tech`, and nothing is sent anywhere else.
  368. - MCP server: the Claude Code, Codex and Cursor plugins and the Gemini CLI
  369. extension register `https://api.voygr.tech/mcp`. `suggest_places` sends your
  370. request and an optional location. `place_call` sends the number, brief,
  371. language and, if set, how the agent may reach you mid-call, the client's
  372. name and the items to find out.
  373. `get_call_result` sends a call id. `answer_question` sends a call id, a
  374. question id and your answer.
  375. - Calls: `POST /calls` sends the number, your brief, the language and any
  376. optional fields you set, such as `items`.
  377. `GET /calls`, `GET /calls/{id}`, `GET /calls/{id}/events`,
  378. `POST /calls/{id}/answer`, `POST /calls/{id}/cancel` and
  379. `GET /calls/{id}/recording` follow and read it.
  380. - Finding a place: `POST /v1/places/suggest` sends your request, plus the name
  381. and callback number when you give them.
  382. - Account: `GET /users/me`, `GET /v1/usage`, `GET /checkout/packs` and
  383. `PUT /users/me/limits`.
  384. - Sign-up by email code: `POST /signup` sends your name and email;
  385. `POST /signup/verify` sends the code from the email.
  386. The plugins sign in to the MCP server with OAuth, so your client sends an
  387. access token, not a key; the Gemini CLI extension sends your key in
  388. `X-API-Key`. Every `curl` request carries the key in `X-API-Key`, except the
  389. two sign-up calls, which send none (`POST /signup/verify` returns one).
  390. `PLACECALL_API_KEY` goes only to `api.voygr.tech`.
  391. `POST /calls` also sends four headers that never affect auth or billing.
  392. `Idempotency-Key` stops a retry dialing twice. `X-Client-Surface` names the
  393. listing these instructions came from. `X-Client-Agent` names the tool that
  394. placed the call (`claude-code`, `cursor`, `codex` or `gemini-cli`), worked out
  395. from which of `CLAUDECODE`, `CURSOR_AGENT`, `CODEX_SANDBOX` and `GEMINI_CLI`
  396. is set. Only the name is sent, never a variable's value. `X-Client-Version`
  397. names the version of these instructions, so the service can count calls from
  398. older installed copies before it removes a field.
  399. The skill reads one local file, `~/.codex/placecall.env`, only when
  400. `PLACECALL_API_KEY` is unset; the email-code sign-up writes it. `install.sh`
  401. makes no network calls, and the skill never fetches the checkout, recovery or
  402. docs links in this README.
  403. On our side, a call rings a real phone and is recorded. Recordings and
  404. transcripts are kept for 90 days. Security reports: [SECURITY.md](./SECURITY.md).
  405. Full reference: [`skills/placecall/SKILL.md`](./skills/placecall/SKILL.md) (Claude Code) · [`AGENTS.md`](./AGENTS.md) (Codex).
  406. Live API docs: <https://api.voygr.tech/docs>.
  407. If PlaceCall is useful, star this repo. It helps a lot.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.