@oneshot-agent/mcp-server 0.13.0 → 0.14.0

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.14.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/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.14.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.22.0",
     "zod": "3.25.76"
   },
   "devDependencies": {