@oneshot-agent/mcp-server 0.29.0 → 0.30.0

package/README.md

@@ -226,7 +226,7 @@ instead of the wallet variables for a credits-only session on your own machine.
 | Tool | Description |
 |------|-------------|
 | `oneshot_spend_breakdown` | Spend by tool/category over a period |
-| `oneshot_rocs` | Return on Compute Spend analytics |
+| `oneshot_return_on_spend` | Return on spend: cost vs. value produced |
 | `oneshot_receipts_list` | List spend receipts |
 | `oneshot_tag_receipt_value` | Tag a receipt with the value it generated |
 

package/dist/index.js

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

package/dist/tools/analytics.js

@@ -9,8 +9,8 @@ export const spendBreakdownTool = {
     },
 };
 export const rocsTool = {
-    name: "oneshot_rocs",
-    description: "Get Return on Compute Spend (RoCS) analytics for the agent over a period. Free.",
+    name: "oneshot_return_on_spend",
+    description: "Get the agent's return on spend over a period: what its tool calls cost compared with the value they produced (return on compute spend). Free.",
     inputSchema: {
         type: "object",
         properties: {
@@ -39,7 +39,7 @@ export const tagReceiptValueTool = {
         "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.",
+        "in one call. Read goal-level rollups back with oneshot_return_on_spend_by_goal. Free.",
     inputSchema: {
         type: "object",
         properties: {
@@ -54,9 +54,9 @@ export const tagReceiptValueTool = {
     },
 };
 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.",
+    name: "oneshot_return_on_spend_by_goal",
+    description: "Return on spend per goal: what each goal cost (receipts) compared with the value it produced (tagged outcomes), grouped by goal_id. " +
+        "Answers 'what did this goal cost vs. earn' in one query. Free.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/annotations.js

@@ -64,7 +64,7 @@ export const TOOL_ANNOTATIONS = {
     // LinkedIn
     oneshot_linkedin_connect: write("Connect LinkedIn", OPEN),
     oneshot_linkedin_accounts: read("List LinkedIn accounts", OWN),
-    oneshot_linkedin_sync: read("Sync LinkedIn messages", OPEN),
+    oneshot_linkedin_sync: write("Sync LinkedIn messages", OPEN), // paid; imports history into the account
     oneshot_linkedin_conversations: read("List LinkedIn conversations", OWN),
     oneshot_linkedin_messages: read("Read LinkedIn messages", OWN),
     oneshot_linkedin_reply: write("Send a LinkedIn message", OPEN),
@@ -78,8 +78,8 @@ export const TOOL_ANNOTATIONS = {
     oneshot_resume_domain: write("Resume a sending domain", OWN),
     // Analytics
     oneshot_spend_breakdown: read("Show spending", OWN),
-    oneshot_rocs: read("Show return on spend", OWN),
-    oneshot_rocs_by_goal: read("Show return on spend by goal", OWN),
+    oneshot_return_on_spend: read("Show return on spend", OWN),
+    oneshot_return_on_spend_by_goal: read("Show return on spend by goal", OWN),
     oneshot_receipts_list: read("List receipts", OWN),
     oneshot_tag_receipt_value: write("Tag a receipt's value", OWN),
     // Account

package/dist/tools/compute.js

@@ -34,6 +34,15 @@ export const computeTool = {
                 description: "Make this a recurring goal (cron-style schedule object)",
                 additionalProperties: true,
             },
+            approvals: {
+                type: "object",
+                description: "Enforced approvals: any single tool call costing more than spend_over_usdc, or using a listed tool, waits for the goal owner's approval (oneshot_compute_respond on its human_approval task) before anything is spent. An approval covers exactly one call: that tool, those params, at most that amount.",
+                properties: {
+                    spend_over_usdc: { type: "number", minimum: 0, description: "Hold any single call costing more than this (USDC)" },
+                    tools: { type: "array", items: { type: "string" }, description: 'Always hold these tools, e.g. ["commerce_buy", "physical_mail", "voice", "soul_hire"]' },
+                },
+                additionalProperties: false,
+            },
         },
         required: ["objective"],
     },
@@ -130,6 +139,7 @@ export async function handleCompute(agent, args) {
         soul_slug: args.soul_slug,
         soul_service_slug: args.soul_service_slug,
         schedule: args.schedule,
+        approvals: args.approvals,
     });
 }
 export async function handleComputeStatus(agent, args) {

package/dist/tools/index.js

@@ -195,8 +195,8 @@ const handlers = {
     "oneshot_resume_domain": handleResumeDomain,
     // Analytics
     "oneshot_spend_breakdown": handleSpendBreakdown,
-    "oneshot_rocs": handleRocs,
-    "oneshot_rocs_by_goal": handleRocsByGoal,
+    "oneshot_return_on_spend": handleRocs,
+    "oneshot_return_on_spend_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.29.0",
+  "version": "0.30.0",
   "description": "MCP server for OneShot - 73 tools 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.43.0",
+    "@oneshot-agent/sdk": "^0.44.0",
     "zod": "3.25.76"
   },
   "devDependencies": {