@oneshot-agent/mcp-server 0.14.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.14.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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.14.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.22.0",
+    "@oneshot-agent/sdk": "^0.23.0",
     "zod": "3.25.76"
   },
   "devDependencies": {