@spekoai/mcp-calls 0.1.1 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spekoai/mcp-calls",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Place real, disclosed phone calls to businesses straight from your coding agent — the Speko \"AI calls for devs\" MCP. Single self-contained package: `npx @spekoai/mcp-calls init` to set up.",
   "mcpName": "ai.speko/mcp-calls",
   "type": "module",

package/server.json

@@ -4,13 +4,13 @@
   "title": "Speko — AI Calls for Devs",
   "description": "Place real, disclosed outbound phone calls to businesses straight from your coding agent.",
   "repository": { "url": "https://github.com/SpekoAI/mcp-dev-calls", "source": "github" },
-  "version": "0.1.1",
+  "version": "0.2.1",
   "websiteUrl": "https://speko.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@spekoai/mcp-calls",
-      "version": "0.1.1",
+      "version": "0.2.1",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         {

package/skills/speko-calls/SKILL.md

@@ -6,7 +6,6 @@ description: >-
   hours/availability/pricing, or chase an order. Teaches the lookup → dial_token →
   make_call workflow, the mandatory AI disclosure, the business-lines-only + quiet-hours
   rails, and how to report the call OUTCOME honestly. Not for personal/consumer calls.
-disable-model-invocation: true
 ---
 
 # Speko Calls — placing real, disclosed business calls
@@ -32,7 +31,7 @@ way to pass a raw phone number — that's a safety boundary, not a limitation.
 - **Confirm the business and the objective with the user.** A call is a real-world action.
 - Pass the user's name as `caller_name` (the disclosure says "on behalf of `<caller_name>`").
 - Write `objective` as ONE clear transactional goal:
-  *"Ask if there's a table for 4 at 8pm tonight and book it under Amirlan."*
+  *"Ask if there's a table for 4 at 8pm tonight and book it under John."*
 
 ## The rails (enforced server-side — you cannot override them)
 - **Business lines only** — mobiles are blocked (carrier line-type check).
@@ -49,10 +48,18 @@ objective as a single transactional question and retry, or tell the user it isn'
   on the wire (no telephony leg), it returns **`not_connected`** — do **not** report that
   as success. Run `check_call_readiness` and tell the user the deployment's outbound
   trunk / caller-ID may need setup.
-- The `OUTCOME:` line is the answer (e.g. *"table for 4 at 8pm, booked under Amirlan"*).
+- The `OUTCOME:` line is the answer (e.g. *"table for 4 at 8pm, booked under John"*).
   Relay it plainly and offer the transcript.
 
+## Personal calls — `call_number` (opt-in)
+If the user wants to call a **specific number they give you** (e.g. a friend), use
+`call_number(phone_number, objective, caller_name, recipient_name?)` — not the business
+flow. It needs the operator to have set `SPEKO_ALLOW_DIRECT_DIAL=1` (if off, it returns
+how to enable it). Mobiles are allowed here; the AI disclosure, quiet hours, and no-spam
+screen still apply. Only ever call a number the user **explicitly provides and has
+consent to call** — never one you guessed. For businesses, use `lookup_business` instead.
+
 ## Don't
-- Don't invent or hardcode phone numbers — only server-minted `dial_token`s dial.
+- Don't invent or guess phone numbers — `make_call` dials only a server-minted `dial_token`; `call_number` dials only a number the user explicitly gave you.
 - Don't retry after a pre-dial rejection without fixing the objective first.
 - Don't promise a call will connect — report what actually happened.