@oneshot-agent/mcp-server 0.24.1 → 0.27.0

package/README.md

@@ -96,7 +96,7 @@ Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return p
 ## Remote (hosted)
 
 Clients that run in someone else's cloud — Grok Bot, hosted runners — cannot spawn this
-server and must not hold a wallet key. For them OneShot hosts the same 63 tools over
+server and must not hold a wallet key. For them OneShot hosts the same 73 tools over
 Streamable HTTP at **`https://win.oneshotagent.com/mcp`**, authenticated with an
 **agent access token** and billed to the agent's credit balance:
 
@@ -136,6 +136,16 @@ instead of the wallet variables for a credits-only session on your own machine.
 | `oneshot_sms_inbox_list` | List received SMS messages |
 | `oneshot_sms_inbox_get` | Get a specific SMS message |
 
+### Inbound voice
+
+| Tool | Description |
+|------|-------------|
+| `oneshot_voice_number_provision` | Get the agent a phone number (existing one free; new one charges the registration fee from credits) |
+| `oneshot_voice_numbers` | List the agent's phone numbers |
+| `oneshot_voice_inbound_set` | Make a number answer its own calls (wallet session only) |
+| `oneshot_voice_inbound_disable` | Stop answering calls to a number (wallet session only) |
+| `oneshot_voice_inbound_calls` | List inbound calls, or one call with transcript |
+
 ### Research & Enrichment
 
 | Tool | Description |

package/dist/index.js

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

package/dist/tools/approvals.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
+export declare const approvalCreateTool: Tool;
+export declare function handleApprovalCreate(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").Approval>;
+export declare const approvalGetTool: Tool;
+export declare function handleApprovalGet(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").Approval>;
+export declare const approvalListTool: Tool;
+export declare function handleApprovalList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").Approval[]>;
+export declare const approvalCancelTool: Tool;
+export declare function handleApprovalCancel(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").Approval>;
+export declare const actionPolicyGetTool: Tool;
+export declare function handleActionPolicyGet(agent: OneShot, _args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ActionPolicy | null>;

package/dist/tools/approvals.js

@@ -0,0 +1,81 @@
+// Approvals: ask a named human, read decisions, and read (never loosen) the
+// action policy. Setting the policy is deliberately not exposed here — an
+// agent that could edit its own policy would make the policy meaningless.
+export const approvalCreateTool = {
+    name: "oneshot_approval_create",
+    description: "Ask a named human to approve or deny something before you do it. They get a one-tap link by email or SMS. " +
+        "Returns an approval with status 'pending'; poll oneshot_approval_get for the decision. Unanswered = denied at expiry. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action_summary: { type: "string", description: "What the human is deciding, in one line (max 2000 chars)" },
+            approver_email: { type: "string", description: "Approver's email address" },
+            approver_phone: { type: "string", description: "Approver's phone number, E.164 (e.g. +14155551234)" },
+            preview: { type: "object", description: "Details shown to the approver (optional, up to 4000 characters as JSON)" },
+            expires_in_seconds: { type: "number", description: "Seconds until it expires unanswered (default 3600, max 604800)" },
+        },
+        required: ["action_summary"],
+    },
+};
+export async function handleApprovalCreate(agent, args) {
+    return agent.approvals.create({
+        action_summary: args.action_summary,
+        approver: {
+            ...(args.approver_email ? { email: args.approver_email } : {}),
+            ...(args.approver_phone ? { phone: args.approver_phone } : {}),
+        },
+        ...(args.preview ? { preview: args.preview } : {}),
+        ...(args.expires_in_seconds ? { expires_in_seconds: args.expires_in_seconds } : {}),
+    });
+}
+export const approvalGetTool = {
+    name: "oneshot_approval_get",
+    description: "Read one approval: status is pending, approved, denied, expired, cancelled, or consumed (an approved held call already ran). " +
+        "When a paid call failed with approval_required, poll this with its approval_id; once approved, retry the same call with approval_id. Free.",
+    inputSchema: {
+        type: "object",
+        properties: { approval_id: { type: "string", description: "The approval id (appr_...)" } },
+        required: ["approval_id"],
+    },
+};
+export async function handleApprovalGet(agent, args) {
+    return agent.approvals.get(args.approval_id);
+}
+export const approvalListTool = {
+    name: "oneshot_approval_list",
+    description: "List this agent's approvals, newest first, optionally filtered by status. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            status: { type: "string", enum: ["pending", "approved", "denied", "expired", "cancelled", "consumed"] },
+            limit: { type: "number", description: "Max results (default 50, max 200)" },
+        },
+    },
+};
+export async function handleApprovalList(agent, args) {
+    return agent.approvals.list({
+        status: args.status,
+        limit: args.limit,
+    });
+}
+export const approvalCancelTool = {
+    name: "oneshot_approval_cancel",
+    description: "Withdraw a pending approval you no longer need. Free.",
+    inputSchema: {
+        type: "object",
+        properties: { approval_id: { type: "string", description: "The approval id (appr_...)" } },
+        required: ["approval_id"],
+    },
+};
+export async function handleApprovalCancel(agent, args) {
+    return agent.approvals.cancel(args.approval_id);
+}
+export const actionPolicyGetTool = {
+    name: "oneshot_action_policy",
+    description: "Read-only: this agent's action policy — which email/SMS/voice/commerce calls run, are denied, or need a human approval " +
+        "(rules, approver channel, timeout). The policy is set by the operator from a wallet session and cannot be changed from here. Free.",
+    inputSchema: { type: "object", properties: {} },
+};
+export async function handleActionPolicyGet(agent, _args) {
+    return agent.policy.get();
+}

package/dist/tools/commerce.js

@@ -50,6 +50,10 @@ export const commerceBuyTool = {
                 type: "string",
                 description: "Product variant ID (optional)",
             },
+            approval_id: {
+                type: "string",
+                description: "Only when retrying a call the action policy held: the approval_id from the approval_required error, once a human approved it. The call then runs once.",
+            },
         },
         required: ["product_url", "shipping_address"],
     },
@@ -77,6 +81,7 @@ export async function handleCommerceBuy(agent, args) {
             phone: shippingAddress.phone,
         },
         quantity: args.quantity,
+        approvalId: args.approval_id,
         variant_id: args.variant_id,
     });
 }

package/dist/tools/email.js

@@ -50,6 +50,10 @@ export const emailTool = {
                 },
                 description: "File attachments (optional)",
             },
+            approval_id: {
+                type: "string",
+                description: "Only when retrying a call the action policy held: the approval_id from the approval_required error, once a human approved it. The call then runs once.",
+            },
         },
         required: ["body"],
     },
@@ -65,5 +69,6 @@ export async function handleEmail(agent, args) {
         from_name: args.from_name,
         mailbox_mode: args.mailbox_mode,
         attachments: args.attachments,
+        approvalId: args.approval_id,
     });
 }

package/dist/tools/index.js

@@ -1,5 +1,6 @@
 import { emailTool, handleEmail } from "./email.js";
 import { voiceTool, handleVoice } from "./voice.js";
+import { voiceNumberProvisionTool, voiceNumbersTool, voiceInboundSetTool, voiceInboundDisableTool, voiceInboundCallsTool, handleVoiceNumberProvision, handleVoiceNumbers, handleVoiceInboundSet, handleVoiceInboundDisable, handleVoiceInboundCalls, } from "./voice-inbound.js";
 import { smsTool, handleSms } from "./sms.js";
 import { researchTool, handleResearch } from "./research.js";
 import { peopleSearchTool, handlePeopleSearch } from "./people.js";
@@ -9,6 +10,7 @@ import { inboxListTool, inboxGetTool, handleInboxList, handleInboxGet } from "./
 import { smsInboxListTool, smsInboxGetTool, handleSmsInboxList, handleSmsInboxGet } from "./sms-inbox.js";
 import { notificationsTool, markReadTool, handleNotifications, handleMarkRead } from "./notifications.js";
 import { getBalanceTool, budgetStatusTool, handleGetBalance, handleBudgetStatus } from "./wallet.js";
+import { approvalCreateTool, approvalGetTool, approvalListTool, approvalCancelTool, actionPolicyGetTool, handleApprovalCreate, handleApprovalGet, handleApprovalList, handleApprovalCancel, handleActionPolicyGet, } from "./approvals.js";
 import { buildTool, updateBuildTool, handleBuild, handleUpdateBuild } from "./build.js";
 import { browserTool, browserCreateProfileTool, browserListProfilesTool, browserDeleteProfileTool, handleBrowser, handleBrowserCreateProfile, handleBrowserListProfiles, handleBrowserDeleteProfile } from "./browser.js";
 import { webSearchTool, handleWebSearch } from "./search.js";
@@ -32,6 +34,12 @@ export const tools = [
     inboxGetTool,
     smsInboxListTool,
     smsInboxGetTool,
+    // Inbound voice
+    voiceNumberProvisionTool,
+    voiceNumbersTool,
+    voiceInboundSetTool,
+    voiceInboundDisableTool,
+    voiceInboundCallsTool,
     // Research & Enrichment
     researchTool,
     peopleSearchTool,
@@ -97,6 +105,12 @@ export const tools = [
     markReadTool,
     getBalanceTool,
     budgetStatusTool,
+    // Approvals
+    approvalCreateTool,
+    approvalGetTool,
+    approvalListTool,
+    approvalCancelTool,
+    actionPolicyGetTool,
 ];
 // Tool handlers map
 const handlers = {
@@ -109,6 +123,12 @@ const handlers = {
     "oneshot_inbox_get": handleInboxGet,
     "oneshot_sms_inbox_list": handleSmsInboxList,
     "oneshot_sms_inbox_get": handleSmsInboxGet,
+    // Inbound voice
+    "oneshot_voice_number_provision": handleVoiceNumberProvision,
+    "oneshot_voice_numbers": handleVoiceNumbers,
+    "oneshot_voice_inbound_set": handleVoiceInboundSet,
+    "oneshot_voice_inbound_disable": handleVoiceInboundDisable,
+    "oneshot_voice_inbound_calls": handleVoiceInboundCalls,
     // Research & Enrichment
     "oneshot_research": handleResearch,
     "oneshot_people_search": handlePeopleSearch,
@@ -175,6 +195,12 @@ const handlers = {
     "oneshot_mark_notification_read": handleMarkRead,
     "oneshot_get_balance": handleGetBalance,
     "oneshot_budget_status": handleBudgetStatus,
+    // Approvals
+    "oneshot_approval_create": handleApprovalCreate,
+    "oneshot_approval_get": handleApprovalGet,
+    "oneshot_approval_list": handleApprovalList,
+    "oneshot_approval_cancel": handleApprovalCancel,
+    "oneshot_action_policy": handleActionPolicyGet,
 };
 export async function handleToolCall(agent, toolName, args) {
     const handler = handlers[toolName];

package/dist/tools/sms.js

@@ -12,6 +12,10 @@ export const smsTool = {
                 type: "string",
                 description: "SMS message content (max 1600 chars, 160 chars per segment)",
             },
+            approval_id: {
+                type: "string",
+                description: "Only when retrying a call the action policy held: the approval_id from the approval_required error, once a human approved it. The call then runs once.",
+            },
         },
         required: ["to_number", "message"],
     },
@@ -20,5 +24,6 @@ export async function handleSms(agent, args) {
     return agent.sms({
         to_number: args.to_number,
         message: args.message,
+        approvalId: args.approval_id,
     });
 }

package/dist/tools/voice-inbound.d.ts

@@ -0,0 +1,16 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
+export declare const voiceNumberProvisionTool: Tool;
+export declare const voiceNumbersTool: Tool;
+export declare const voiceInboundSetTool: Tool;
+export declare const voiceInboundDisableTool: Tool;
+export declare const voiceInboundCallsTool: Tool;
+export declare function handleVoiceNumberProvision(agent: OneShot): Promise<import("@oneshot-agent/sdk").ProvisionedVoiceNumber>;
+export declare function handleVoiceNumbers(agent: OneShot): Promise<{
+    numbers: import("@oneshot-agent/sdk").VoiceNumber[];
+}>;
+export declare function handleVoiceInboundSet(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").InboundVoiceConfigResult>;
+export declare function handleVoiceInboundDisable(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").InboundVoiceConfigResult>;
+export declare function handleVoiceInboundCalls(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").InboundCall | {
+    calls: import("@oneshot-agent/sdk").InboundCall[];
+}>;

package/dist/tools/voice-inbound.js

@@ -0,0 +1,102 @@
+export const voiceNumberProvisionTool = {
+    name: "oneshot_voice_number_provision",
+    description: "Get this agent a phone number without placing a call, so it can answer calls (then use oneshot_voice_inbound_set). " +
+        "Returns the existing number for free; otherwise buys one and charges the one-time phone registration fee from prepaid credits. " +
+        "Fails with 402 and buys nothing when credits are too low. Requires a wallet session (not available with an agent access token).",
+    inputSchema: { type: "object", properties: {} },
+};
+export const voiceNumbersTool = {
+    name: "oneshot_voice_numbers",
+    description: "List this agent's phone numbers and whether each answers inbound calls. Free. A number comes from oneshot_voice_number_provision or the agent's first outbound voice call.",
+    inputSchema: { type: "object", properties: {} },
+};
+export const voiceInboundSetTool = {
+    name: "oneshot_voice_inbound_set",
+    description: "Make one of the agent's numbers answer its own calls. Replaces the whole inbound config. " +
+        "During business hours the assistant follows `prompt`; after hours it takes a message, transfers, or declines. " +
+        "Calls are paid from prepaid credits per started minute and are declined when credits cannot cover the minimum fee. " +
+        "Requires a wallet session (not available with an agent access token).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            phone_number_id: { type: "string", description: "Number id from oneshot_voice_numbers" },
+            prompt: { type: "string", description: "How the assistant answers this number (max 8000 chars)" },
+            first_message: { type: "string", description: "Greeting spoken when the call connects (optional)" },
+            voice_id: { type: "string", description: "Voice id (optional)" },
+            language: { type: "string", enum: ["en", "es", "fr", "de", "pt", "it", "nl", "multi"] },
+            allowed_tools: { type: "array", items: { type: "string", enum: ["transfer_call", "end_call"] }, description: "Default: [\"end_call\"]" },
+            transfer_number: { type: "string", description: "E.164. Required with transfer_call or after_hours=transfer" },
+            business_hours: {
+                type: "object",
+                description: "Omit for always open. { timezone: 'America/New_York', windows: [{ days: ['mon',...], start: '09:00', end: '17:00' }] }",
+                properties: {
+                    timezone: { type: "string" },
+                    windows: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                days: { type: "array", items: { type: "string", enum: ["mon", "tue", "wed", "thu", "fri", "sat", "sun"] } },
+                                start: { type: "string" },
+                                end: { type: "string" },
+                            },
+                            required: ["days", "start", "end"],
+                        },
+                    },
+                },
+                required: ["timezone", "windows"],
+            },
+            after_hours: { type: "string", enum: ["take_message", "transfer", "decline"], description: "Default: take_message" },
+            after_hours_message: { type: "string", description: "What callers hear after hours (optional)" },
+            max_minutes: { type: "number", description: "1-60, default 10" },
+            webhook_url: { type: "string", description: "HTTPS URL for a signed voice.inbound.completed event after each call (optional)" },
+        },
+        required: ["phone_number_id", "prompt"],
+    },
+};
+export const voiceInboundDisableTool = {
+    name: "oneshot_voice_inbound_disable",
+    description: "Stop answering calls to one of the agent's numbers. The settings are kept, disabled. Free. Requires a wallet session.",
+    inputSchema: {
+        type: "object",
+        properties: { phone_number_id: { type: "string", description: "Number id from oneshot_voice_numbers" } },
+        required: ["phone_number_id"],
+    },
+};
+export const voiceInboundCallsTool = {
+    name: "oneshot_voice_inbound_calls",
+    description: "List inbound calls to the agent's numbers, newest first, with caller, summary and charge. Free. Pass call_id for one call with its transcript.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            call_id: { type: "string", description: "Return this one call, with transcript" },
+            limit: { type: "number", description: "Max calls (default 50, max 100)" },
+            before: { type: "string", description: "ISO timestamp; calls created before it" },
+            phone_number_id: { type: "string", description: "Only calls to this number" },
+            include_transcript: { type: "boolean", description: "Include transcripts in the list" },
+        },
+    },
+};
+export async function handleVoiceNumberProvision(agent) {
+    return agent.provisionVoiceNumber();
+}
+export async function handleVoiceNumbers(agent) {
+    return agent.voiceNumbers();
+}
+export async function handleVoiceInboundSet(agent, args) {
+    const { phone_number_id, ...config } = args;
+    return agent.setInboundVoice(phone_number_id, config);
+}
+export async function handleVoiceInboundDisable(agent, args) {
+    return agent.disableInboundVoice(args.phone_number_id);
+}
+export async function handleVoiceInboundCalls(agent, args) {
+    if (typeof args.call_id === "string" && args.call_id)
+        return agent.inboundCall(args.call_id);
+    return agent.inboundCalls({
+        limit: args.limit,
+        before: args.before,
+        phone_number_id: args.phone_number_id,
+        include_transcript: args.include_transcript === true,
+    });
+}

package/dist/tools/voice.js

@@ -24,6 +24,10 @@ export const voiceTool = {
                 type: "number",
                 description: "Maximum call duration in minutes (1-30, optional)",
             },
+            approval_id: {
+                type: "string",
+                description: "Only when retrying a call the action policy held: the approval_id from the approval_required error, once a human approved it. The call then runs once.",
+            },
         },
         required: ["target_number", "objective"],
     },
@@ -35,5 +39,6 @@ export async function handleVoice(agent, args) {
         context: args.context,
         caller_persona: args.caller_persona,
         max_duration_minutes: args.max_duration_minutes,
+        approvalId: args.approval_id,
     });
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.24.1",
-  "description": "MCP server for OneShot - 63 tools for AI agents",
+  "version": "0.27.0",
+  "description": "MCP server for OneShot - 73 tools for AI agents",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@coinbase/cdp-sdk": "1.45.0",
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@oneshot-agent/sdk": "^0.38.1",
+    "@oneshot-agent/sdk": "^0.41.0",
     "zod": "3.25.76"
   },
   "devDependencies": {