@oneshot-agent/mcp-server 0.39.1 → 0.41.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 117 tools over
+server and must not hold a wallet key. For them, OneShot hosts the same tool registry over
 Streamable HTTP at **`https://win.oneshotagent.com/mcp`**, authenticated with an
 **agent access token** and billed to the agent's credit balance:
 
@@ -169,8 +169,9 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 | Tool | Description |
 |------|-------------|
 | `oneshot_research` | Deep web research with sources |
+| `oneshot_solve` | Plan vehicle routes with constraint checks and conflicts |
 | `oneshot_person_find` | Search for people by title, company, etc. |
-| `oneshot_person_profile` | Enrich person profile from LinkedIn/email |
+| `oneshot_person_profile` | Enrich person profile from LinkedIn URL, email, or name + company |
 | `oneshot_person_email` | Find someone's email address |
 | `oneshot_person_email_status` | Verify email deliverability |
 | `oneshot_company_find` | Search for companies by industry, size, location, etc. |
@@ -205,6 +206,22 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 | `oneshot_product_find` | Search for products |
 | `oneshot_commerce_buy` | Purchase products |
 
+### Physical Mail
+
+Quote-to-pay with an explicit approval in between. Prices are on the [Pricing](https://docs.oneshotagent.com/pricing) page; the quote carries the price of each piece.
+
+| Tool | Description |
+|------|-------------|
+| `oneshot_physical_mail_upload` | Upload print-ready artwork (PDF, PNG or JPEG as base64, 20 MB max) and get its asset id |
+| `oneshot_physical_mail_validate_address` | Check that a U.S. address is deliverable |
+| `oneshot_physical_mail_preview` | Quote a letter or postcard and render an uncharged proof |
+| `oneshot_physical_mail_quote` | Read a quote |
+| `oneshot_physical_mail_approve` | Approve the exact piece and price of a quote |
+| `oneshot_physical_mail_send` | Print and post an approved piece (quote id, approval id and an idempotency key you keep) |
+| `oneshot_physical_mail_recover` | Find the order a send created, by its idempotency key |
+| `oneshot_physical_mail_order` | Read an order and its status |
+| `oneshot_physical_mail_cancel` | Ask to cancel an order (not guaranteed once submitted) |
+
 ### Build
 
 | Tool | Description |
@@ -309,9 +326,8 @@ Use oneshot_person_find:
 
 ```
 Use oneshot_person_email:
-- first_name: "John"
-- last_name: "Smith"
-- company_domain: "example.com"
+- name: "John Smith"
+- company: "Example" (a name or a domain)
 ```
 
 ### Check Wallet Balance
@@ -369,3 +385,9 @@ timeouts.
 ## Optional phone lookup
 
 `person_find`, `person_profile`, and `person_dossier` accept `include_phone`, off by default. It adds the per-person add-on listed on the pricing page × the requested search limit (default 100) for a search, or once for profile/dossier, for up to that many people with no promised hit. Existing source numbers and published business or record numbers remain available without opting in. Fallbacks and callbacks cost nothing extra; a completed no-match is charged and a failed job is refunded. Use a boolean `true` / `false`. The full quote is checked before payment.
+
+## Predict
+
+Use `oneshot_predict` with the matching model block. Supports `model: "simulation"` with a `simulation` block of named distributions and arithmetic outputs, or `model: "forecast"` with a `forecast` block containing a time series and horizon. Returns uncertainty ranges and consistency checks.
+
+See [Predict](https://docs.oneshotagent.com/api-reference/predict) for inputs, results and limits.

package/dist/index.js

@@ -50,7 +50,7 @@ async function main() {
     const agent = await initAgent();
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.39.1", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.41.0", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/dist/tools/annotations.js

@@ -7,6 +7,8 @@ const OPEN = true;
 const OWN = false;
 const DESTRUCTIVE = true;
 export const TOOL_ANNOTATIONS = {
+    oneshot_solve: read("Solve", OWN),
+    oneshot_predict: read("Predict", OWN),
     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),
@@ -24,6 +26,10 @@ export const TOOL_ANNOTATIONS = {
     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),
+    // Physical Mail (#1883): the upload stores artwork in the agent's own account; the send puts a letter in the post.
+    // The generated route tools (validate, preview, quote, approve, recover, order, cancel) get their hints from the manifest below.
+    oneshot_physical_mail_upload: write("Upload mail artwork", OWN),
+    oneshot_physical_mail_send: write("Send approved physical mail", OPEN),
     oneshot_research: read("Deep research", OPEN),
     oneshot_person_find: read("Find people", OPEN),
     oneshot_person_profile: read("Look up a person's profile", OPEN),

package/dist/tools/enrichment.d.ts

@@ -1,5 +1,38 @@
 import type { Tool } from "@modelcontextprotocol/sdk/types.js";
-import type { OneShot } from "@oneshot-agent/sdk";
+import type { OneShot, PersonIdentity } from "@oneshot-agent/sdk";
+export declare const PERSON_IDENTITY_PROPERTIES: {
+    readonly name: {
+        readonly type: "string";
+        readonly description: "Person's full name (works best with company)";
+    };
+    readonly company: {
+        readonly type: "string";
+        readonly description: "Employer name or domain, e.g. Coinbase or coinbase.com";
+    };
+    readonly email: {
+        readonly type: "string";
+        readonly description: "Person's email address";
+    };
+    readonly phone: {
+        readonly type: "string";
+        readonly description: "Person's phone number";
+    };
+    readonly profile_url: {
+        readonly type: "string";
+        readonly description: "Profile URL on LinkedIn, X or GitHub";
+    };
+    readonly linkedin_url: {
+        readonly type: "string";
+        readonly description: "Same as profile_url (older name)";
+    };
+    readonly social_media_url: {
+        readonly type: "string";
+        readonly description: "Same as profile_url (older name)";
+    };
+};
+/** The shared person shape (#1899), as the SDK's PersonIdentity. */
+declare function personIdentity(args: Record<string, unknown>): PersonIdentity;
+export { personIdentity };
 export declare const personProfileTool: Tool;
 export declare const personEmailTool: Tool;
 export declare const personEmailStatusTool: Tool;

package/dist/tools/enrichment.js

@@ -1,53 +1,51 @@
+export const PERSON_IDENTITY_PROPERTIES = {
+    name: { type: "string", description: "Person's full name (works best with company)" },
+    company: { type: "string", description: "Employer name or domain, e.g. Coinbase or coinbase.com" },
+    email: { type: "string", description: "Person's email address" },
+    phone: { type: "string", description: "Person's phone number" },
+    profile_url: { type: "string", description: "Profile URL on LinkedIn, X or GitHub" },
+    linkedin_url: { type: "string", description: "Same as profile_url (older name)" },
+    social_media_url: { type: "string", description: "Same as profile_url (older name)" },
+};
+/** The shared person shape (#1899), as the SDK's PersonIdentity. */
+function personIdentity(args) {
+    return {
+        name: args.name,
+        company: args.company,
+        email: args.email,
+        phone: args.phone,
+        profile_url: args.profile_url,
+        linkedin_url: args.linkedin_url,
+        social_media_url: args.social_media_url,
+    };
+}
+export { personIdentity };
 export const personProfileTool = {
     name: "oneshot_person_profile",
-    description: "Enrich a person's profile from LinkedIn URL, email, or name. Returns job title, company, social links, etc. Paid tool. Phone lookup is off by default. include_phone=true buys a lookup for up to one person at the add-on listed on the pricing page; no phone hit is guaranteed.",
+    description: "Enrich a person's profile from whatever you know: name (+ company), email, phone or a profile URL on LinkedIn, X or GitHub. Returns job title, company, social links, etc. Paid tool. Phone lookup is off by default. include_phone=true buys a lookup for up to one person at the add-on listed on the pricing page; no phone hit is guaranteed.",
     inputSchema: {
         type: "object",
         properties: {
             include_phone: { type: "boolean", default: false, description: "Phone lookup is off by default. include_phone=true buys a lookup for up to one person at the add-on listed on the pricing page; no phone hit is guaranteed." },
-            linkedin_url: {
-                type: "string",
-                description: "LinkedIn profile URL",
-            },
-            email: {
-                type: "string",
-                description: "Email address to enrich",
-            },
-            name: {
-                type: "string",
-                description: "Person's full name",
-            },
-            company_domain: {
-                type: "string",
-                description: "Company domain for additional context",
-            },
+            ...PERSON_IDENTITY_PROPERTIES,
+            company_domain: { type: "string", description: "Employer domain (older name; company takes a name or a domain)" },
+            company_name: { type: "string", description: "Employer name (older name; company takes a name or a domain)" },
         },
     },
 };
 export const personEmailTool = {
     name: "oneshot_person_email",
-    description: "Find email address for a person at a company. Paid tool.",
+    description: "Find a person's email address from a name and company (name or domain), a phone, or a LinkedIn, X or GitHub profile URL. Paid tool.",
     inputSchema: {
         type: "object",
         properties: {
-            full_name: {
-                type: "string",
-                description: "Person's full name",
-            },
-            first_name: {
-                type: "string",
-                description: "Person's first name (use with last_name)",
-            },
-            last_name: {
-                type: "string",
-                description: "Person's last name (use with first_name)",
-            },
-            company_domain: {
-                type: "string",
-                description: "Company domain (e.g., example.com)",
-            },
+            ...PERSON_IDENTITY_PROPERTIES,
+            full_name: { type: "string", description: "Same as name (older name)" },
+            first_name: { type: "string", description: "Person's first name (use with last_name)" },
+            last_name: { type: "string", description: "Person's last name (use with first_name)" },
+            company_domain: { type: "string", description: "Employer domain (older name; company takes a name or a domain)" },
+            company_name: { type: "string", description: "Employer name (older name; company takes a name or a domain)" },
         },
-        required: ["company_domain"],
     },
 };
 export const personEmailStatusTool = {
@@ -67,18 +65,19 @@ export const personEmailStatusTool = {
 export async function handlePersonProfile(agent, args) {
     return agent.personProfile({
         includePhone: args.include_phone,
-        linkedin_url: args.linkedin_url,
-        email: args.email,
-        name: args.name,
+        ...personIdentity(args),
         company_domain: args.company_domain,
+        company_name: args.company_name,
     });
 }
 export async function handlePersonEmail(agent, args) {
     return agent.personEmail({
+        ...personIdentity(args),
         full_name: args.full_name,
         first_name: args.first_name,
         last_name: args.last_name,
         company_domain: args.company_domain,
+        company_name: args.company_name,
     });
 }
 export async function handlePersonEmailStatus(agent, args) {

package/dist/tools/index.js

@@ -2,6 +2,8 @@ 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 { predictTool, handlePredict } from "./predict.js";
+import { solveTool, handleSolve } from "./solve.js";
 import { researchTool, handleResearch } from "./research.js";
 import { personFindTool, handlePersonFind } from "./people.js";
 import { productFindTool, commerceBuyTool, handleProductFind, handleCommerceBuy } from "./commerce.js";
@@ -25,6 +27,7 @@ import { listDomainsTool, pauseDomainTool, resumeDomainTool, handleListDomains,
 import { huntListTool, huntStatusTool, huntPredictTool, huntCollectionTool, huntLeaderboardTool, handleHuntList, handleHuntStatus, handleHuntPredict, handleHuntCollection, handleHuntLeaderboard } from "./hunt.js";
 import { TOOL_ANNOTATIONS } from "./annotations.js";
 import { lookupToolDefinitions, lookupHandlers, routeToolDefinitions, routeHandlers } from "./lookup.js";
+import { physicalMailSendTool, physicalMailUploadTool, handlePhysicalMailSend, handlePhysicalMailUpload } from "./physical-mail.js";
 import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
 const toolDefinitions = [
     emailTool,
@@ -39,6 +42,10 @@ const toolDefinitions = [
     voiceInboundSetTool,
     voiceInboundDisableTool,
     voiceInboundCallsTool,
+    solveTool,
+    predictTool,
+    physicalMailUploadTool,
+    physicalMailSendTool,
     researchTool,
     personFindTool,
     personProfileTool,
@@ -129,6 +136,10 @@ const handlers = {
     "oneshot_voice_inbound_set": handleVoiceInboundSet,
     "oneshot_voice_inbound_disable": handleVoiceInboundDisable,
     "oneshot_voice_inbound_calls": handleVoiceInboundCalls,
+    "oneshot_solve": handleSolve,
+    "oneshot_predict": handlePredict,
+    "oneshot_physical_mail_upload": handlePhysicalMailUpload,
+    "oneshot_physical_mail_send": handlePhysicalMailSend,
     "oneshot_research": handleResearch,
     "oneshot_person_find": handlePersonFind,
     "oneshot_person_profile": handlePersonProfile,