@oneshot-agent/mcp-server 0.11.1 → 0.13.0

package/README.md

@@ -111,6 +111,8 @@ Get CDP credentials at [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/a
 | `oneshot_enrich_profile` | Enrich person profile from LinkedIn/email |
 | `oneshot_find_email` | Find someone's email address |
 | `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 |
 
 ### Person Intelligence
 
@@ -145,6 +147,33 @@ Get CDP credentials at [Coinbase Agentic Wallet](https://docs.cdp.coinbase.com/a
 | `oneshot_build` | Build and deploy production websites |
 | `oneshot_update_build` | Update an existing website |
 
+### Compute Orchestration
+
+| Tool | Description |
+|------|-------------|
+| `oneshot_compute` | Create an autonomous goal — objective + budget, the orchestrator plans and executes |
+| `oneshot_compute_status` | Get a compute goal's status and budget |
+| `oneshot_compute_tasks` | List tasks planned/executed under a goal |
+| `oneshot_compute_cancel` | Cancel a goal and refund remaining budget |
+| `oneshot_compute_respond` | Respond to a human-in-the-loop task |
+
+### Domains
+
+| Tool | Description |
+|------|-------------|
+| `oneshot_list_domains` | List sending domains with warmup/limits |
+| `oneshot_pause_domain` | Pause a sending domain |
+| `oneshot_resume_domain` | Resume a paused sending domain |
+
+### Analytics
+
+| Tool | Description |
+|------|-------------|
+| `oneshot_spend_breakdown` | Spend by tool/category over a period |
+| `oneshot_rocs` | Return on Compute Spend analytics |
+| `oneshot_receipts_list` | List spend receipts |
+| `oneshot_tag_receipt_value` | Tag a receipt with the value it generated |
+
 ### Account
 
 | Tool | Description |

package/dist/index.js

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

package/dist/tools/analytics.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const spendBreakdownTool: Tool;
+export declare const rocsTool: Tool;
+export declare const receiptsListTool: Tool;
+export declare const tagReceiptValueTool: 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 handleTagReceiptValue(agent: OneShot, args: Record<string, unknown>): Promise<void>;

package/dist/tools/analytics.js

@@ -0,0 +1,74 @@
+export const spendBreakdownTool = {
+    name: "oneshot_spend_breakdown",
+    description: "Get a breakdown of the agent's spend by tool/category over a period. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            period: { type: "number", description: "Lookback window in days" },
+        },
+    },
+};
+export const rocsTool = {
+    name: "oneshot_rocs",
+    description: "Get Return on Compute Spend (RoCS) analytics for the agent over a period. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            period: { type: "number", description: "Lookback window in days" },
+        },
+    },
+};
+export const receiptsListTool = {
+    name: "oneshot_receipts_list",
+    description: "List the agent's spend receipts, optionally filtered by period/category and paginated. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            period: { type: "number", description: "Lookback window in days" },
+            category: { type: "string", description: "Filter by tool category" },
+            limit: { type: "number", description: "Max receipts to return (1-100, default 50)" },
+            offset: { type: "number", description: "Pagination offset" },
+            since: { type: "string", description: "Lower bound on created_at (ISO 8601). Page back to older receipts." },
+            until: { type: "string", description: "Upper bound on created_at (ISO 8601)." },
+        },
+    },
+};
+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.",
+    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')" },
+            amount: { type: "number", description: "Value amount (e.g. USD)" },
+            label: { type: "string", description: "Optional human label for the value" },
+        },
+        required: ["type"],
+    },
+};
+export async function handleSpendBreakdown(agent, args) {
+    return agent.spendBreakdown({ period: args.period });
+}
+export async function handleRocs(agent, args) {
+    return agent.rocs({ period: args.period });
+}
+export async function handleReceiptsList(agent, args) {
+    return agent.receiptsList({
+        period: args.period,
+        category: args.category,
+        limit: args.limit,
+        offset: args.offset,
+        since: args.since,
+        until: args.until,
+    });
+}
+export async function handleTagReceiptValue(agent, args) {
+    return agent.tagReceiptValue({ receiptId: args.receipt_id, requestId: args.request_id }, {
+        type: args.type,
+        amount: args.amount,
+        label: args.label,
+    });
+}

package/dist/tools/company.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { 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>;
+export declare function handleEnrichCompany(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").EnrichCompanyResult>;

package/dist/tools/company.js

@@ -0,0 +1,54 @@
+export const companySearchTool = {
+    name: "oneshot_company_search",
+    description: "Search for companies by name, domain, industry, location, size, funding stage, or tags. Paid tool.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "Company name to search for" },
+            domain: { type: "string", description: "Company domain (e.g. example.com)" },
+            industry: { type: "array", items: { type: "string" }, description: "Industries to filter by" },
+            location: { type: "array", items: { type: "string" }, description: "Locations to filter by" },
+            size: { type: "string", description: "Company size band (e.g. '11-50')" },
+            min_employee_count: { type: "number", description: "Minimum employee count" },
+            max_employee_count: { type: "number", description: "Maximum employee count" },
+            funding_stage: { type: "string", description: "Funding stage (e.g. 'series_a')" },
+            tags: { type: "array", items: { type: "string" }, description: "Tags to filter by" },
+            limit: { type: "number", description: "Max results (default 10, max 100)" },
+        },
+    },
+};
+export const enrichCompanyTool = {
+    name: "oneshot_enrich_company",
+    description: "Enrich a company from its domain, name, LinkedIn URL, or stock ticker. At least one identifier is required. Paid tool.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            domain: { type: "string", description: "Company domain (e.g. example.com)" },
+            name: { type: "string", description: "Company name" },
+            linkedin_url: { type: "string", description: "Company LinkedIn URL" },
+            ticker: { type: "string", description: "Stock ticker symbol" },
+        },
+    },
+};
+export async function handleCompanySearch(agent, args) {
+    return agent.companySearch({
+        name: args.name,
+        domain: args.domain,
+        industry: args.industry,
+        location: args.location,
+        size: args.size,
+        min_employee_count: args.min_employee_count,
+        max_employee_count: args.max_employee_count,
+        funding_stage: args.funding_stage,
+        tags: args.tags,
+        limit: args.limit,
+    });
+}
+export async function handleEnrichCompany(agent, args) {
+    return agent.enrichCompany({
+        domain: args.domain,
+        name: args.name,
+        linkedin_url: args.linkedin_url,
+        ticker: args.ticker,
+    });
+}

package/dist/tools/compute.d.ts

@@ -0,0 +1,21 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const computeTool: Tool;
+export declare const computeStatusTool: Tool;
+export declare const computeTasksTool: Tool;
+export declare const computeCancelTool: Tool;
+export declare const computeRespondTool: Tool;
+export declare function handleCompute(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ComputeGoalResult>;
+export declare function handleComputeStatus(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ComputeGoalStatus>;
+export declare function handleComputeTasks(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ComputeTask[]>;
+export declare function handleComputeCancel(agent: OneShot, args: Record<string, unknown>): Promise<{
+    goal_id: string;
+    status: string;
+    remaining_budget: string;
+}>;
+export declare function handleComputeRespond(agent: OneShot, args: Record<string, unknown>): Promise<{
+    task_id: string;
+    goal_id: string;
+    task_status: string;
+    orchestrator_action: string;
+}>;

package/dist/tools/compute.js

@@ -0,0 +1,115 @@
+export const computeTool = {
+    name: "oneshot_compute",
+    description: "Create an autonomous compute goal: hand the orchestrator a natural-language objective and a budget, and it plans and executes multi-step work across OneShot tools. Returns a goal id to poll. Paid tool (quote-to-pay against the budget).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            objective: {
+                type: "string",
+                description: "Natural-language objective for the orchestrator to accomplish",
+            },
+            budget_usdc: {
+                type: "number",
+                description: "Spend ceiling in USDC. Server estimates if omitted.",
+            },
+            params: {
+                type: "object",
+                description: "Additional parameters / constraints for the objective",
+                additionalProperties: true,
+            },
+            deadline: {
+                type: "string",
+                description: "ISO 8601 deadline for completion",
+            },
+            soul_slug: {
+                type: "string",
+                description: "Route the goal to a specific Soul agent",
+            },
+            soul_service_slug: {
+                type: "string",
+                description: "Route the goal to a specific Soul service",
+            },
+            schedule: {
+                type: "object",
+                description: "Make this a recurring goal (cron-style schedule object)",
+                additionalProperties: true,
+            },
+        },
+        required: ["objective"],
+    },
+};
+export const computeStatusTool = {
+    name: "oneshot_compute_status",
+    description: "Get the current status of a compute goal (state, budget remaining, progress). Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            goal_id: { type: "string", description: "Compute goal id" },
+        },
+        required: ["goal_id"],
+    },
+};
+export const computeTasksTool = {
+    name: "oneshot_compute_tasks",
+    description: "List the tasks the orchestrator has planned/executed under a compute goal. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            goal_id: { type: "string", description: "Compute goal id" },
+        },
+        required: ["goal_id"],
+    },
+};
+export const computeCancelTool = {
+    name: "oneshot_compute_cancel",
+    description: "Cancel a compute goal and refund the remaining budget. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            goal_id: { type: "string", description: "Compute goal id" },
+            reason: { type: "string", description: "Optional cancellation reason" },
+        },
+        required: ["goal_id"],
+    },
+};
+export const computeRespondTool = {
+    name: "oneshot_compute_respond",
+    description: "Respond to a human-in-the-loop task that a compute goal is waiting on (approve/reject or provide input). Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            goal_id: { type: "string", description: "Compute goal id" },
+            task_id: { type: "string", description: "Id of the task awaiting a response" },
+            response: { type: "string", description: "Free-text response for the task" },
+            approved: { type: "boolean", description: "Approve (true) or reject (false) an approval task" },
+        },
+        required: ["goal_id", "task_id"],
+    },
+};
+export async function handleCompute(agent, args) {
+    return agent.compute({
+        objective: args.objective,
+        budget_usdc: args.budget_usdc,
+        params: args.params,
+        deadline: args.deadline,
+        soul_slug: args.soul_slug,
+        soul_service_slug: args.soul_service_slug,
+        schedule: args.schedule,
+    });
+}
+export async function handleComputeStatus(agent, args) {
+    return agent.getComputeGoal(args.goal_id);
+}
+export async function handleComputeTasks(agent, args) {
+    return agent.getComputeTasks(args.goal_id);
+}
+export async function handleComputeCancel(agent, args) {
+    return agent.cancelComputeGoal(args.goal_id, args.reason);
+}
+export async function handleComputeRespond(agent, args) {
+    return agent.respondToComputeTask(args.goal_id, {
+        task_id: args.task_id,
+        response: args.response,
+        approved: args.approved,
+    });
+}

package/dist/tools/domains.d.ts

@@ -0,0 +1,8 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { OneShot } from "@oneshot-agent/sdk";
+export declare const listDomainsTool: Tool;
+export declare const pauseDomainTool: Tool;
+export declare const resumeDomainTool: Tool;
+export declare function handleListDomains(agent: OneShot, _args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").DomainPoolListResult>;
+export declare function handlePauseDomain(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").DomainPoolStatusResult>;
+export declare function handleResumeDomain(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").DomainPoolStatusResult>;

package/dist/tools/domains.js

@@ -0,0 +1,36 @@
+export const listDomainsTool = {
+    name: "oneshot_list_domains",
+    description: "List the agent's sending domains with pool status, warmup score, and daily send limits. Free.",
+    inputSchema: { type: "object", properties: {} },
+};
+export const pauseDomainTool = {
+    name: "oneshot_pause_domain",
+    description: "Pause a sending domain so it stops being used for outbound email. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            domain: { type: "string", description: "Domain to pause (e.g. example.com)" },
+        },
+        required: ["domain"],
+    },
+};
+export const resumeDomainTool = {
+    name: "oneshot_resume_domain",
+    description: "Resume a previously paused sending domain. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            domain: { type: "string", description: "Domain to resume (e.g. example.com)" },
+        },
+        required: ["domain"],
+    },
+};
+export async function handleListDomains(agent, _args) {
+    return agent.listDomains();
+}
+export async function handlePauseDomain(agent, args) {
+    return agent.pauseDomain(args.domain);
+}
+export async function handleResumeDomain(agent, args) {
+    return agent.resumeDomain(args.domain);
+}

package/dist/tools/index.js

@@ -14,6 +14,10 @@ import { browserTool, browserCreateProfileTool, browserListProfilesTool, browser
 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 { 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";
 // All available tools
 export const tools = [
     // Communication
@@ -38,9 +42,17 @@ export const tools = [
     personNewsfeedTool,
     personInterestsTool,
     personInteractionsTool,
+    companySearchTool,
+    enrichCompanyTool,
     // Commerce
     commerceSearchTool,
     commerceBuyTool,
+    // Compute orchestration
+    computeTool,
+    computeStatusTool,
+    computeTasksTool,
+    computeCancelTool,
+    computeRespondTool,
     // Build
     buildTool,
     updateBuildTool,
@@ -51,6 +63,15 @@ export const tools = [
     browserDeleteProfileTool,
     // Web Read
     webReadTool,
+    // Domains
+    listDomainsTool,
+    pauseDomainTool,
+    resumeDomainTool,
+    // Analytics
+    spendBreakdownTool,
+    rocsTool,
+    receiptsListTool,
+    tagReceiptValueTool,
     // Account
     notificationsTool,
     markReadTool,
@@ -80,9 +101,17 @@ const handlers = {
     "oneshot_person_newsfeed": handlePersonNewsfeed,
     "oneshot_person_interests": handlePersonInterests,
     "oneshot_person_interactions": handlePersonInteractions,
+    "oneshot_company_search": handleCompanySearch,
+    "oneshot_enrich_company": handleEnrichCompany,
     // Commerce
     "oneshot_commerce_search": handleCommerceSearch,
     "oneshot_commerce_buy": handleCommerceBuy,
+    // Compute orchestration
+    "oneshot_compute": handleCompute,
+    "oneshot_compute_status": handleComputeStatus,
+    "oneshot_compute_tasks": handleComputeTasks,
+    "oneshot_compute_cancel": handleComputeCancel,
+    "oneshot_compute_respond": handleComputeRespond,
     // Build
     "oneshot_build": handleBuild,
     "oneshot_update_build": handleUpdateBuild,
@@ -93,6 +122,15 @@ const handlers = {
     "oneshot_browser_delete_profile": handleBrowserDeleteProfile,
     // Web Read
     "oneshot_web_read": handleWebRead,
+    // Domains
+    "oneshot_list_domains": handleListDomains,
+    "oneshot_pause_domain": handlePauseDomain,
+    "oneshot_resume_domain": handleResumeDomain,
+    // Analytics
+    "oneshot_spend_breakdown": handleSpendBreakdown,
+    "oneshot_rocs": handleRocs,
+    "oneshot_receipts_list": handleReceiptsList,
+    "oneshot_tag_receipt_value": handleTagReceiptValue,
     // Account
     "oneshot_notifications": handleNotifications,
     "oneshot_mark_notification_read": handleMarkRead,

package/package.json

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