@oneshot-agent/mcp-server 0.17.3 → 0.20.0

package/README.md

@@ -10,7 +10,7 @@ npm install -g @oneshot-agent/mcp-server
 
 ## Configuration
 
-The server supports two auth methods: **CDP Wallet** (recommended, no private keys in config) or a raw private key.
+The server supports three auth methods: **CDP Wallet** (recommended, no private keys in config), a raw private key, or an **access token** (credits-only session, no key at all — see Remote below).
 
 ### Environment Variables
 
@@ -20,6 +20,7 @@ The server supports two auth methods: **CDP Wallet** (recommended, no private ke
 | `CDP_API_KEY_SECRET` | Option A | Coinbase CDP API key secret |
 | `CDP_WALLET_SECRET` | Option A | Coinbase CDP wallet secret |
 | `ONESHOT_WALLET_PRIVATE_KEY` | Option B | Raw private key for signing payments |
+| `ONESHOT_ACCESS_TOKEN` | Option C | Agent access token (`oneshot_…`): credits-only session, cannot be combined with `ONESHOT_BUDGET_*` |
 | `ONESHOT_BUDGET_DAILY` | No | Max USDC the agent may spend per UTC day (spend budget, enforced server-side) |
 | `ONESHOT_BUDGET_PER_TRANSACTION` | No | Max USDC for any single call |
 | `ONESHOT_BUDGET_ALERT_AT` | No | Fraction of the daily budget that triggers a warning (default 0.8) |
@@ -92,6 +93,30 @@ Get CDP credentials at [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/a
 
 Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return private, per-agent data. The server wraps the OneShot TypeScript SDK, which automatically signs a short-lived **EIP-712 read proof** (`x-agent-proof`) on each read so the API can verify you control the `X-Agent-ID` wallet. No configuration needed — this ships via `@oneshot-agent/sdk >= 0.25.0` (the bundled dependency). Read-proof verification is rolling out in log-only mode server-side, so older callers keep working until enforcement is enabled.
 
+## 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 50 tools over
+Streamable HTTP at **`https://win.oneshotagent.com/mcp`**, authenticated with an
+**agent access token** and billed to the agent's credit balance:
+
+```json
+{
+  "mcpServers": {
+    "oneshot": {
+      "url": "https://win.oneshotagent.com/mcp",
+      "headers": { "Authorization": "Bearer ${env:ONESHOT_ACCESS_TOKEN}" }
+    }
+  }
+}
+```
+
+Mint a token from a wallet session with `agent.createAccessToken()` (`@oneshot-agent/sdk`
+≥ 0.33.0). Setup and billing details: https://docs.oneshotagent.com/sdk/remote-mcp
+
+The same token also works with this local server (≥ 0.20.0): set `ONESHOT_ACCESS_TOKEN`
+instead of the wallet variables for a credits-only session on your own machine.
+
 ## Available Tools
 
 ### Communication
@@ -122,6 +147,9 @@ Read tools (inbox, SMS inbox, notifications, balance, browser profiles) return p
 | `oneshot_verify_email` | Verify email deliverability |
 | `oneshot_company_search` | Search for companies by industry, size, location, etc. |
 | `oneshot_enrich_company` | Enrich a company from domain, name, LinkedIn, or ticker |
+| `oneshot_local_search` | Discover local businesses (restaurants, contractors, practices) by category × location |
+| `oneshot_local_resolve` | Business name + address → website domain, phone, status, confidence |
+| `oneshot_gov_solicitations` | Federal Sources Sought / Presolicitation notices by NAICS with the contracting officer's contact |
 
 ### Person Intelligence
 
@@ -204,8 +232,9 @@ Use oneshot_email:
 - subject: "Hello from AI"
 - body: "<h1>Hello!</h1><p>This email was sent by an AI agent.</p>"
 - 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")
+- from_mailbox: "jane"       (optional local-part, defaults to "agent"; requires from_domain)
+- from_domain: "acme.com"    (optional, must be a domain you own; omit both from_domain and
+                              from_mailbox to rotate across your warmed domains)
 - mailbox_mode: "mailbox"    (optional, 'relay' (default) | 'mailbox' — dedicated per-address
                               mailbox; only when first provisioning a new from_domain)
 ```

package/dist/index.js

@@ -7,6 +7,7 @@ import { tools, handleToolCall } from "./tools/index.js";
 import { budgetConfigFromEnv } from "./budget-env.js";
 const CDP_KEY_ID = process.env.CDP_API_KEY_ID;
 const PRIVATE_KEY = process.env.ONESHOT_WALLET_PRIVATE_KEY;
+const ACCESS_TOKEN = process.env.ONESHOT_ACCESS_TOKEN;
 async function initAgent() {
     let budget;
     try {
@@ -19,6 +20,19 @@ async function initAgent() {
     }
     if (budget.budgets)
         console.error(`Spend budget: ${JSON.stringify(budget.budgets)}`);
+    if (ACCESS_TOKEN) {
+        // Option C: agent access token — credits-only, no key on this machine.
+        // Budgets are read-only for a token (a cap the token could raise is not
+        // a cap), so ONESHOT_BUDGET_* alongside it is a misconfiguration, not
+        // something to silently drop.
+        if (budget.budgets || budget.alerts) {
+            console.error("Error: ONESHOT_BUDGET_* cannot be combined with ONESHOT_ACCESS_TOKEN — budgets are read-only\n" +
+                "       for access-token sessions. Set them from a wallet session (SDK budgets config or the API).");
+            process.exit(1);
+        }
+        console.error("Using access token (credits-only session)");
+        return OneShot.create({ accessToken: ACCESS_TOKEN });
+    }
     if (CDP_KEY_ID) {
         // Preferred: Coinbase CDP Server Wallet (no private key exposure)
         console.error("Using Coinbase CDP wallet");
@@ -28,8 +42,8 @@ async function initAgent() {
         // Fallback: raw private key
         return new OneShot({ privateKey: PRIVATE_KEY, ...budget });
     }
-    console.error("Error: Set CDP_API_KEY_ID + CDP_API_KEY_SECRET + CDP_WALLET_SECRET (recommended)\n" +
-        "       or ONESHOT_WALLET_PRIVATE_KEY");
+    console.error("Error: Set CDP_API_KEY_ID + CDP_API_KEY_SECRET + CDP_WALLET_SECRET (recommended),\n" +
+        "       ONESHOT_WALLET_PRIVATE_KEY, or ONESHOT_ACCESS_TOKEN (credits-only session)");
     process.exit(1);
 }
 // Start server
@@ -38,7 +52,7 @@ async function main() {
     // Create MCP server
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.17.3", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.20.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/dist/tools/analytics.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const spendBreakdownTool: Tool;
 export declare const rocsTool: Tool;
 export declare const receiptsListTool: Tool;

package/dist/tools/browser.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const browserTool: Tool;
 export declare const browserCreateProfileTool: Tool;
 export declare const browserListProfilesTool: Tool;

package/dist/tools/build.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const buildTool: Tool;
 export declare const updateBuildTool: Tool;
 export declare function handleBuild(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").BuildResult>;

package/dist/tools/commerce.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const commerceSearchTool: Tool;
 export declare const commerceBuyTool: Tool;
 export declare function handleCommerceSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CommerceSearchResult>;

package/dist/tools/company.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const companySearchTool: Tool;
 export declare const enrichCompanyTool: Tool;
 export declare function handleCompanySearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").CompanySearchResult>;

package/dist/tools/compute.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const computeTool: Tool;
 export declare const computeStatusTool: Tool;
 export declare const computeTasksTool: Tool;

package/dist/tools/domains.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const listDomainsTool: Tool;
 export declare const pauseDomainTool: Tool;
 export declare const resumeDomainTool: Tool;

package/dist/tools/email.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const emailTool: Tool;
 export declare function handleEmail(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").EmailResult>;

package/dist/tools/email.js

@@ -22,11 +22,11 @@ export const emailTool = {
             },
             from_domain: {
                 type: "string",
-                description: "Custom sender domain (optional, defaults to oneshotagent.com)",
+                description: "Domain to send from (must be one you own). Omit both from_domain and from_mailbox to rotate across your warmed domains — the chosen address comes back on the quote.",
             },
             from_mailbox: {
                 type: "string",
-                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.",
+                description: "Sender mailbox / local-part (optional, defaults to 'agent', i.e. agent@from_domain). Requires from_domain to be set — pinning from_mailbox alone is rejected, since there is no domain to attach it to. 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",

package/dist/tools/enrichment.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const enrichProfileTool: Tool;
 export declare const findEmailTool: Tool;
 export declare const verifyEmailTool: Tool;

package/dist/tools/gov.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
+export declare const govSolicitationsTool: Tool;
+export declare function handleGovSolicitations(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").GovSolicitationsResult>;

package/dist/tools/gov.js

@@ -0,0 +1,36 @@
+export const govSolicitationsTool = {
+    name: "oneshot_gov_solicitations",
+    description: "Federal contract opportunities (SAM.gov) by NAICS code — Sources Sought and Presolicitation notices with the contracting officer's published name and email, agency, response deadline, set-aside, and description. Use for government buyers instead of people_search. Flat price per search. Paid tool.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            naics: { type: "array", items: { type: "string" }, description: "6-digit NAICS codes, 1-20 (required)" },
+            notice_types: { type: "array", items: { type: "string", enum: ["r", "p", "o", "k", "s", "a", "u", "i", "g"] }, description: "r=Sources Sought, p=Presolicitation, o=Solicitation, k=Combined Synopsis, s=Special Notice, a=Award. Default ['r','p']" },
+            since_days: { type: "number", description: "Look-back window on posted date, 1-365 (default 30)" },
+            agencies: { type: "array", items: { type: "string" }, description: "Agency-name substrings to keep" },
+            keywords: { type: "array", items: { type: "string" }, description: "Title / full-text keywords" },
+            state: { type: "string", description: "Place-of-performance state code, e.g. 'TX'" },
+            set_aside: { type: "string", description: "Set-aside code: SBA, 8A, HZC, SDVOSBC, WOSB, ..." },
+            active_only: { type: "boolean", description: "Default true: drop archived notices and past deadlines" },
+            has_contact: { type: "boolean", description: "Only notices with a name + email point of contact" },
+            include_description: { type: "boolean", description: "Default true: fetch description bodies for the first rows" },
+            limit: { type: "number", description: "Max results (1-500, default 100)" },
+        },
+        required: ["naics"],
+    },
+};
+export async function handleGovSolicitations(agent, args) {
+    return agent.govSolicitations({
+        naics: args.naics,
+        notice_types: args.notice_types,
+        since_days: args.since_days,
+        agencies: args.agencies,
+        keywords: args.keywords,
+        state: args.state,
+        set_aside: args.set_aside,
+        active_only: args.active_only,
+        has_contact: args.has_contact,
+        include_description: args.include_description,
+        limit: args.limit,
+    });
+}

package/dist/tools/inbox.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const inboxListTool: Tool;
 export declare const inboxGetTool: Tool;
 export declare function handleInboxList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").InboxListResult>;

package/dist/tools/index.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const tools: Tool[];
 export declare function handleToolCall(agent: OneShot, toolName: string, args: Record<string, unknown>): Promise<{
     content: {
@@ -14,3 +14,10 @@ export declare function handleToolCall(agent: OneShot, toolName: string, args: R
     }[];
     isError?: undefined;
 }>;
+/**
+ * Typed SDK errors become a JSON body the model can act on instead of a
+ * prose string. Matched on `name`, never `instanceof`: the hosted server runs
+ * the workspace SDK while this registry's types come from the published one,
+ * so the classes are different objects at runtime.
+ */
+export declare function structuredToolError(error: unknown): Record<string, unknown> | undefined;

package/dist/tools/index.js

@@ -15,6 +15,8 @@ import { webSearchTool, handleWebSearch } from "./search.js";
 import { webReadTool, handleWebRead } from "./web-read.js";
 import { deepResearchPersonTool, socialProfilesTool, articleSearchTool, personNewsfeedTool, personInterestsTool, personInteractionsTool, handleDeepResearchPerson, handleSocialProfiles, handleArticleSearch, handlePersonNewsfeed, handlePersonInterests, handlePersonInteractions } from "./nyne.js";
 import { companySearchTool, enrichCompanyTool, handleCompanySearch, handleEnrichCompany } from "./company.js";
+import { localSearchTool, localResolveTool, handleLocalSearch, handleLocalResolve } from "./local.js";
+import { govSolicitationsTool, handleGovSolicitations } from "./gov.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, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
@@ -44,6 +46,9 @@ export const tools = [
     personInteractionsTool,
     companySearchTool,
     enrichCompanyTool,
+    localSearchTool,
+    localResolveTool,
+    govSolicitationsTool,
     // Commerce
     commerceSearchTool,
     commerceBuyTool,
@@ -105,6 +110,9 @@ const handlers = {
     "oneshot_person_interactions": handlePersonInteractions,
     "oneshot_company_search": handleCompanySearch,
     "oneshot_enrich_company": handleEnrichCompany,
+    "oneshot_local_search": handleLocalSearch,
+    "oneshot_local_resolve": handleLocalResolve,
+    "oneshot_gov_solicitations": handleGovSolicitations,
     // Commerce
     "oneshot_commerce_search": handleCommerceSearch,
     "oneshot_commerce_buy": handleCommerceBuy,
@@ -156,9 +164,45 @@ export async function handleToolCall(agent, toolName, args) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        const structured = structuredToolError(error);
         return {
-            content: [{ type: "text", text: `Error: ${message}` }],
+            content: [{ type: "text", text: structured ? JSON.stringify(structured, null, 2) : `Error: ${message}` }],
             isError: true,
         };
     }
 }
+/**
+ * Typed SDK errors become a JSON body the model can act on instead of a
+ * prose string. Matched on `name`, never `instanceof`: the hosted server runs
+ * the workspace SDK while this registry's types come from the published one,
+ * so the classes are different objects at runtime.
+ */
+export function structuredToolError(error) {
+    const e = error;
+    if (!e || typeof e !== "object")
+        return undefined;
+    switch (e.name) {
+        case "BudgetExceededError":
+            return {
+                error: "budget_exceeded",
+                message: e.message,
+                reason: e.reason,
+                cap: e.cap,
+                spent: e.spent,
+                charge: e.charge,
+                resets_at: e.resetsAt,
+            };
+        case "InsufficientCreditsError":
+            return {
+                error: "insufficient_credits",
+                message: e.message,
+                required_usdc: e.required,
+                credits_balance: e.balance,
+                shortfall_usdc: e.shortfall,
+            };
+        case "PaymentError":
+            return { error: "payment_failed", message: e.message, reason: e.reason };
+        default:
+            return undefined;
+    }
+}

package/dist/tools/local.d.ts

@@ -0,0 +1,6 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
+export declare const localSearchTool: Tool;
+export declare const localResolveTool: Tool;
+export declare function handleLocalSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").LocalSearchResult>;
+export declare function handleLocalResolve(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").LocalResolveResult>;

package/dist/tools/local.js

@@ -0,0 +1,60 @@
+export const localSearchTool = {
+    name: "oneshot_local_search",
+    description: "Discover local main-street businesses (restaurants, contractors, dental practices, auto shops) by category or keywords in a location. Use this instead of people_search for independent local businesses. Flat price per search. Paid tool.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            category: { type: "array", items: { type: "string" }, description: "Business categories, e.g. ['hvac contractor', 'dental practice']. category or keywords required." },
+            keywords: { type: "array", items: { type: "string" }, description: "Free-text keywords (alternative to category)" },
+            location: { type: "array", items: { type: "string" }, description: "Cities, neighborhoods, or 'City, ST' strings (required)" },
+            min_rating: { type: "number", description: "Minimum star rating (0-5)" },
+            min_review_count: { type: "number", description: "Minimum review count" },
+            is_chain: { type: "boolean", description: "true = only chains, false = exclude detected chains" },
+            operating_status: { type: "string", enum: ["open", "any"], description: "Default 'open' drops closed businesses" },
+            has_domain: { type: "boolean", description: "true = only rows with a resolvable website domain" },
+            limit: { type: "number", description: "Max results (1-500, default 100)" },
+        },
+        required: ["location"],
+        anyOf: [{ required: ["category"] }, { required: ["keywords"] }],
+    },
+};
+export const localResolveTool = {
+    name: "oneshot_local_resolve",
+    description: "Resolve a local business name plus one locating field (address, city, postal code, or phone) to its website domain, phone, category, and operating status with a match confidence. A miss returns found=false, not an error. Paid tool.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "Business name" },
+            address: { type: "string", description: "Street address" },
+            city: { type: "string", description: "City" },
+            region: { type: "string", description: "State / province" },
+            postal_code: { type: "string", description: "Postal code" },
+            phone: { type: "string", description: "Phone number (strong match signal)" },
+        },
+        required: ["name"],
+        anyOf: [{ required: ["address"] }, { required: ["city"] }, { required: ["postal_code"] }, { required: ["phone"] }],
+    },
+};
+export async function handleLocalSearch(agent, args) {
+    return agent.localSearch({
+        category: args.category,
+        keywords: args.keywords,
+        location: args.location,
+        min_rating: args.min_rating,
+        min_review_count: args.min_review_count,
+        is_chain: args.is_chain,
+        operating_status: args.operating_status,
+        has_domain: args.has_domain,
+        limit: args.limit,
+    });
+}
+export async function handleLocalResolve(agent, args) {
+    return agent.localResolve({
+        name: args.name,
+        address: args.address,
+        city: args.city,
+        region: args.region,
+        postal_code: args.postal_code,
+        phone: args.phone,
+    });
+}

package/dist/tools/notifications.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const notificationsTool: Tool;
 export declare const markReadTool: Tool;
 export declare function handleNotifications(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").NotificationsResult>;

package/dist/tools/nyne.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const deepResearchPersonTool: Tool;
 export declare const socialProfilesTool: Tool;
 export declare const articleSearchTool: Tool;

package/dist/tools/people.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const peopleSearchTool: Tool;
 export declare function handlePeopleSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").PeopleSearchResult>;

package/dist/tools/research.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const researchTool: Tool;
 /**
  * Wait budget per depth. The SDK's default is 120s, but deep research runs

package/dist/tools/search.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const webSearchTool: Tool;
 export declare function handleWebSearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").WebSearchResult>;

package/dist/tools/sms-inbox.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const smsInboxListTool: Tool;
 export declare const smsInboxGetTool: Tool;
 export declare function handleSmsInboxList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SmsInboxResult>;

package/dist/tools/sms.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const smsTool: Tool;
 export declare function handleSms(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").SmsSendResult>;

package/dist/tools/voice.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const voiceTool: Tool;
 export declare function handleVoice(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").VoiceCallResult>;

package/dist/tools/wallet.d.ts

@@ -1,5 +1,5 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const getBalanceTool: Tool;
 export declare function handleGetBalance(agent: OneShot, _args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").UnifiedBalance>;
 export declare const budgetStatusTool: Tool;

package/dist/tools/wallet.js

@@ -15,7 +15,8 @@ export const budgetStatusTool = {
     description: "Read-only: today's spend versus the agent's configured spend budget — daily cap, per-call cap, " +
         "spent_today_usdc, remaining_usdc, pct_used and resets_at (next UTC midnight). Use it to plan " +
         "remaining work; paid calls are rejected with budget_exceeded once the cap is reached. The budget " +
-        "itself is set by the operator via ONESHOT_BUDGET_* env vars and cannot be changed from here. Free.",
+        "itself is set by the operator (ONESHOT_BUDGET_* env vars on a local server, the SDK or API for the " +
+        "hosted endpoint) and cannot be changed from here. Free.",
     inputSchema: {
         type: "object",
         properties: {},

package/dist/tools/web-read.d.ts

@@ -1,4 +1,4 @@
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
-import { OneShot } from "@oneshot-agent/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
 export declare const webReadTool: Tool;
 export declare function handleWebRead(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").WebReadResult>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.17.3",
-  "description": "MCP server for OneShot - 47 tools for AI agents",
+  "version": "0.20.0",
+  "description": "MCP server for OneShot - 50 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.29.0",
+    "@oneshot-agent/sdk": "^0.33.0",
     "zod": "3.25.76"
   },
   "devDependencies": {