@talqing/mcp 0.14.0 → 0.15.0

package/SKILL.md

@@ -1291,9 +1291,22 @@ recordings and cost.
 
 ## Email outbound
 
-To email a *list* rather than one person, create an **email batch**: a CSV, an
-agent task that drafts each row, a connected Resend account, and a mapping that
-says which column carries the address, the subject and the body.
+To email a *list* rather than one person, create an **email batch**: a CSV, a
+connected Resend account, and one of two writers for the emails:
+
+- **A template** — `template: {to, subject, body}`, the same email for every
+  row. `to` names the address column; `{{column}}` in the subject or body takes
+  that row's cell (bare column names, no `vars.` prefix), HTML-escaped when
+  `body_format` is `html`. No task, no drafting, no cost: the batch is created
+  `drafted` and every row is ready to review at once. A row whose placeholder
+  cell is blank is `draft_failed` ("first_name is empty") until the cell is
+  filled with `patch_email_batch_recipient`. Before creating one, offer
+  `send_test_email` — it mails the filled template to the signed-in user only.
+- **An agent task** — `task_id` + `field_map`, when each email should be
+  written for its row (research, personalization). The rest of this section
+  is mostly about this kind.
+
+Pick the template when the wording is fixed and only names/fields change.
 
 **Four things to say before creating one.** A user who discovers any of them
 afterwards will not forgive us:
@@ -1303,7 +1316,7 @@ afterwards will not forgive us:
   opted in. This runs on *their* Resend account under *their* agreement.
 - **Creating a batch only drafts.** Nothing is sent until someone creates a
   send — and a send of every row mails drafts nobody reviewed.
-- **Every row runs the task's CURRENT PUBLISHED version**, re-read as drafting
+- **In a task batch, every row runs the task's CURRENT PUBLISHED version**, re-read as drafting
   goes, so publishing mid-batch changes every row drafted after that moment. Which version
   wrote which rows is on the batch as `drafted_versions`, and
   `redraft_email_batch_recipients` with `selection: "stale_version"` is how the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talqing/mcp",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "MCP server for building Talqing AI voice, video and text agents from Claude Code, Codex, or any MCP client.",
   "license": "MIT",
   "homepage": "https://talqing.com",

package/tools.json

@@ -1998,7 +1998,28 @@
       "role": "read"
     },
     {
-      "description": "Create an email batch: a list, an agent task that drafts each row, and a connected Resend account to send from.",
+      "description": "Fill a template from `vars` and email it to yourself (the signed-in user) only.",
+      "method": "POST",
+      "name": "send_test_email",
+      "parameters": {
+        "additionalProperties": false,
+        "description": "Arguments not inlined: call describe_function('send_test_email').",
+        "properties": {
+          "body": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "body"
+        ],
+        "type": "object"
+      },
+      "path": "/v1/email/test-sends",
+      "read_only": false,
+      "role": "write"
+    },
+    {
+      "description": "Create an email batch: a list, what writes each email, and a connected Resend account to send from.",
       "method": "POST",
       "name": "create_email_batch",
       "parameters": {