@oneshot-agent/mcp-server 0.13.0 → 0.15.0

package/README.md

@@ -196,6 +196,8 @@ Use oneshot_email:
 - from_name: "Jane Doe"      (optional display name → "Jane Doe <jane@domain>")
 - from_mailbox: "jane"       (optional local-part, defaults to "agent")
 - from_domain: "acme.com"    (optional, defaults to "oneshotagent.com")
+- mailbox_mode: "mailbox"    (optional, 'relay' (default) | 'mailbox' — dedicated per-address
+                              mailbox; only when first provisioning a new from_domain)
 ```
 
 ### Make a Phone Call

package/dist/index.js

@@ -26,7 +26,7 @@ async function main() {
     // Create MCP server
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.13.0", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.15.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/dist/tools/analytics.d.ts

@@ -4,7 +4,9 @@ export declare const spendBreakdownTool: Tool;
 export declare const rocsTool: Tool;
 export declare const receiptsListTool: Tool;
 export declare const tagReceiptValueTool: Tool;
+export declare const rocsByGoalTool: Tool;
 export declare function handleSpendBreakdown(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SpendBreakdown>;
 export declare function handleRocs(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").RoCSResult>;
 export declare function handleReceiptsList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ReceiptsListResult>;
+export declare function handleRocsByGoal(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").RoCSByGoalResult>;
 export declare function handleTagReceiptValue(agent: OneShot, args: Record<string, unknown>): Promise<void>;

package/dist/tools/analytics.js

@@ -35,20 +35,36 @@ export const receiptsListTool = {
 };
 export const tagReceiptValueTool = {
     name: "oneshot_tag_receipt_value",
-    description: "Tag a receipt with the business value it generated (revenue, lead, saved-time, etc.) to feed RoCS. " +
-        "Identify the receipt by its receipt_id (rcpt_…) or by the request_id returned from the original tool call. Free.",
+    description: "Tag business value (revenue, lead, conversion, savings, engagement) to feed RoCS. " +
+        "Address it three ways: receipt_id (rcpt_…), request_id from the original tool call, " +
+        "or goal_id — a correlation key that attributes a whole cadence's outcome (a closed deal " +
+        "across the intro email + follow-ups + find/verify/enrich calls sharing decisionContext.goalId) " +
+        "in one call. Read goal-level rollups back with oneshot_rocs_by_goal. Free.",
     inputSchema: {
         type: "object",
         properties: {
-            receipt_id: { type: "string", description: "Receipt id (rcpt_…) to tag. Provide this or request_id." },
-            request_id: { type: "string", description: "request_id/job_id from the original tool call. Provide this or receipt_id." },
-            type: { type: "string", description: "Value type (e.g. 'revenue', 'lead', 'saved_time')" },
+            receipt_id: { type: "string", description: "Receipt id (rcpt_…) to tag. Provide one of receipt_id / request_id / goal_id." },
+            request_id: { type: "string", description: "request_id/job_id from the original tool call." },
+            goal_id: { type: "string", description: "Cadence correlation key (decisionContext.goalId). Attributes the outcome to the whole group at once." },
+            type: { type: "string", description: "Value type: 'revenue', 'lead', 'conversion', 'savings', or 'engagement'" },
             amount: { type: "number", description: "Value amount (e.g. USD)" },
             label: { type: "string", description: "Optional human label for the value" },
         },
         required: ["type"],
     },
 };
+export const rocsByGoalTool = {
+    name: "oneshot_rocs_by_goal",
+    description: "Per-cadence RoCS rollup: spend (receipts) vs. value (outcomes) grouped by goal_id. " +
+        "Answers 'what did this cadence cost vs. earn' in one query. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            period: { type: "number", description: "Lookback window in days" },
+            goal_id: { type: "string", description: "Optional — restrict the rollup to a single cadence correlation key." },
+        },
+    },
+};
 export async function handleSpendBreakdown(agent, args) {
     return agent.spendBreakdown({ period: args.period });
 }
@@ -65,8 +81,18 @@ export async function handleReceiptsList(agent, args) {
         until: args.until,
     });
 }
+export async function handleRocsByGoal(agent, args) {
+    return agent.rocsByGoal({
+        period: args.period,
+        goalId: args.goal_id,
+    });
+}
 export async function handleTagReceiptValue(agent, args) {
-    return agent.tagReceiptValue({ receiptId: args.receipt_id, requestId: args.request_id }, {
+    return agent.tagReceiptValue({
+        receiptId: args.receipt_id,
+        requestId: args.request_id,
+        goalId: args.goal_id,
+    }, {
         type: args.type,
         amount: args.amount,
         label: args.label,

package/dist/tools/domains.js

@@ -1,6 +1,6 @@
 export const listDomainsTool = {
     name: "oneshot_list_domains",
-    description: "List the agent's sending domains with pool status, warmup score, and daily send limits. Free.",
+    description: "List the agent's sending domains. Each has default_from (canonical default sender, e.g. agent@domain — billed like any address on its first send), addresses[] (mailboxes already provisioned — {address, status, warmup_state}; empty means none yet), pool_status (rotation eligibility: active|paused|removed), warmup_state (reputation health: warming|warmed|degraded), pause_reason (warming|low_reputation|manual|null), warmup_score, and daily send limits. A domain can be paused AND warming — reputation pauses auto-recover once warmed; manual pauses need a resume. Free.",
     inputSchema: { type: "object", properties: {} },
 };
 export const pauseDomainTool = {

package/dist/tools/email.js

@@ -26,12 +26,17 @@ export const emailTool = {
             },
             from_mailbox: {
                 type: "string",
-                description: "Sender mailbox / local-part (optional, defaults to 'agent', i.e. agent@from_domain)",
+                description: "Sender mailbox / local-part (optional, defaults to 'agent', i.e. agent@from_domain). You can use any local-part — a new address is auto-provisioned on first use (starts unwarmed, warms over time). The FIRST send from any address — including the default 'agent@' — adds a one-time mailbox_provisioning_fee to the quote; it's free only once that address is already provisioned (active). See the domains list for each domain's default_from and existing addresses.",
             },
             from_name: {
                 type: "string",
                 description: "Display name shown to the recipient (optional), e.g. 'Jane Doe' renders as 'Jane Doe <jane@domain>'",
             },
+            mailbox_mode: {
+                type: "string",
+                enum: ["relay", "mailbox"],
+                description: "How this domain sends (optional, defaults to 'relay'). 'relay' = header send, no per-address mailbox, no mailbox fee. 'mailbox' = a real dedicated mailbox per address (better deliverability + per-address warmup); each new address adds a one-time mailbox_provisioning_fee to the quote. Only applies when a domain is first set up — use it on a new from_domain; an existing domain keeps the mode it was created with.",
+            },
             attachments: {
                 type: "array",
                 items: {
@@ -58,6 +63,7 @@ export async function handleEmail(agent, args) {
         from_domain: args.from_domain,
         from_mailbox: args.from_mailbox,
         from_name: args.from_name,
+        mailbox_mode: args.mailbox_mode,
         attachments: args.attachments,
     });
 }

package/dist/tools/index.js

@@ -17,7 +17,7 @@ import { deepResearchPersonTool, socialProfilesTool, articleSearchTool, personNe
 import { companySearchTool, enrichCompanyTool, handleCompanySearch, handleEnrichCompany } from "./company.js";
 import { computeTool, computeStatusTool, computeTasksTool, computeCancelTool, computeRespondTool, handleCompute, handleComputeStatus, handleComputeTasks, handleComputeCancel, handleComputeRespond } from "./compute.js";
 import { listDomainsTool, pauseDomainTool, resumeDomainTool, handleListDomains, handlePauseDomain, handleResumeDomain } from "./domains.js";
-import { spendBreakdownTool, rocsTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
+import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
 // All available tools
 export const tools = [
     // Communication
@@ -70,6 +70,7 @@ export const tools = [
     // Analytics
     spendBreakdownTool,
     rocsTool,
+    rocsByGoalTool,
     receiptsListTool,
     tagReceiptValueTool,
     // Account
@@ -129,6 +130,7 @@ const handlers = {
     // Analytics
     "oneshot_spend_breakdown": handleSpendBreakdown,
     "oneshot_rocs": handleRocs,
+    "oneshot_rocs_by_goal": handleRocsByGoal,
     "oneshot_receipts_list": handleReceiptsList,
     "oneshot_tag_receipt_value": handleTagReceiptValue,
     // Account

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "MCP server for OneShot - commercial actions for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@coinbase/cdp-sdk": "1.45.0",
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@oneshot-agent/sdk": "^0.21.0",
+    "@oneshot-agent/sdk": "^0.23.0",
     "zod": "3.25.76"
   },
   "devDependencies": {