📞 call-my-human no call

\n\n`;\n\n// Favicon: the 📞 emoji as an SVG. Browsers (and connector clients that read the\n// origin's favicon to show the server's icon) fetch this.\nconst FAVICON =\n ``;\nconst favicon = () =>\n new Response(FAVICON, {\n headers: { \"content-type\": \"image/svg+xml; charset=utf-8\", \"cache-control\": \"public, max-age=86400\" },\n });\napp.get(\"/favicon.ico\", favicon);\napp.get(\"/favicon.svg\", favicon);\n\n// ---------- agent-setup instructions (file-backed) ----------\n// The splash's \"Copy agent instructions\" button copies this. It lives in an\n// editable markdown file (skills/call-my-human-setup/SKILL.md) so the copy and the\n// docs stay in one place. Read once at first use; a read failure falls back so the\n// page — and the MCP endpoint — never break.\nconst SETUP_FALLBACK =\n \"# Set up Call My Human 📞\\n\\nAdd this as a custom MCP connector (BYO free Vapi key from https://dashboard.vapi.ai):\\n\\n https://call-my-human.val.run/mcp?vapi_key=YOUR_KEY&phone_number_id=YOUR_PHONE_ID&human_number=%2B1XXXXXXXXXX\\n\\nThen: dispatch_call({ objective, questions }) -> await_report. Full docs + source: https://www.val.town/x/dcm31/call-my-human\";\nlet _setupMd: string | null = null;\nasync function setupInstructions(): Promise {\n if (_setupMd != null) return _setupMd;\n try {\n _setupMd = await readFile(\"/skills/call-my-human-setup/SKILL.md\", import.meta.url);\n } catch (e) {\n console.log(\"setup-md read failed, using fallback:\", String(e).slice(0, 140));\n _setupMd = SETUP_FALLBACK;\n }\n return _setupMd;\n}\n\nconst escapeHtml = (s: string) => s.replace(/&/g, \"&\").replace(//g, \">\");\n\n// Polished splash for humans (browsers). sleek-ui: one bold move (the aqua),\n// everything else quiet — system font, stark ink, a single primary CTA.\nfunction splashPage(md: string): string {\n return `\n\n\nCall My Human\n\n\n\n\n\n\n

📞

Remote MCP Connector

Call My Human

\n \n View source\n

Agents: /agent-instructions

${escapeHtml(md)}

\n`;\n}\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// Agent-readable setup instructions — the SAME SKILL.md the splash copies. An\n// agent handed the bare URL, or these explicit paths, gets the exact paste block\n// as plain text. (/llms.txt is the emerging convention agents probe for.)\nconst serveAgentInstructions = async (c: any) => c.text(await setupInstructions());\napp.get(\"/agent-instructions\", serveAgentInstructions);\napp.get(\"/llms.txt\", serveAgentInstructions);\n\n// Full technical landing (MCP + REST endpoints) for anyone who wants it.\napp.get(\"/help\", (c) => c.text(landing(new URL(c.req.url).origin)));\n\napp.get(\"/\", async (c) => {\n if (c.req.query(\"c\")) return c.html(PAGE);\n // Browsers get the splash; everything else (agents, curl) gets the setup\n // instructions as plain text, so the bare URL \"just works\" when given to an agent.\n if ((c.req.header(\"accept\") ?? \"\").includes(\"text/html\")) {\n return c.html(splashPage(await setupInstructions()));\n }\n return serveAgentInstructions(c);\n});\n\nexport default app.fetch;\n",[],[98],"9be037fe-6d55-4da8-9852-189198318a19","db.ts","019ec890-2328-734f-a4be-e46d21840215",80,["D",1782227392511],6,"// SQLite layer: calls + an append-only event feed per call, scoped by tenant.\n// A tenant is a hash of the caller's Vapi key (full SHA-256) — every connecting\n// user gets their own call history on this shared public server. The tenant is\n// internal-only: it never appears in a shareable URL. Per-call random secrets\n// (watch_token, webhook_secret) gate the watch page and inbound webhooks instead.\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nawait sqlite.batch([\n `CREATE TABLE IF NOT EXISTS calls (\n id TEXT PRIMARY KEY,\n tenant TEXT,\n control_url TEXT,\n status TEXT DEFAULT 'starting',\n ended_reason TEXT,\n live_partial TEXT,\n cursor INTEGER DEFAULT 0,\n number TEXT,\n watch_token TEXT,\n webhook_secret TEXT,\n created_at TEXT\n )`,\n `CREATE TABLE IF NOT EXISTS events (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n tenant TEXT,\n call_id TEXT,\n type TEXT,\n role TEXT,\n content TEXT,\n created_at TEXT\n )`,\n // Anonymous, append-only tally: one row per dispatched call, JUST a timestamp.\n // No tenant, no number, no content — it's a pure volume counter (calls/day).\n // The retention purge never touches this table, so the daily history survives\n // even after the transcripts/events for a call are deleted.\n `CREATE TABLE IF NOT EXISTS call_log (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n at TEXT\n )`,\n]);\n// Older/remixed schemas may predate some columns — add them if missing.\nfor (const sql of [\n `ALTER TABLE calls ADD COLUMN tenant TEXT`,\n `ALTER TABLE calls ADD COLUMN watch_token TEXT`,\n `ALTER TABLE calls ADD COLUMN webhook_secret TEXT`,\n `ALTER TABLE events ADD COLUMN tenant TEXT`,\n]) {\n try {\n await sqlite.execute(sql);\n } catch { /* already there */ }\n}\n\nconst now = () => new Date().toISOString();\n\n// Statuses that mean a call is still live. Shared with tools.ts so the retention\n// purge and the dispatch concurrency guard agree on what \"active\" means.\nexport const ACTIVE_STATUSES = [\"starting\", \"queued\", \"ringing\", \"in-progress\", \"forwarding\"];\n\n// A 128-bit random hex token — used as a per-call watch capability and webhook secret.\nexport function randomToken(bytes = 16): string {\n const a = new Uint8Array(bytes);\n crypto.getRandomValues(a);\n return [...a].map((b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nexport interface CallRow {\n id: string;\n tenant: string;\n control_url: string;\n status: string;\n ended_reason: string | null;\n live_partial: string | null;\n cursor: number;\n number: string;\n watch_token: string | null;\n webhook_secret: string | null;\n created_at: string;\n}\n\nexport interface EventRow {\n id: number;\n tenant: string;\n call_id: string;\n type: string;\n role: string;\n content: string;\n created_at: string;\n}\n\nexport async function insertCall(\n tenant: string,\n id: string,\n controlUrl: string,\n number: string,\n watchToken: string,\n webhookSecret: string,\n) {\n await sqlite.execute({\n sql: `INSERT INTO calls (id, tenant, control_url, status, cursor, number, watch_token, webhook_secret, created_at)\n VALUES (?, ?, ?, 'starting', 0, ?, ?, ?, ?)`,\n args: [id, tenant, controlUrl, number, watchToken, webhookSecret, now()],\n });\n}\n\nexport async function latestCall(tenant: string): Promise {\n const r = await sqlite.execute({\n sql: `SELECT * FROM calls WHERE tenant = ? ORDER BY created_at DESC LIMIT 1`,\n args: [tenant],\n });\n return (r.rows[0] as unknown as CallRow) ?? null;\n}\n\nexport async function getCall(id: string): Promise {\n const r = await sqlite.execute({ sql: `SELECT * FROM calls WHERE id = ?`, args: [id] });\n return (r.rows[0] as unknown as CallRow) ?? null;\n}\n\nexport async function setCallStatus(id: string, status: string, endedReason?: string | null) {\n await sqlite.execute({\n sql: `UPDATE calls SET status = ?, ended_reason = COALESCE(?, ended_reason) WHERE id = ?`,\n args: [status, endedReason ?? null, id],\n });\n}\n\nexport async function setPartial(id: string, partial: string | null) {\n await sqlite.execute({ sql: `UPDATE calls SET live_partial = ? WHERE id = ?`, args: [partial, id] });\n}\n\nexport async function setCursor(id: string, cursor: number) {\n await sqlite.execute({ sql: `UPDATE calls SET cursor = ? WHERE id = ?`, args: [cursor, id] });\n}\n\nexport async function addEvent(tenant: string, callId: string, type: string, role: string, content: string) {\n await sqlite.execute({\n sql: `INSERT INTO events (tenant, call_id, type, role, content, created_at) VALUES (?, ?, ?, ?, ?, ?)`,\n args: [tenant, callId, type, role, content, now()],\n });\n}\n\nexport async function eventsAfter(callId: string, afterId: number): Promise {\n const r = await sqlite.execute({\n sql: `SELECT * FROM events WHERE call_id = ? AND id > ? ORDER BY id ASC`,\n args: [callId, afterId],\n });\n return r.rows as unknown as EventRow[];\n}\n\nexport async function hasTranscript(callId: string): Promise {\n const r = await sqlite.execute({\n sql: `SELECT 1 FROM events WHERE call_id = ? AND type = 'transcript' LIMIT 1`,\n args: [callId],\n });\n return r.rows.length > 0;\n}\n\nexport async function latestEventOfType(callId: string, type: string): Promise {\n const r = await sqlite.execute({\n sql: `SELECT * FROM events WHERE call_id = ? AND type = ? ORDER BY id DESC LIMIT 1`,\n args: [callId, type],\n });\n return (r.rows[0] as unknown as EventRow) ?? null;\n}\n\nexport async function transcriptLines(callId: string, limit = 200): Promise {\n const r = await sqlite.execute({\n sql: `SELECT * FROM events WHERE call_id = ? AND type = 'transcript' ORDER BY id ASC LIMIT ?`,\n args: [callId, limit],\n });\n return r.rows as unknown as EventRow[];\n}\n\nexport async function recentEvents(callId: string, limit = 100): Promise {\n const r = await sqlite.execute({\n sql: `SELECT * FROM events WHERE call_id = ? ORDER BY id DESC LIMIT ?`,\n args: [callId, limit],\n });\n return (r.rows as unknown as EventRow[]).reverse();\n}\n\n// ---------- anonymous volume tally ----------\n\n// Record that a call happened. Just a timestamp — no tenant, number, or content.\nexport async function logCall(): Promise {\n await sqlite.execute({ sql: `INSERT INTO call_log (at) VALUES (?)`, args: [now()] });\n}\n\n// Calls per UTC day, most recent first. Aggregate-only; no per-user breakdown.\nexport async function callsPerDay(days = 90): Promise> {\n const r = await sqlite.execute({\n sql: `SELECT substr(at, 1, 10) AS day, COUNT(*) AS count\n FROM call_log GROUP BY day ORDER BY day DESC LIMIT ?`,\n args: [days],\n });\n return r.rows as unknown as Array<{ day: string; count: number }>;\n}\n\n// ---------- erase a call ----------\n\n// Wipe one call completely: every event (transcripts, report, analysis, status)\n// AND the call row itself (which holds the dialed number, control_url, secrets).\n// Leaves only the anonymous call_log timestamp. Called the moment await_report\n// hands the finished report back to the dispatcher — so in the normal flow a\n// conversation lives in our DB for minutes, then it's gone.\nexport async function purgeCallData(callId: string): Promise {\n await sqlite.batch([\n { sql: `DELETE FROM events WHERE call_id = ?`, args: [callId] },\n { sql: `DELETE FROM calls WHERE id = ?`, args: [callId] },\n ]);\n}\n\n// ---------- backstop sweep ----------\n\n// Catch anything delete-on-delivery missed — calls a dispatcher never collected,\n// or whose analysis never arrived. Purely age-based and floored at 16 minutes, so\n// a live call (15-min hard max) can NEVER be caught no matter how low the setting.\n// Never touches call_log. Returns how many call rows were removed.\nexport async function purgeExpired(retentionMinutes: number): Promise<{ calls: number }> {\n const mins = Math.max(retentionMinutes, 16);\n const cutoff = new Date(Date.now() - mins * 60_000).toISOString();\n const r = await sqlite.execute({\n sql: `SELECT COUNT(*) AS n FROM calls WHERE created_at < ?`,\n args: [cutoff],\n });\n const n = Number((r.rows[0] as any)?.n ?? 0);\n if (n > 0) {\n await sqlite.batch([\n { sql: `DELETE FROM events WHERE call_id IN (SELECT id FROM calls WHERE created_at < ?)`, args: [cutoff] },\n { sql: `DELETE FROM calls WHERE created_at < ?`, args: [cutoff] },\n ]);\n }\n return { calls: n };\n}\n",[],[108],"d7ea4717-01e5-486e-8edd-af308f16b7bb","cleanup.ts","0f18da28-6f14-11f1-8760-1607ee4eb77e",84,["D",1782227430023],1,"interval","// Backstop sweep. Most calls are erased the instant the dispatcher collects the\n// report (delete-on-delivery, in tools.ts await_report). This catches the rest —\n// calls a dispatcher never collected, or whose analysis never arrived — so no\n// transcript lingers in this shared public val's SQLite.\n//\n// Safety: purgeExpired is age-based and floored at 16 minutes, while the longest\n// a call can run is 15 (max_minutes is capped in tools.ts). Nothing in flight can\n// ever be touched. The anonymous calls/day tally (call_log) is NEVER purged.\n//\n// Set RETENTION_MINUTES to override the 30-minute default (per-instance; floored\n// at 16). Runs every 15 minutes — see this file's interval settings.\n\nimport * as db from \"./db.ts\";\n\nconst RETENTION_MINUTES = Math.max(Number(Deno.env.get(\"RETENTION_MINUTES\") ?? 30), 16);\n\nexport default async function () {\n const { calls } = await db.purgeExpired(RETENTION_MINUTES);\n console.log(`cleanup: swept ${calls} stale call(s) older than ${RETENTION_MINUTES}m (delivered calls already wiped; call_log untouched)`);\n}\n",[],[117],"e1c8dbea-2e6f-4ac8-8256-ae0772915005","README.md","019ec890-2328-734f-a4be-e3c03c1985c4",92,["D",1782228393708],18,"# call-my-human — send an agent to phone your human 📞\n\nA **public remote MCP server**: connect it to any AI agent and it can dispatch an *autonomous* voice agent to phone your human, **run the whole conversation itself**, hang up, and hand back a structured report. Brief it once (`objective` + `context` + `questions`); it talks, ends the call, and you collect the result. The agent runs an LLM brain **inside Vapi's stack**, so the call is low-latency and natural — you don't drive it turn by turn. **BYOK: no env vars, no server-side keys, no signup.**\n\n> Related vals: [`call-my-human-no-middle-agent`](https://www.val.town/x/dcm31/call-my-human-no-middle-agent) lets your agent drive the call word by word instead of handing it off; [`dispatch-my-human-escape`](https://www.val.town/x/dcm31/dispatch-my-human-escape) adds a mid-call escape hatch so the voice agent can call you back when the human asks something off-brief.\n\n```mermaid\nsequenceDiagram\n participant Agent as Your agent (MCP client)\n participant Val as call-my-human (this val)\n participant Vapi as Vapi (gpt-4o + Elliot voice)\n participant Human as 📱 Your human\n\n Agent->>Val: dispatch_call(objective, context, questions)\n Val->>Vapi: POST /call (your Vapi key)\n Vapi->>Human: places the call, runs the whole conversation\n Human-->>Vapi: answers, asks, decides\n Vapi-->>Val: transcripts + end-of-call report (/webhook)\n Agent->>Val: await_report (long-poll until done)\n Val-->>Agent: summary + per-question answers + followups\n```\n\nWhen the call ends, Vapi's **analysis plan** auto-extracts a summary, an answer to each question you asked, and any follow-ups; `await_report` returns it.\n\n## The loop\n\nTwo tools cover the common case:\n\n1. **`dispatch_call`** `{ objective, context?, questions?, number?, first_message?, caller_identity?, max_minutes? }` — the agent hands off the call.\n2. **`await_report`** `{ wait_seconds }` — long-polls; the agent keeps calling it until `done:true`. Returns `{ summary, objective_met, answers[], followups, transcript }`.\n\nOptional supervisor hooks (rarely needed): **`listen`** (eavesdrop on the live call), **`say`** (barge in with a verbatim line), **`get_status`**, **`end_call`**.\n\n## What you need\n\nTwo values from [dashboard.vapi.ai](https://dashboard.vapi.ai):\n\n- your **private key**\n- a **phone number ID** (free Vapi numbers work, US-only — see the reliability note at the bottom)\n\n…plus your **cell number** in E.164 (e.g. `+15551234567`) as the default callee.\n\n## Add it as a connector\n\n### claude.ai (web / desktop)\n\n1. **Settings → Connectors → Add custom connector.**\n2. **Name:** `call-my-human` (anything you like — it's just a label).\n3. **Remote MCP server URL:** paste your connection URL with the three values filled in:\n ```\n https://call-my-human.val.run/mcp?vapi_key=YOUR_KEY&phone_number_id=YOUR_PHONE_ID&human_number=%2B15551234567\n ```\n4. Leave **OAuth Client ID / Secret** blank, then click **Add**.\n\n> ⚠️ **The `+` in `human_number` must be URL-encoded as `%2B`** (`+15551234567` → `%2B15551234567`).\n\n### Claude Code / Codex (CLI)\n\n```sh\nclaude mcp add --transport http call-my-human \\\n \"https://call-my-human.val.run/mcp?vapi_key=YOUR_KEY&phone_number_id=YOUR_PHONE_ID&human_number=%2B15551234567\"\n```\n\n`Authorization: Bearer ` is accepted in place of the `vapi_key` param, so CLIs can keep the key out of the URL:\n\n```sh\nclaude mcp add --transport http call-my-human \\\n \"https://call-my-human.val.run/mcp?phone_number_id=YOUR_PHONE_ID&human_number=%2B15551234567\" \\\n --header \"Authorization: Bearer YOUR_KEY\"\n```\n\nAny MCP client that takes a URL works. The brain runs on your Vapi account's bundled **OpenAI** model (`gpt-4o` default — no extra LLM key needed). Override with `&model=gpt-4o-mini` (faster) or any Vapi-supported model.\n\nThen just tell your agent: *\"if you get stuck, dispatch a call to me and ask.\"*\n\n## Example\n\n> Agent: `dispatch_call({ objective: \"Decide whether to ship the v2 release tonight\", context: \"QA found one minor cosmetic bug, nothing functional. The marketing email is scheduled for 8am.\", questions: [\"Ship tonight or hold for the fix?\", \"If we hold, what's the new target?\"], caller_identity: \"Charlie's AI assistant\" })`\n>\n> …agent calls, talks it through, hangs up…\n>\n> Agent: `await_report({})` → `{ objective_met: true, answers: [{question:\"Ship tonight or hold for the fix?\", answer:\"Ship tonight\"}, {question:\"If we hold, what's the new target?\", answer:\"N/A — shipping\"}], summary: \"...\", followups: \"Wants a Slack ping once it's live.\" }`\n\n## Watching a call live\n\n`dispatch_call` and `get_status` return a `watch_url` (`/?c=&k=`) — a self-refreshing page that streams statuses and the both-sides transcript while the call is happening. The structured report goes to whoever calls `await_report`; once that lands, the call is erased and the page stops showing it. The `k` is a per-call watch token, so a shared link exposes only that one call, never your whole history.\n\n## Testing with curl\n\n```sh\nBASE=\"https://call-my-human.val.run\"\nQ=\"vapi_key=YOUR_KEY&phone_number_id=YOUR_PHONE_ID&human_number=%2B15551234567\"\ncurl -X POST \"$BASE/api/call/dispatch?$Q\" -d '{\"objective\":\"Confirm Friday dinner\",\"questions\":[\"Still on for Friday?\",\"What time?\"]}'\ncurl -X POST \"$BASE/api/call/report?$Q\" -d '{\"wait_seconds\":25}' --max-time 35 # repeat until done:true\n```\n\n## Self-host: remix for full privacy 🔒\n\nEven on this shared public instance, transcripts are erased the moment your agent collects the report and are never logged (see [Multi-tenancy & privacy](#multi-tenancy--privacy)). But your Vapi key and the in-call transcript still transit a val **you don't own.** For maximum control — secrets out of the URL, and not even transient state touching someone else's val — **run your own copy.**\n\n1. **Remix (fork) the val:** open **[dcm31/call-my-human](https://www.val.town/x/dcm31/call-my-human)** and click **Fork** (top-right). You now own an identical, zero-config copy.\n2. **Put your secrets in environment variables** on your fork (its **Environment Variables** settings) instead of in the URL:\n\n | Env var | Value |\n | --- | --- |\n | `VAPI_KEY` | your Vapi private key |\n | `VAPI_PHONE_NUMBER_ID` | your Vapi phone number ID |\n | `HUMAN_NUMBER` | your cell in E.164, e.g. `+15551234567` |\n | `VAPI_MODEL` *(optional)* | brain model — defaults to `gpt-4o` |\n\n 👉 Set them at: `https://www.val.town/x//call-my-human/environment-variables`\n3. **Connect with a clean URL — no secrets in it.** Grab your fork's HTTP endpoint (shown at the top of `main.ts`) and add `/mcp`:\n ```\n https://.web.val.run/mcp\n ```\n\nPrecedence is **query param / bearer header → env var**, so the public instance (no env set) stays pure BYOK, while your fork can run entirely on env. You can still override the callee per call with the `number` arg or `&human_number=…`.\n\n## Files\n\n- `main.ts` — routes, per-tenant Vapi webhook (transcripts + end-of-call analysis), env/URL credential resolution, landing + live feed, the `/stats` tally\n- `tools.ts` — the tools, shared by MCP and REST; builds the agent's system prompt from your brief\n- `vapi.ts` — Vapi REST client: native-model call creation with the `endCall` tool + structured-data analysis plan\n- `mcp.ts` — minimal stateless streamable-HTTP MCP plumbing (no SDK)\n- `db.ts` — SQLite: tenant-scoped `calls` + `events` (held only during a call), `purgeCallData` (erase-on-delivery), the anonymous `call_log` tally, and the backstop sweep\n- `cleanup.ts` — interval (every 15 min) that erases any call a dispatcher never collected, past `RETENTION_MINUTES` (the `call_log` tally is never touched)\n\n## Multi-tenancy & privacy\n\n- Your Vapi key is read per-request and **never stored** (only a hash is logged). It travels TLS-encrypted to this val and on to Vapi, like any BYOK MCP server.\n- During a call, transcripts and the report pass through this val's SQLite (scoped by a `tenant` = SHA-256(your key) — unguessable without the key, and how Vapi's webhooks route back via `/webhook/`, verified with `x-vapi-secret`).\n- **Erased on delivery.** The moment `await_report` hands the finished report back to your agent, that call — transcript, report, dialed number, the whole row — is **deleted** from this val's DB. In the normal flow a conversation lives here for *minutes*, then it's gone. A backstop sweep (every 15 min, `RETENTION_MINUTES`, default 30, floored at 16) erases anything a dispatcher never collected. The durable copy of the call lives only in **your own Vapi account**, under your key — never here.\n- **Not logged.** Transcript text is never written to this val's logs (only event types/counts are).\n- The one thing kept is an **anonymous volume tally**: a bare timestamp per dispatched call, with no tenant, number, or content. It powers `GET /stats` (calls/day) and nothing else.\n- Want full custody anyway? **Remix it** (see above) — it needs zero configuration.\n\n## Notes\n\n- The agent ends calls itself via Vapi's `endCall` tool once the objective is met; `max_minutes` (default 10) is a hard cap. 30s of mutual silence also ends it.\n- Latency is set by Vapi's STT→LLM→TTS pipeline (~1–2s/turn), not your agent's reasoning loop.\n- Post-call analysis (summary + structured data) completes a few seconds *after* the call ends, so `await_report` may return `done:false` once right at hangup — just call it again.\n- The line is clean (no background ambience). Free Vapi numbers are test-grade (occasional dead bridges, a daily outbound limit, narrowband audio). Import a Twilio number into Vapi for reliability.\n- Only call numbers you have consent to call — automated calls without consent violate TCPA/FCC rules.\n",[],[127],["D",1782166791021],[138],[19],{"_34":35,"_13":36,"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":139,"_17":49,"_50":51,"_52":-5,"_53":54,"_55":-5,"_76":140,"_18":141},["D",1782166791021],[142],[19,36],{"_34":143,"_13":144,"_37":145,"_39":38,"_41":42,"_43":146,"_45":46,"_47":147,"_17":112,"_50":24,"_52":148,"_53":54,"_55":-5,"_76":149,"_18":150},"38263f5e-49d2-42e7-b408-a4d035928719","SKILL.md","7ca27d9c-6e88-11f1-9be9-1607ee4eb77e",95,["D",1782228409611],"---\nname: call-my-human-setup\ndescription: Set up the Call My Human MCP connector so an AI agent can place a real phone call to its human — ask a question, get a decision, run a quick errand call — and get a structured report back. Use when a human pastes this and says \"set this up for me.\"\n---\n\n# Set up Call My Human 📞\n\nYou're being asked to wire up **Call My Human** — a public remote MCP server that lets you (the agent) dispatch a voice agent to phone your human, run the whole call itself, and hand back a structured report (summary + answer to each question you asked). It's BYOK: it runs on your human's own Vapi account. The server holds the transcript only during the call and erases it the moment you collect the report — nothing lingers, and transcript text is never logged.\n\nWalk your human through this. They don't need anything beforehand.\n\n## 1. Get free Vapi credentials (~2 min)\n\nSend them to **https://dashboard.vapi.ai**, have them sign up (free), then grab two things:\n\n- their **private API key**\n- a **phone number ID** — Vapi hands out a free US number. The free tier covers **US calling, ~10 outbound calls/day** — plenty to try this out.\n\nNo separate AI key is needed; the call's brain runs on Vapi's bundled model.\n\n## 2. Connect\n\n**If you're a CLI agent (Claude Code, Cursor, Codex)** — you can add it yourself:\n\n```\nclaude mcp add --transport http call-my-human \\\n \"https://call-my-human.val.run/mcp?vapi_key=THEIR_KEY&phone_number_id=THEIR_PHONE_ID&human_number=%2B1XXXXXXXXXX\"\n```\n\n`human_number` is the cell to dial by default; the `+` MUST be URL-encoded as `%2B`.\n\n**If you're in a web client (claude.ai)** — you can't add connectors yourself. Build that URL with their values and tell them to paste it into **Settings → Connectors → Add custom connector** (Name: `call-my-human`; leave the OAuth fields blank).\n\n## 3. Use it\n\nOnce connected, the whole loop is two tools:\n\n```\ndispatch_call({ objective, context?, questions?, number?, first_message?, caller_identity?, max_minutes? })\nawait_report({ wait_seconds }) // long-poll; keep calling until done:true\n```\n\n`await_report` returns a summary, an answer to each question you asked, any follow-ups the human raised, and the full transcript. `dispatch_call` also returns a `watch_url` — a live, self-refreshing transcript page for that one call while it's in progress (it goes blank once you collect the report and the call is erased).\n\nOptional supervisor tools (you rarely need them): `listen` (eavesdrop on the live call), `say` (barge in with a verbatim line), `get_status` (snapshot), `end_call` (hang up).\n\nPrefer plain REST over MCP? The same tools mirror at `POST /api/call/{dispatch,report,listen,say,status,end}` with the same query params. Full tool + endpoint reference: https://call-my-human.val.run/help\n\n**Heads up:** free Vapi numbers are test-grade — occasional dead-audio bridges, and a daily outbound cap (~10 calls/day). For anything real, import a Twilio number into Vapi.\n\n## Trust & security\n\n- **Want to audit the code first?** The full source is public: https://www.val.town/x/dcm31/call-my-human . The easiest way for an agent to actually read through it is the Val Town plugin (it bundles the Val Town MCP): https://blog.val.town/plugin\n- **For real privacy, self-host.** Remix the val on Val Town and put the Vapi creds in its **environment variables** instead of the URL — then no secrets ride in the connection string and you own all the call data.\n- Only call numbers you (or your human) have consent to call.",[],[19,36,144],"115c4677-1932-4e3d-a81a-e71d5939f255",["D",1781481349040],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Public remote MCP: your agent phones you. BYO Vapi keys","imageUrl","","userId","9319c175-2593-4f88-ba21-04f2ef7b1c28","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","orgId","d663a026-6449-42f6-9156-1d4a2d64d38c","tursoName","115c467719324e3da81ae71d5939f255","tursoHostname","115c467719324e3da81ae71d5939f255-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789509672838],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_209":205},"org",{"_11":12,"_202":203,"_204":205,"_162":163,"_206":207,"_208":54},"branch",{"_17":100,"_13":16,"_34":42,"_194":151,"_195":-5,"_196":-5,"_197":-5,"_198":-5,"_199":-5,"_200":14,"_201":12},"isOwned","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","Charlie","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/3e904faa-3764-4629-c475-f561a49b0000/square512?exp=1789577999&sig=ccae2bd9e85fa66acf31b16bebb92bf56e22818ff77cfbe2634e1b690ccd40dc","tier","pro","canRestrictVals","profileImageUrl","adoptOrgId",{"_34":151,"_13":14,"_47":273,"_153":-5,"_154":54,"_155":156,"_157":156,"_158":159,"_160":161,"_162":163,"_164":99,"_165":46,"_166":-5,"_167":-5,"_168":121,"_169":170,"_171":172,"_173":174,"_175":274,"_177":-5,"_178":179,"_180":179,"_181":182,"_183":182,"_184":182,"_185":179,"_186":179,"_187":275,"_189":276,"_191":277,"_193":54},[243,246,247,248,249,250,251,252],"files",[243,244,245,246,247,248,249,250,251,252],"counts",{"_233":49,"_234":121,"_235":121,"_32":236,"_237":238},[231],{"_34":57,"_13":19,"_37":40,"_39":-5,"_41":42,"_43":44,"_45":46,"_47":229,"_17":49,"_50":51,"_52":-5,"_53":54,"_55":-5,"_18":230},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1782166791021],[19],{"_34":35,"_13":36,"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_17":49,"_50":51,"_52":-5,"_53":54,"_55":-5,"_18":232},[19,36],"pulls","branches","forks",{"_239":241,"_242":49},"connections",{"_239":49,"_240":49},"count","unfilledCount",4,"emptyCount",{"_34":57,"_13":19,"_37":40,"_39":-5,"_41":42,"_43":44,"_45":46,"_47":135,"_17":49,"_50":51,"_52":-5,"_53":54,"_55":-5,"_76":271,"_18":272},{"_34":35,"_13":36,"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":139,"_17":49,"_50":51,"_52":-5,"_53":54,"_55":-5,"_76":269,"_18":270},{"_34":143,"_13":144,"_37":145,"_39":38,"_41":42,"_43":146,"_45":46,"_47":147,"_17":112,"_50":24,"_52":148,"_53":54,"_55":-5,"_76":267,"_18":268},{"_34":126,"_13":127,"_37":128,"_39":-5,"_41":42,"_43":129,"_45":46,"_47":130,"_17":131,"_50":24,"_52":132,"_53":54,"_55":-5,"_76":265,"_18":266},{"_34":116,"_13":117,"_37":118,"_39":-5,"_41":42,"_43":119,"_45":46,"_47":120,"_17":121,"_50":122,"_52":123,"_53":54,"_55":-5,"_76":263,"_18":264},{"_34":107,"_13":108,"_37":109,"_39":-5,"_41":42,"_43":110,"_45":46,"_47":111,"_17":112,"_50":74,"_52":113,"_53":54,"_55":-5,"_76":261,"_18":262},{"_34":97,"_13":98,"_37":99,"_39":-5,"_41":42,"_43":100,"_45":46,"_47":101,"_17":102,"_50":103,"_52":104,"_53":54,"_55":14,"_76":259,"_18":260},{"_34":88,"_13":89,"_37":90,"_39":-5,"_41":42,"_43":91,"_45":46,"_47":92,"_17":93,"_50":74,"_52":94,"_53":54,"_55":-5,"_76":257,"_18":258},{"_34":79,"_13":80,"_37":81,"_39":-5,"_41":42,"_43":82,"_45":46,"_47":83,"_17":84,"_50":74,"_52":85,"_53":54,"_55":-5,"_76":255,"_18":256},{"_34":68,"_13":69,"_37":70,"_39":-5,"_41":42,"_43":71,"_45":46,"_47":72,"_17":73,"_50":74,"_52":75,"_53":54,"_55":-5,"_76":253,"_18":254},[],[69],[],[80],[],[89],[],[98],[],[108],[],[117],[],[127],[],[19,36,144],[245],[19,36],[244],[19],["D",1781481349040],["D",1789509672838],{"_11":12,"_209":205},{"_11":12,"_202":203,"_204":205,"_162":163,"_206":207,"_208":54},{"_17":100,"_13":16,"_34":42,"_194":151,"_195":-5,"_196":-5,"_197":-5,"_198":-5,"_199":-5,"_200":14,"_201":12},"ctx",{"_187":-5,"_226":311,"_312":313,"_314":315,"_316":54,"_317":54,"_318":54,"_319":46,"_320":-5,"_321":-7,"_322":-7,"_323":49,"_324":54,"_325":54,"_326":-5,"_327":54,"_328":54,"_329":54,"_330":-5},"ENV",{"_282":283,"_284":285,"_286":16,"_287":288,"_289":290,"_291":292,"_293":294,"_295":296,"_297":298,"_299":300,"_301":302,"_303":304,"_305":306,"_307":308,"_309":310},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]