@oneshot-agent/mcp-server 0.30.1 → 0.33.0

package/README.md

@@ -102,7 +102,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 73 tools over
+server and must not hold a wallet key. For them, OneShot hosts the same 78 tools over
 Streamable HTTP at **`https://win.oneshotagent.com/mcp`**, authenticated with an
 **agent access token** and billed to the agent's credit balance:
 
@@ -125,6 +125,18 @@ instead of the wallet variables for a credits-only session on your own machine.
 
 ## Available Tools
 
+### Soul Hunt
+
+| Tool | Description |
+|------|-------------|
+| `oneshot_hunt_list` | List active or collected Soul Hunts. Free. |
+| `oneshot_hunt_status` | Detailed status, rounds and timeline for a specific hunt. Free. |
+| `oneshot_hunt_predict` | Submit a prediction for a hunt. Debits a stake from your balance. Paid, and requires a wallet session — Soul Hunt enforces a wallet-signed write proof that an access-token/OAuth session cannot produce. |
+| `oneshot_hunt_collection` | View the souls you have captured. Free. |
+| `oneshot_hunt_leaderboard` | Public predictor leaderboard. Free. |
+
+Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; the wallet session's `X-Agent-ID`/`x-agent-proof` carry over, but the OneShot bearer token never does.
+
 ### Communication
 
 | Tool | Description |

package/dist/index.js

@@ -46,23 +46,19 @@ async function initAgent() {
         "       ONESHOT_WALLET_PRIVATE_KEY, or ONESHOT_ACCESS_TOKEN (credits-only session)");
     process.exit(1);
 }
-// Start server
 async function main() {
     const agent = await initAgent();
-    // Create MCP server
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.30.1", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.33.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},
         },
     });
-    // List available tools
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         return { tools };
     });
-    // Handle tool calls
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
         return handleToolCall(agent, name, args || {});

package/dist/tools/analytics.js

@@ -25,7 +25,7 @@ export const receiptsListTool = {
         type: "object",
         properties: {
             period: { type: "number", description: "Lookback window in days" },
-            category: { type: "string", description: "Filter by tool category" },
+            category: { type: "string", enum: ["data", "verification", "communication", "commerce", "infrastructure", "agent_to_agent"], description: "Filter by receipt 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." },
@@ -72,6 +72,10 @@ export async function handleRocs(agent, args) {
     return agent.rocs({ period: args.period });
 }
 export async function handleReceiptsList(agent, args) {
+    // Pass `category` through as received — an unrecognized value must still
+    // reach the API and get its 400 invalid_category response (#1078), not be
+    // silently dropped here into an unfiltered list. The cast only satisfies
+    // the SDK's compile-time enum narrowing; the API validates at runtime.
     return agent.receiptsList({
         period: args.period,
         category: args.category,

package/dist/tools/annotations.js

@@ -6,22 +6,23 @@ const OPEN = true;
 const OWN = false;
 const DESTRUCTIVE = true;
 export const TOOL_ANNOTATIONS = {
-    // Communication
+    oneshot_hunt_list: read("List Soul Hunts", OPEN),
+    oneshot_hunt_status: read("Get Soul Hunt Status", OPEN),
+    oneshot_hunt_predict: write("Predict Soul Hunt", OPEN),
+    oneshot_hunt_collection: read("List Collected Souls", OWN),
+    oneshot_hunt_leaderboard: read("Soul Hunt Leaderboard", OPEN),
     oneshot_email: write("Send email", OPEN),
     oneshot_voice: write("Place a phone call", OPEN),
     oneshot_sms: write("Send a text message", OPEN),
-    // Inbox
     oneshot_inbox_list: read("List received emails", OWN),
     oneshot_inbox_get: read("Read a received email", OWN),
     oneshot_sms_inbox_list: read("List received texts", OWN),
     oneshot_sms_inbox_get: read("Read a received text", OWN),
-    // Inbound voice
     oneshot_voice_number_provision: write("Get a phone number", OPEN),
     oneshot_voice_numbers: read("List phone numbers", OWN),
     oneshot_voice_inbound_set: write("Set up call answering", OPEN, DESTRUCTIVE), // replaces the number's answering settings; outside callers reach it via the carrier
     oneshot_voice_inbound_disable: write("Stop answering calls", OPEN),
     oneshot_voice_inbound_calls: read("List answered calls", OWN),
-    // Research & enrichment
     oneshot_research: read("Deep research", OPEN),
     oneshot_people_search: read("Find people", OPEN),
     oneshot_enrich_profile: read("Look up a person's profile", OPEN),
@@ -39,10 +40,8 @@ export const TOOL_ANNOTATIONS = {
     oneshot_local_search: read("Find local businesses", OPEN),
     oneshot_local_resolve: read("Look up a local business", OPEN),
     oneshot_gov_solicitations: read("Find government contracts", OPEN),
-    // Commerce
     oneshot_commerce_search: read("Search products", OPEN),
     oneshot_commerce_buy: write("Buy a product", OPEN),
-    // Compute orchestration
     oneshot_compute: write("Start a goal", OPEN),
     oneshot_compute_status: read("Check a goal", OWN),
     oneshot_compute_tasks: read("List a goal's tasks", OWN),
@@ -51,17 +50,13 @@ export const TOOL_ANNOTATIONS = {
     oneshot_compute_pause: write("Pause a goal", OWN),
     oneshot_compute_resume: write("Resume a goal", OWN),
     oneshot_compute_fund: write("Add budget to a goal", OWN),
-    // Build
     oneshot_build: write("Build a website", OPEN),
     oneshot_update_build: write("Update a website", OPEN, DESTRUCTIVE), // overwrites the live site
-    // Browser
     oneshot_browser: write("Browse and act on a website", OPEN),
     oneshot_browser_create_profile: write("Create a browser profile", OWN),
     oneshot_browser_list_profiles: read("List browser profiles", OWN),
     oneshot_browser_delete_profile: write("Delete a browser profile", OWN, DESTRUCTIVE),
-    // Web read
     oneshot_web_read: read("Read a web page", OPEN),
-    // LinkedIn
     oneshot_linkedin_connect: write("Connect LinkedIn", OPEN),
     oneshot_linkedin_accounts: read("List LinkedIn accounts", OWN),
     oneshot_linkedin_sync: write("Sync LinkedIn messages", OPEN), // paid; imports history into the account
@@ -72,22 +67,18 @@ export const TOOL_ANNOTATIONS = {
     oneshot_linkedin_withdraw_invitation: write("Withdraw a LinkedIn invitation", OPEN, DESTRUCTIVE),
     oneshot_linkedin_view_profile: write("View a LinkedIn profile", OPEN), // notify=true is visible to the person
     oneshot_linkedin_react: write("React to a LinkedIn post", OPEN),
-    // Domains
     oneshot_list_domains: read("List sending domains", OWN),
     oneshot_pause_domain: write("Pause a sending domain", OWN),
     oneshot_resume_domain: write("Resume a sending domain", OWN),
-    // Analytics
     oneshot_spend_breakdown: read("Show spending", 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
     oneshot_notifications: read("List notifications", OWN),
     oneshot_mark_notification_read: write("Mark a notification read", OWN),
     oneshot_get_balance: read("Check balance", OWN),
     oneshot_budget_status: read("Check budget", OWN),
-    // Approvals
     oneshot_approval_create: write("Ask a person to approve", OPEN),
     oneshot_approval_get: read("Check an approval", OWN),
     oneshot_approval_list: read("List approvals", OWN),

package/dist/tools/approvals.js

@@ -1,6 +1,5 @@
-// 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.
+// Setting the action policy is deliberately not exposed here — an agent that
+// could loosen 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. " +

package/dist/tools/build.js

@@ -1,12 +1,12 @@
 export const buildTool = {
     name: "oneshot_build",
-    description: "Build and deploy production websites - SaaS landing pages, portfolios, agency sites, restaurant pages, event sites, and more. Creates fully-functional sites with real hosting. Paid tool — quote provided before payment.",
+    description: "Build and deploy production websites - SaaS landing pages, portfolios, agency sites, restaurant pages, event sites, and more, single-page or multi-page (pages). Creates fully-functional sites with real hosting. Paid tool — quote provided before payment.",
     inputSchema: {
         type: "object",
         properties: {
             type: {
                 type: "string",
-                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event", "app", "social"],
+                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event"],
                 description: "Build type (default: saas)",
             },
             product: {
@@ -40,6 +40,21 @@ export const buildTool = {
                 items: { type: "string" },
                 description: "Specific sections to include (e.g., ['hero', 'features', 'pricing', 'testimonials'])",
             },
+            pages: {
+                type: "array",
+                maxItems: 8,
+                description: "Extra pages beyond the home page, each priced separately (e.g., [{ path: '/pricing', name: 'Pricing' }, { path: '/about', name: 'About', purpose: 'Team and story' }])",
+                items: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "Route: lowercase words and hyphens, e.g. /pricing or /blog/launch" },
+                        name: { type: "string", description: "Nav label" },
+                        purpose: { type: "string", description: "What the page is for" },
+                        sections: { type: "array", items: { type: "string" }, description: "Sections for this page" },
+                    },
+                    required: ["path", "name"],
+                },
+            },
             lead_capture: {
                 type: "object",
                 properties: {
@@ -98,7 +113,7 @@ export const buildTool = {
 };
 export const updateBuildTool = {
     name: "oneshot_update_build",
-    description: "Update an existing website with new content or configuration. Requires the build_id from a previous build. Updates reuse existing hosting infrastructure at a discounted rate.",
+    description: "Change an existing website. With `changes` (plain-language edits, e.g. 'make the hero darker and add an FAQ page'), the site's existing code is edited and redeployed to the same URL at a flat price. With `product` and no `changes`, the site is regenerated from scratch at a discounted rate. Requires the build_id from a previous build.",
     inputSchema: {
         type: "object",
         properties: {
@@ -106,6 +121,10 @@ export const updateBuildTool = {
                 type: "string",
                 description: "Existing build ID to update (from previous build result)",
             },
+            changes: {
+                type: "string",
+                description: "Plain-language edits to apply to the existing site (keeps everything else). Max 5000 chars.",
+            },
             product: {
                 type: "object",
                 properties: {
@@ -130,7 +149,7 @@ export const updateBuildTool = {
             },
             type: {
                 type: "string",
-                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event", "app", "social"],
+                enum: ["saas", "portfolio", "agency", "personal", "product", "funnel", "restaurant", "event"],
                 description: "Build type (optional, keeps existing if not specified)",
             },
             source_url: {
@@ -142,6 +161,21 @@ export const updateBuildTool = {
                 items: { type: "string" },
                 description: "Specific sections to include",
             },
+            pages: {
+                type: "array",
+                maxItems: 8,
+                description: "Extra pages beyond the home page, each priced separately (e.g., [{ path: '/pricing', name: 'Pricing' }, { path: '/about', name: 'About', purpose: 'Team and story' }])",
+                items: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "Route: lowercase words and hyphens, e.g. /pricing or /blog/launch" },
+                        name: { type: "string", description: "Nav label" },
+                        purpose: { type: "string", description: "What the page is for" },
+                        sections: { type: "array", items: { type: "string" }, description: "Sections for this page" },
+                    },
+                    required: ["path", "name"],
+                },
+            },
             lead_capture: {
                 type: "object",
                 properties: {
@@ -169,7 +203,7 @@ export const updateBuildTool = {
                 description: "Custom domain",
             },
         },
-        required: ["build_id", "product"],
+        required: ["build_id"],
     },
 };
 export async function handleBuild(agent, args) {
@@ -184,6 +218,7 @@ export async function handleBuild(agent, args) {
         },
         source_url: args.source_url,
         sections: args.sections,
+        pages: args.pages,
         lead_capture: args.lead_capture,
         brand: args.brand,
         images: args.images,
@@ -192,7 +227,13 @@ export async function handleBuild(agent, args) {
     });
 }
 export async function handleUpdateBuild(agent, args) {
+    if (typeof args.changes === "string" && args.changes.trim()) {
+        return agent.refineBuild({ build_id: args.build_id, changes: args.changes });
+    }
     const product = args.product;
+    if (!product) {
+        throw new Error("oneshot_update_build needs either changes (to edit the site) or product (to regenerate it)");
+    }
     return agent.updateBuild({
         build_id: args.build_id,
         product: {
@@ -204,6 +245,7 @@ export async function handleUpdateBuild(agent, args) {
         type: args.type,
         source_url: args.source_url,
         sections: args.sections,
+        pages: args.pages,
         lead_capture: args.lead_capture,
         brand: args.brand,
         images: args.images,

package/dist/tools/hunt.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { OneShot } from "@oneshot-agent/sdk";
+export declare const huntListTool: Tool;
+export declare const huntStatusTool: Tool;
+export declare const huntPredictTool: Tool;
+export declare const huntCollectionTool: Tool;
+export declare const huntLeaderboardTool: Tool;
+export declare function handleHuntList(agent: OneShot, args: Record<string, unknown>): Promise<any>;
+export declare function handleHuntStatus(agent: OneShot, args: Record<string, unknown>): Promise<any>;
+export declare function handleHuntPredict(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").HuntQuote>;
+export declare function handleHuntCollection(agent: OneShot, args: Record<string, unknown>): Promise<any[]>;
+export declare function handleHuntLeaderboard(agent: OneShot, args: Record<string, unknown>): Promise<any>;

package/dist/tools/hunt.js

@@ -0,0 +1,76 @@
+export const huntListTool = {
+    name: "oneshot_hunt_list",
+    description: "List active or collected Soul Hunts. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            status: { type: "string", description: "Hunt status ('active', 'captured', 'expired', etc.)", default: "active" },
+            limit: { type: "number", default: 20 },
+            offset: { type: "number", default: 0 },
+        },
+    },
+};
+export const huntStatusTool = {
+    name: "oneshot_hunt_status",
+    description: "Get detailed status, rounds, and timeline for a specific Soul Hunt. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            hunt_id: { type: "string", description: "Hunt ID or Soul Slug" },
+        },
+        required: ["hunt_id"],
+    },
+};
+export const huntPredictTool = {
+    name: "oneshot_hunt_predict",
+    description: "Submit a prediction for a Soul Hunt. Debits a stake (USDC) from your balance based on the round tier. Paid.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            hunt_id: { type: "string", description: "Hunt ID or Soul Slug" },
+            predicted_tool: { type: "string", description: "The exact tool the soul will use next (e.g., 'research', 'email_send')" },
+            predicted_action: { type: "string", description: "What the soul will do with the tool (max 500 chars)" },
+            predicted_motivation: { type: "string", description: "Why the soul will do this, based on its objective (max 500 chars)" },
+        },
+        required: ["hunt_id", "predicted_tool", "predicted_action", "predicted_motivation"],
+    },
+};
+export const huntCollectionTool = {
+    name: "oneshot_hunt_collection",
+    description: "View the souls you have successfully captured. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};
+export const huntLeaderboardTool = {
+    name: "oneshot_hunt_leaderboard",
+    description: "Get the public predictor leaderboard. Free.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            period: { type: "string", description: "Time period ('all', 'month', 'week')", default: "all" },
+            sort: { type: "string", description: "Sort column ('captures', 'score', 'earned')", default: "captures" },
+            limit: { type: "number", default: 25 },
+            offset: { type: "number", default: 0 },
+        },
+    },
+};
+// MCP clients may send explicit nulls for optional fields; map null to
+// undefined so the SDK's defaults apply instead of serializing "null".
+const opt = (v) => (v === null ? undefined : v);
+export async function handleHuntList(agent, args) {
+    return agent.hunts.list(opt(args.status), opt(args.limit), opt(args.offset));
+}
+export async function handleHuntStatus(agent, args) {
+    return agent.hunts.status(args.hunt_id);
+}
+export async function handleHuntPredict(agent, args) {
+    return agent.hunts.predict(args.hunt_id, args.predicted_tool, args.predicted_action, args.predicted_motivation);
+}
+export async function handleHuntCollection(agent, args) {
+    return agent.hunts.collection();
+}
+export async function handleHuntLeaderboard(agent, args) {
+    return agent.hunts.leaderboard(opt(args.period), opt(args.sort), opt(args.limit), opt(args.offset));
+}

package/dist/tools/index.js

@@ -22,26 +22,22 @@ import { govSolicitationsTool, handleGovSolicitations } from "./gov.js";
 import { linkedinConnectTool, linkedinAccountsTool, linkedinSyncTool, linkedinConversationsTool, linkedinMessagesTool, linkedinReplyTool, linkedinViewProfileTool, linkedinReactTool, linkedinInviteTool, linkedinWithdrawInvitationTool, handleLinkedinConnect, handleLinkedinAccounts, handleLinkedinSync, handleLinkedinConversations, handleLinkedinMessages, handleLinkedinReply, handleLinkedinViewProfile, handleLinkedinReact, handleLinkedinInvite, handleLinkedinWithdrawInvitation, } from "./linkedin.js";
 import { computeTool, computeStatusTool, computeTasksTool, computeCancelTool, computeRespondTool, computePauseTool, computeResumeTool, computeFundTool, handleCompute, handleComputeStatus, handleComputeTasks, handleComputeCancel, handleComputeRespond, handleComputePause, handleComputeResume, handleComputeFund } from "./compute.js";
 import { listDomainsTool, pauseDomainTool, resumeDomainTool, handleListDomains, handlePauseDomain, handleResumeDomain } from "./domains.js";
+import { huntListTool, huntStatusTool, huntPredictTool, huntCollectionTool, huntLeaderboardTool, handleHuntList, handleHuntStatus, handleHuntPredict, handleHuntCollection, handleHuntLeaderboard } from "./hunt.js";
 import { TOOL_ANNOTATIONS } from "./annotations.js";
 import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
-// All available tools, before annotations
 const toolDefinitions = [
-    // Communication
     emailTool,
     voiceTool,
     smsTool,
-    // Inbox
     inboxListTool,
     inboxGetTool,
     smsInboxListTool,
     smsInboxGetTool,
-    // Inbound voice
     voiceNumberProvisionTool,
     voiceNumbersTool,
     voiceInboundSetTool,
     voiceInboundDisableTool,
     voiceInboundCallsTool,
-    // Research & Enrichment
     researchTool,
     peopleSearchTool,
     enrichProfileTool,
@@ -59,10 +55,8 @@ const toolDefinitions = [
     localSearchTool,
     localResolveTool,
     govSolicitationsTool,
-    // Commerce
     commerceSearchTool,
     commerceBuyTool,
-    // Compute orchestration
     computeTool,
     computeStatusTool,
     computeTasksTool,
@@ -71,17 +65,13 @@ const toolDefinitions = [
     computePauseTool,
     computeResumeTool,
     computeFundTool,
-    // Build
     buildTool,
     updateBuildTool,
-    // Browser
     browserTool,
     browserCreateProfileTool,
     browserListProfilesTool,
     browserDeleteProfileTool,
-    // Web Read
     webReadTool,
-    // LinkedIn (human-connected account)
     linkedinConnectTool,
     linkedinAccountsTool,
     linkedinSyncTool,
@@ -91,22 +81,23 @@ const toolDefinitions = [
     linkedinInviteTool, linkedinWithdrawInvitationTool,
     linkedinViewProfileTool,
     linkedinReactTool,
-    // Domains
     listDomainsTool,
     pauseDomainTool,
     resumeDomainTool,
-    // Analytics
+    huntListTool,
+    huntStatusTool,
+    huntPredictTool,
+    huntCollectionTool,
+    huntLeaderboardTool,
     spendBreakdownTool,
     rocsTool,
     rocsByGoalTool,
     receiptsListTool,
     tagReceiptValueTool,
-    // Account
     notificationsTool,
     markReadTool,
     getBalanceTool,
     budgetStatusTool,
-    // Approvals
     approvalCreateTool,
     approvalGetTool,
     approvalListTool,
@@ -121,24 +112,19 @@ export const tools = toolDefinitions.map((tool) => {
         throw new Error(`Tool ${tool.name} has no annotations — add it to tools/annotations.ts`);
     return { ...tool, title: hints.title, annotations: { ...hints } };
 });
-// Tool handlers map
 const handlers = {
-    // Communication
     "oneshot_email": handleEmail,
     "oneshot_voice": handleVoice,
     "oneshot_sms": handleSms,
-    // Inbox
     "oneshot_inbox_list": handleInboxList,
     "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,
     "oneshot_enrich_profile": handleEnrichProfile,
@@ -156,10 +142,8 @@ const handlers = {
     "oneshot_local_search": handleLocalSearch,
     "oneshot_local_resolve": handleLocalResolve,
     "oneshot_gov_solicitations": handleGovSolicitations,
-    // Commerce
     "oneshot_commerce_search": handleCommerceSearch,
     "oneshot_commerce_buy": handleCommerceBuy,
-    // Compute orchestration
     "oneshot_compute": handleCompute,
     "oneshot_compute_status": handleComputeStatus,
     "oneshot_compute_tasks": handleComputeTasks,
@@ -168,17 +152,13 @@ const handlers = {
     "oneshot_compute_pause": handleComputePause,
     "oneshot_compute_resume": handleComputeResume,
     "oneshot_compute_fund": handleComputeFund,
-    // Build
     "oneshot_build": handleBuild,
     "oneshot_update_build": handleUpdateBuild,
-    // Browser
     "oneshot_browser": handleBrowser,
     "oneshot_browser_create_profile": handleBrowserCreateProfile,
     "oneshot_browser_list_profiles": handleBrowserListProfiles,
     "oneshot_browser_delete_profile": handleBrowserDeleteProfile,
-    // Web Read
     "oneshot_web_read": handleWebRead,
-    // LinkedIn (human-connected account)
     "oneshot_linkedin_connect": handleLinkedinConnect,
     "oneshot_linkedin_accounts": handleLinkedinAccounts,
     "oneshot_linkedin_sync": handleLinkedinSync,
@@ -189,22 +169,23 @@ const handlers = {
     "oneshot_linkedin_withdraw_invitation": handleLinkedinWithdrawInvitation,
     "oneshot_linkedin_view_profile": handleLinkedinViewProfile,
     "oneshot_linkedin_react": handleLinkedinReact,
-    // Domains
     "oneshot_list_domains": handleListDomains,
     "oneshot_pause_domain": handlePauseDomain,
     "oneshot_resume_domain": handleResumeDomain,
-    // Analytics
+    "oneshot_hunt_list": handleHuntList,
+    "oneshot_hunt_status": handleHuntStatus,
+    "oneshot_hunt_predict": handleHuntPredict,
+    "oneshot_hunt_collection": handleHuntCollection,
+    "oneshot_hunt_leaderboard": handleHuntLeaderboard,
     "oneshot_spend_breakdown": handleSpendBreakdown,
     "oneshot_return_on_spend": handleRocs,
     "oneshot_return_on_spend_by_goal": handleRocsByGoal,
     "oneshot_receipts_list": handleReceiptsList,
     "oneshot_tag_receipt_value": handleTagReceiptValue,
-    // Account
     "oneshot_notifications": handleNotifications,
     "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,

package/dist/tools/linkedin.js

@@ -1,10 +1,8 @@
 /**
  * LinkedIn messaging through a human-connected account (issue #756).
- *
- * The human connects their own LinkedIn account via a hosted login link and
- * grants specific actions (read, reply, view_profile, react, invite). Reconnect and
- * revoke are deliberately NOT exposed as MCP tools — a human decides those
- * from the application that owns the account.
+ * The human grants specific actions (read, reply, view_profile, react, invite)
+ * via a hosted login link; reconnect/revoke are deliberately NOT exposed here —
+ * a human decides those from the application that owns the account.
  */
 const GRANT_ACTIONS = ["read", "reply", "view_profile", "react", "invite", "comment"];
 export const linkedinConnectTool = {

package/dist/tools/nyne.js

@@ -72,7 +72,6 @@ export const personInteractionsTool = {
         required: ["social_media_url"],
     },
 };
-// Handlers
 /** Deep person research fans out across several providers; the SDK's 120s default was too short. */
 export const DEEP_RESEARCH_PERSON_TIMEOUT_SEC = 300;
 export async function handleDeepResearchPerson(agent, args) {

package/dist/tools/research.d.ts

@@ -2,10 +2,9 @@ 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
- * 2–5 minutes (as the tool description says), so every deep call used to end
- * in JobTimeoutError while the job kept running. Results are pushed the
- * moment they exist, so a generous ceiling costs nothing on fast jobs.
+ * The SDK's 120s default is too short for deep research (runs 2-5min);
+ * results are pushed the moment they exist, so a generous ceiling costs
+ * nothing on fast jobs.
  */
 export declare const RESEARCH_TIMEOUT_SEC: Record<"quick" | "deep", number>;
 export declare function handleResearch(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ResearchResult>;

package/dist/tools/research.js

@@ -27,10 +27,9 @@ export const researchTool = {
     },
 };
 /**
- * Wait budget per depth. The SDK's default is 120s, but deep research runs
- * 2–5 minutes (as the tool description says), so every deep call used to end
- * in JobTimeoutError while the job kept running. Results are pushed the
- * moment they exist, so a generous ceiling costs nothing on fast jobs.
+ * The SDK's 120s default is too short for deep research (runs 2-5min);
+ * results are pushed the moment they exist, so a generous ceiling costs
+ * nothing on fast jobs.
  */
 export const RESEARCH_TIMEOUT_SEC = { quick: 180, deep: 600 };
 export async function handleResearch(agent, args) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.30.1",
-  "description": "MCP server for OneShot - 73 tools for AI agents",
+  "version": "0.33.0",
+  "description": "MCP server for OneShot - 78 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.44.0",
+    "@oneshot-agent/sdk": "^0.47.0",
     "zod": "3.25.76"
   },
   "devDependencies": {