@oneshot-agent/mcp-server 0.37.0 → 0.38.0

package/README.md

@@ -202,7 +202,7 @@ Soul Hunt is a separate service (`api.soulhunt.ai`) from the main OneShot API; t
 
 | Tool | Description |
 |------|-------------|
-| `oneshot_commerce_search` | Search for products |
+| `oneshot_product_find` | Search for products |
 | `oneshot_commerce_buy` | Purchase products |
 
 ### Build
@@ -365,3 +365,7 @@ timeouts.
 - [Python SDK (LangChain)](https://pypi.org/project/langchain-oneshot/)
 - [Python SDK (Core)](https://pypi.org/project/oneshot-python/)
 - [GitHub](https://github.com/oneshot-agent/sdk)
+
+## Optional phone lookup
+
+`person_find`, `person_profile`, and `person_dossier` accept `include_phone`, off by default. It adds $0.10 × the requested search limit (default 100 → $10), or $0.10 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.

package/dist/index.js

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

package/dist/tools/annotations.js

@@ -41,7 +41,7 @@ export const TOOL_ANNOTATIONS = {
     oneshot_business_find: read("Find local businesses", OPEN),
     oneshot_business_resolve: read("Look up a local business", OPEN),
     oneshot_record_solicitations_find: read("Find government contracts", OPEN),
-    oneshot_commerce_search: read("Search products", OPEN),
+    oneshot_product_find: read("Search products", OPEN),
     oneshot_commerce_buy: write("Buy a product", OPEN),
     oneshot_compute: write("Start a goal", OPEN),
     oneshot_compute_status: read("Check a goal", OWN),

package/dist/tools/commerce.d.ts

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

package/dist/tools/commerce.js

@@ -1,6 +1,6 @@
-export const commerceSearchTool = {
-    name: "oneshot_commerce_search",
-    description: "Search for products to purchase. Free to search, pay only when buying.",
+export const productFindTool = {
+    name: "oneshot_product_find",
+    description: "Search for products to purchase. Each search is paid, separately from buying.",
     inputSchema: {
         type: "object",
         properties: {
@@ -58,8 +58,8 @@ export const commerceBuyTool = {
         required: ["product_url", "shipping_address"],
     },
 };
-export async function handleCommerceSearch(agent, args) {
-    return agent.commerceSearch({
+export async function handleProductFind(agent, args) {
+    return agent.productFind({
         query: args.query,
         limit: args.limit,
     });

package/dist/tools/enrichment.js

@@ -1,9 +1,10 @@
 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.",
+    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.",
     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",
@@ -65,6 +66,7 @@ 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,

package/dist/tools/index.js

@@ -4,7 +4,7 @@ import { voiceNumberProvisionTool, voiceNumbersTool, voiceInboundSetTool, voiceI
 import { smsTool, handleSms } from "./sms.js";
 import { researchTool, handleResearch } from "./research.js";
 import { personFindTool, handlePersonFind } from "./people.js";
-import { commerceSearchTool, commerceBuyTool, handleCommerceSearch, handleCommerceBuy } from "./commerce.js";
+import { productFindTool, commerceBuyTool, handleProductFind, handleCommerceBuy } from "./commerce.js";
 import { personProfileTool, personEmailTool, personEmailStatusTool, handlePersonProfile, handlePersonEmail, handlePersonEmailStatus } from "./enrichment.js";
 import { inboxListTool, inboxGetTool, handleInboxList, handleInboxGet } from "./inbox.js";
 import { smsInboxListTool, smsInboxGetTool, handleSmsInboxList, handleSmsInboxGet } from "./sms-inbox.js";
@@ -56,7 +56,7 @@ const toolDefinitions = [
     businessFindTool,
     businessResolveTool,
     recordSolicitationsFindTool,
-    commerceSearchTool,
+    productFindTool,
     commerceBuyTool,
     computeTool,
     computeStatusTool,
@@ -146,7 +146,7 @@ const handlers = {
     "oneshot_business_find": handleBusinessFind,
     "oneshot_business_resolve": handleBusinessResolve,
     "oneshot_record_solicitations_find": handleRecordSolicitationsFind,
-    "oneshot_commerce_search": handleCommerceSearch,
+    "oneshot_product_find": handleProductFind,
     "oneshot_commerce_buy": handleCommerceBuy,
     "oneshot_compute": handleCompute,
     "oneshot_compute_status": handleComputeStatus,

package/dist/tools/lookup-manifest.generated.js

@@ -550,6 +550,76 @@ export const LOOKUP_MANIFEST = [
             "longitude": -95.3698
         }
     },
+    {
+        "name": "market_freight_rate",
+        "path": "lookup/market-freight-rate",
+        "title": "Freight Rate Quote",
+        "description": "Quote the rate to move freight between two US ZIP codes on a pickup date, by mode: ltl shares a trailer by the pallet, ftl is a whole 53-foot dry van, van is a cargo van and box_truck is a 26-foot box truck. The answer is one carrier's quote for that lane: the rate for the whole shipment with every included service, the transit time, the pickup and delivery dates, when the quote lapses and whether it is firm or indicative. Use it to check a billed freight charge against the lane's going rate. For ltl give the pallets, the weight per pallet and the pallet dimensions; for van and box_truck give the pallets and the weight per pallet; for ftl the lane and date are enough. A lane the mode does not serve is refused as invalid input: try another mode. Covers US lanes. Nothing is booked.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "origin_zip": {
+                    "type": "string",
+                    "description": "Where the freight is collected. 5-digit US ZIP code."
+                },
+                "destination_zip": {
+                    "type": "string",
+                    "description": "Where the freight is delivered. 5-digit US ZIP code."
+                },
+                "mode": {
+                    "type": "string",
+                    "enum": [
+                        "ltl",
+                        "ftl",
+                        "van",
+                        "box_truck"
+                    ],
+                    "description": "How the freight moves. Picks the quote asked for; there is no default"
+                },
+                "pickup_date": {
+                    "type": "string",
+                    "description": "The day the freight is collected: today (UTC) or later. YYYY-MM-DD."
+                },
+                "pallets": {
+                    "type": "integer",
+                    "description": "How many pallets. Required for ltl, van (up to 3) and box_truck (up to 12); not needed for ftl. At least 1."
+                },
+                "weight_lbs_per_pallet": {
+                    "type": "integer",
+                    "description": "The weight of each pallet in pounds. Required for ltl, van (3,500 lb in all) and box_truck (10,000 lb in all); not needed for ftl. At least 1."
+                },
+                "length_in": {
+                    "type": "integer",
+                    "description": "The length of each pallet in inches. Required for ltl; ignored for other modes. At least 1."
+                },
+                "width_in": {
+                    "type": "integer",
+                    "description": "The width of each pallet in inches. Required for ltl; ignored for other modes. At least 1."
+                },
+                "height_in": {
+                    "type": "integer",
+                    "description": "The height of each pallet in inches, up to 85. Required for ltl; ignored for other modes. At least 1."
+                }
+            },
+            "required": [
+                "origin_zip",
+                "destination_zip",
+                "mode",
+                "pickup_date"
+            ]
+        },
+        "example": {
+            "origin_zip": "90012",
+            "destination_zip": "94105",
+            "mode": "ltl",
+            "pickup_date": "2026-10-20",
+            "pallets": 2,
+            "weight_lbs_per_pallet": 800,
+            "length_in": 48,
+            "width_in": 40,
+            "height_in": 48
+        }
+    },
     {
         "name": "person_health_provider",
         "path": "lookup/person-health-provider",
@@ -1147,7 +1217,7 @@ export const ROUTE_MANIFEST = [
         "paid": true,
         "readOnly": true,
         "title": "Changes",
-        "description": "What changed about one entity since a date, from the observations OneShot recorded: each change has the earlier value, the later value, when it was seen and the source. Give `attribute` (the name of a data tool that keeps history), `since`, and exactly one of `key` and `input`. A window with no changes is a completed, charged result. Paid per call.",
+        "description": "What changed about one entity since a date, from the observations OneShot recorded: each change has the earlier value, the later value, when it was seen and the source. Give `attribute` (the name of a data tool that keeps history), `since`, and exactly one of `key` and `input`. For healthcare_exclusions, input selects a held monthly release and optional exact name/NPI/UPIN; returns row membership and full-row additions/removals, with coverage. A corrected row is removal plus addition, never person identity. A window with no changes is a completed, charged result. Paid per call.",
         "inputSchema": {
             "type": "object",
             "properties": {
@@ -1161,7 +1231,7 @@ export const ROUTE_MANIFEST = [
                 },
                 "input": {
                     "type": "object",
-                    "description": "Input a search was called with, for a stored search. Give exactly one of key and input"
+                    "description": "Stored search input; healthcare_exclusions accepts {entity: person|company, release: YYYY-MM, name? | npi? | upin?, previous_release?, after?}. Exact row membership, not person identity. Give exactly one of key and input"
                 },
                 "source": {
                     "type": "string",
@@ -1169,7 +1239,7 @@ export const ROUTE_MANIFEST = [
                 },
                 "since": {
                     "type": "string",
-                    "description": "First day of the window, YYYY-MM-DD"
+                    "description": "First day of the window, YYYY-MM-DD; optional for healthcare_exclusions monthly releases"
                 },
                 "until": {
                     "type": "string",
@@ -1181,8 +1251,7 @@ export const ROUTE_MANIFEST = [
                 }
             },
             "required": [
-                "attribute",
-                "since"
+                "attribute"
             ]
         },
         "example": {

package/dist/tools/nyne.js

@@ -1,9 +1,10 @@
 export const personDossierTool = {
     name: "oneshot_person_dossier",
-    description: "Get a person’s profile, known social accounts, articles, posts and written summary. Takes 2-5 minutes. Paid tool.",
+    description: "Get a person’s profile, known social accounts, articles, posts and written summary. Takes 2-5 minutes. 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." },
             email: { type: "string", description: "Person's email address" },
             social_media_url: { type: "string", description: "LinkedIn, Twitter, or other social profile URL" },
             name: { type: "string", description: "Person's full name" },
@@ -76,6 +77,7 @@ export const personFollowersTool = {
 export const PERSON_DOSSIER_TIMEOUT_SEC = 300;
 export async function handlePersonDossier(agent, args) {
     return agent.personDossier({
+        includePhone: args.include_phone,
         email: args.email,
         social_media_url: args.social_media_url,
         name: args.name,

package/dist/tools/people.js

@@ -1,9 +1,10 @@
 export const personFindTool = {
     name: "oneshot_person_find",
-    description: "Search for people by job title, company, location, skills, etc. Returns professional profiles. Paid tool — quote provided before payment.",
+    description: "Search for people by job title, company, location, skills, etc. Returns professional profiles. Paid tool — quote provided before payment. Phone lookup is off by default. include_phone=true buys lookups for up to the requested limit (default 100) at the per-person 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 lookups for up to the requested limit (default 100) at the per-person add-on listed on the pricing page; no phone hit is guaranteed." },
             job_titles: {
                 type: "array",
                 items: { type: "string" },
@@ -57,6 +58,7 @@ export const personFindTool = {
 };
 export async function handlePersonFind(agent, args) {
     return agent.personFind({
+        includePhone: args.include_phone,
         job_titles: args.job_titles,
         keywords: args.keywords,
         companies: args.companies,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "MCP server for OneShot - 81 tools for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,7 @@
   "dependencies": {
     "@coinbase/cdp-sdk": "1.45.0",
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@oneshot-agent/sdk": "^0.52.0",
+    "@oneshot-agent/sdk": "^0.53.0",
     "zod": "3.25.76"
   },
   "devDependencies": {