@youdotcom-oss/mcp 1.4.0 → 1.4.1

package/bin/stdio.js

@@ -6489,7 +6489,7 @@ var require_dist = __commonJS((exports, module) => {
   exports.default = formatsPlugin;
 });
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 import process3 from "node:process";
 
 // ../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/core/core.js
@@ -11524,7 +11524,7 @@ function preprocess(fn, schema) {
 // ../../node_modules/.bun/zod@4.3.5/node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
 var LATEST_PROTOCOL_VERSION = "2025-11-25";
 var SUPPORTED_PROTOCOL_VERSIONS = [LATEST_PROTOCOL_VERSION, "2025-06-18", "2025-03-26", "2024-11-05", "2024-10-07"];
 var RELATED_TASK_META_KEY = "io.modelcontextprotocol/related-task";
@@ -12366,7 +12366,7 @@ class UrlElicitationRequiredError extends McpError {
   }
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
 class ReadBuffer {
   append(chunk) {
     this._buffer = this._buffer ? Buffer.concat([this._buffer, chunk]) : chunk;
@@ -12396,7 +12396,7 @@ function serializeMessage(message) {
 `;
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 class StdioServerTransport {
   constructor(_stdin = process3.stdin, _stdout = process3.stdout) {
     this._stdin = _stdin;
@@ -12456,7 +12456,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@youdotcom-oss/mcp",
-  version: "1.4.0",
+  version: "1.4.1",
   description: "You.com API Model Context Protocol Server",
   license: "MIT",
   engines: {
@@ -12818,6 +12818,10 @@ var ExpressStructuredContentSchema = object({
 var formatSearchResultsText = (results) => {
   return results.map((result) => {
     const parts = [`Title: ${result.title}`];
+    parts.push(`URL: ${result.url}`);
+    if (result.page_age) {
+      parts.push(`Published: ${result.page_age}`);
+    }
     if (result.description) {
       parts.push(`Description: ${result.description}`);
     }
@@ -16843,7 +16847,7 @@ function object2(shape, params) {
   };
   return new ZodMiniObject(def);
 }
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
 function isZ4Schema(s) {
   const schema = s;
   return !!schema._zod;
@@ -16987,7 +16991,7 @@ function getLiteralValue(schema) {
   return;
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
 function isTerminal(status) {
   return status === "completed" || status === "failed" || status === "cancelled";
 }
@@ -18228,7 +18232,7 @@ var zodToJsonSchema = (schema, options) => {
   }
   return combined;
 };
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
 function mapMiniTarget(t) {
   if (!t)
     return "draft-7";
@@ -18270,7 +18274,7 @@ function parseWithCompat(schema, data) {
   return result.data;
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
 var DEFAULT_REQUEST_TIMEOUT_MSEC = 60000;
 
 class Protocol {
@@ -19093,7 +19097,7 @@ function mergeCapabilities(base, additional) {
   return result;
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
 var import_ajv = __toESM(require_ajv(), 1);
 var import_ajv_formats = __toESM(require_dist(), 1);
 function createDefaultAjvInstance() {
@@ -19133,7 +19137,7 @@ class AjvJsonSchemaValidator {
   }
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
 class ExperimentalServerTasks {
   constructor(_server) {
     this._server = _server;
@@ -19155,7 +19159,7 @@ class ExperimentalServerTasks {
   }
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
 function assertToolsCallTaskCapability(requests, method, entityName) {
   if (!requests) {
     throw new Error(`${entityName} does not support task creation (required for ${method})`);
@@ -19190,7 +19194,7 @@ function assertClientRequestTaskCapability(requests, method, entityName) {
   }
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
 class Server extends Protocol {
   constructor(_serverInfo, options) {
     super(options);
@@ -19523,7 +19527,7 @@ class Server extends Protocol {
   }
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
 var COMPLETABLE_SYMBOL = Symbol.for("mcp.completable");
 function isCompletable(schema) {
   return !!schema && typeof schema === "object" && COMPLETABLE_SYMBOL in schema;
@@ -19537,7 +19541,7 @@ var McpZodTypeKind;
   McpZodTypeKind2["Completable"] = "McpCompletable";
 })(McpZodTypeKind || (McpZodTypeKind = {}));
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
 var TOOL_NAME_REGEX = /^[A-Za-z0-9._-]{1,128}$/;
 function validateToolName(name) {
   const warnings = [];
@@ -19595,7 +19599,7 @@ function validateAndWarnToolName(name) {
   return result.isValid;
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
 class ExperimentalMcpServerTasks {
   constructor(_mcpServer) {
     this._mcpServer = _mcpServer;
@@ -19610,7 +19614,7 @@ class ExperimentalMcpServerTasks {
   }
 }
 
-// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
+// ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.2+fd698e00a3b2abce/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
 class McpServer {
   constructor(serverInfo, options) {
     this._registeredResources = {};
@@ -20441,11 +20445,13 @@ var SearchStructuredContentSchema = object({
   results: object({
     web: array(object({
       url: string2().describe("URL"),
-      title: string2().describe("Title")
+      title: string2().describe("Title"),
+      page_age: string2().optional().describe("Publication timestamp")
     })).optional().describe("Web results"),
     news: array(object({
       url: string2().describe("URL"),
-      title: string2().describe("Title")
+      title: string2().describe("Title"),
+      page_age: string2().describe("Publication timestamp")
     })).optional().describe("News results")
   }).optional().describe("Search results")
 });
@@ -20505,6 +20511,7 @@ ${webResults}`;
   }
   if (response.results.news?.length) {
     const newsResults = response.results.news.map((article) => `Title: ${article.title}
+URL: ${article.url}
 Description: ${article.description}
 Published: ${article.page_age}`).join(`
 
@@ -20524,15 +20531,21 @@ ${newsResults}`;
   }
   const structuredResults = {};
   if (response.results.web?.length) {
-    structuredResults.web = response.results.web.map((result) => ({
-      url: result.url,
-      title: result.title
-    }));
+    structuredResults.web = response.results.web.map((result) => {
+      const item = {
+        url: result.url,
+        title: result.title
+      };
+      if (result.page_age)
+        item.page_age = result.page_age;
+      return item;
+    });
   }
   if (response.results.news?.length) {
     structuredResults.news = response.results.news.map((article) => ({
       url: article.url,
-      title: article.title
+      title: article.title,
+      page_age: article.page_age
     }));
   }
   return {

package/dist/search/search.schemas.d.ts

@@ -120,10 +120,12 @@ export declare const SearchStructuredContentSchema: z.ZodObject<{
         web: z.ZodOptional<z.ZodArray<z.ZodObject<{
             url: z.ZodString;
             title: z.ZodString;
+            page_age: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         news: z.ZodOptional<z.ZodArray<z.ZodObject<{
             url: z.ZodString;
             title: z.ZodString;
+            page_age: z.ZodString;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/search/search.utils.d.ts

@@ -52,10 +52,12 @@ export declare const formatSearchResults: (response: SearchResponse) => {
             web?: Array<{
                 url: string;
                 title: string;
+                page_age?: string;
             }>;
             news?: Array<{
                 url: string;
                 title: string;
+                page_age: string;
             }>;
         } | undefined;
     };

package/dist/shared/format-search-results-text.d.ts

@@ -8,12 +8,12 @@ type GenericSearchResult = {
     description?: string;
     snippet?: string;
     snippets?: string[];
+    page_age?: string;
 };
 /**
  * Format array of search results into display text
  * Used by both search and express agent formatting
  * @param results - Array of search results to format
- * @param includeUrls - Whether to include URLs in the text (default: true)
  */
 export declare const formatSearchResultsText: (results: GenericSearchResult[]) => string;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/mcp",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "You.com API Model Context Protocol Server",
   "license": "MIT",
   "engines": {

package/src/express/tests/express.utils.spec.ts

@@ -148,14 +148,14 @@ describe('formatExpressAgentResponse', () => {
     expect(result.content[0]?.text).toContain('Express Agent Answer');
     expect(result.content[0]?.text).toContain('Quantum computing is advancing rapidly');
 
-    // Verify search results come SECOND (without URLs in text)
+    // Verify search results come SECOND
     expect(result.content[1]?.type).toBe('text');
     expect(result.content[1]?.text).toContain('Search Results');
     expect(result.content[1]?.text).toContain('Quantum Computing Breakthrough');
     expect(result.content[1]?.text).toContain('Latest in Quantum Research');
-    // URLs should NOT be in text content
-    expect(result.content[1]?.text).not.toContain('https://example.com/quantum1');
-    expect(result.content[1]?.text).not.toContain('https://example.com/quantum2');
+    // URLs should be in text content
+    expect(result.content[1]?.text).toContain('https://example.com/quantum1');
+    expect(result.content[1]?.text).toContain('https://example.com/quantum2');
 
     // Verify structuredContent is minimal with counts
     expect(result.structuredContent).toHaveProperty('answer');

package/src/search/search.schemas.ts

@@ -124,6 +124,7 @@ export const SearchStructuredContentSchema = z.object({
           z.object({
             url: z.string().describe('URL'),
             title: z.string().describe('Title'),
+            page_age: z.string().optional().describe('Publication timestamp'),
           }),
         )
         .optional()
@@ -133,6 +134,7 @@ export const SearchStructuredContentSchema = z.object({
           z.object({
             url: z.string().describe('URL'),
             title: z.string().describe('Title'),
+            page_age: z.string().describe('Publication timestamp'),
           }),
         )
         .optional()

package/src/search/search.utils.ts

@@ -82,18 +82,18 @@ export const fetchSearchResults = async ({
 export const formatSearchResults = (response: SearchResponse) => {
   let formattedResults = '';
 
-  // Format web results using shared utility (without URLs in text)
+  // Format web results using shared utility
   if (response.results.web?.length) {
     const webResults = formatSearchResultsText(response.results.web);
     formattedResults += `WEB RESULTS:\n\n${webResults}`;
   }
 
-  // Format news results (without URLs in text)
+  // Format news results
   if (response.results.news?.length) {
     const newsResults = response.results.news
       .map(
         (article: NewsResult) =>
-          `Title: ${article.title}\nDescription: ${article.description}\nPublished: ${article.page_age}`,
+          `Title: ${article.title}\nURL: ${article.url}\nDescription: ${article.description}\nPublished: ${article.page_age}`,
       )
       .join('\n\n---\n\n');
 
@@ -103,23 +103,28 @@ export const formatSearchResults = (response: SearchResponse) => {
     formattedResults += `NEWS RESULTS:\n\n${newsResults}`;
   }
 
-  // Extract URLs and titles for structuredContent
+  // Extract fields for structuredContent
   const structuredResults: {
-    web?: Array<{ url: string; title: string }>;
-    news?: Array<{ url: string; title: string }>;
+    web?: Array<{ url: string; title: string; page_age?: string }>;
+    news?: Array<{ url: string; title: string; page_age: string }>;
   } = {};
 
   if (response.results.web?.length) {
-    structuredResults.web = response.results.web.map((result) => ({
-      url: result.url,
-      title: result.title,
-    }));
+    structuredResults.web = response.results.web.map((result) => {
+      const item: { url: string; title: string; page_age?: string } = {
+        url: result.url,
+        title: result.title,
+      };
+      if (result.page_age) item.page_age = result.page_age;
+      return item;
+    });
   }
 
   if (response.results.news?.length) {
     structuredResults.news = response.results.news.map((article) => ({
       url: article.url,
       title: article.title,
+      page_age: article.page_age,
     }));
   }
 

package/src/search/tests/search.utils.spec.ts

@@ -169,19 +169,21 @@ describe('formatSearchResults', () => {
     expect(result.content[0]).toHaveProperty('text');
     expect(result.content[0]?.text).toContain('WEB RESULTS:');
     expect(result.content[0]?.text).toContain('Test Title');
-    // URLs should NOT be in text content
-    expect(result.content[0]?.text).not.toContain('https://example.com');
+    // URL and page_age should be in text content
+    expect(result.content[0]?.text).toContain('URL: https://example.com');
+    expect(result.content[0]?.text).toContain('Published: 2023-01-01T00:00:00');
     expect(result.structuredContent).toHaveProperty('resultCounts');
     expect(result.structuredContent.resultCounts).toHaveProperty('web', 1);
     expect(result.structuredContent.resultCounts).toHaveProperty('news', 0);
     expect(result.structuredContent.resultCounts).toHaveProperty('total', 1);
-    // URLs should be in structuredContent.results
+    // All fields should be in structuredContent.results
     expect(result.structuredContent).toHaveProperty('results');
     expect(result.structuredContent.results?.web).toBeDefined();
     expect(result.structuredContent.results?.web?.length).toBe(1);
-    expect(result.structuredContent.results?.web?.[0]).toEqual({
+    expect(result.structuredContent.results?.web?.[0]).toMatchObject({
       url: 'https://example.com',
       title: 'Test Title',
+      page_age: '2023-01-01T00:00:00',
     });
     expect(result.fullResponse).toBe(mockResponse);
   });
@@ -211,19 +213,20 @@ describe('formatSearchResults', () => {
     expect(result.content[0]?.text).toContain('NEWS RESULTS:');
     expect(result.content[0]?.text).toContain('News Title');
     expect(result.content[0]?.text).toContain('Published: 2023-01-01T00:00:00');
-    // URLs should NOT be in text content
-    expect(result.content[0]?.text).not.toContain('https://news.com/article');
+    // URL should be in text content
+    expect(result.content[0]?.text).toContain('URL: https://news.com/article');
     expect(result.structuredContent).toHaveProperty('resultCounts');
     expect(result.structuredContent.resultCounts).toHaveProperty('web', 0);
     expect(result.structuredContent.resultCounts).toHaveProperty('news', 1);
     expect(result.structuredContent.resultCounts).toHaveProperty('total', 1);
-    // URLs should be in structuredContent.results
+    // All fields should be in structuredContent.results
     expect(result.structuredContent).toHaveProperty('results');
     expect(result.structuredContent.results?.news).toBeDefined();
     expect(result.structuredContent.results?.news?.length).toBe(1);
-    expect(result.structuredContent.results?.news?.[0]).toEqual({
+    expect(result.structuredContent.results?.news?.[0]).toMatchObject({
       url: 'https://news.com/article',
       title: 'News Title',
+      page_age: '2023-01-01T00:00:00',
     });
   });
 
@@ -261,25 +264,27 @@ describe('formatSearchResults', () => {
     expect(result.content[0]?.text).toContain('WEB RESULTS:');
     expect(result.content[0]?.text).toContain('NEWS RESULTS:');
     expect(result.content[0]?.text).toContain(`=${'='.repeat(49)}`);
-    // URLs should NOT be in text content
-    expect(result.content[0]?.text).not.toContain('https://web.com');
-    expect(result.content[0]?.text).not.toContain('https://news.com/article');
+    // URLs should be in text content
+    expect(result.content[0]?.text).toContain('URL: https://web.com');
+    expect(result.content[0]?.text).toContain('URL: https://news.com/article');
     expect(result.structuredContent.resultCounts).toHaveProperty('web', 1);
     expect(result.structuredContent.resultCounts).toHaveProperty('news', 1);
     expect(result.structuredContent.resultCounts).toHaveProperty('total', 2);
-    // URLs should be in structuredContent.results
+    // All fields should be in structuredContent.results
     expect(result.structuredContent).toHaveProperty('results');
     expect(result.structuredContent.results?.web).toBeDefined();
     expect(result.structuredContent.results?.news).toBeDefined();
     expect(result.structuredContent.results?.web?.length).toBe(1);
     expect(result.structuredContent.results?.news?.length).toBe(1);
-    expect(result.structuredContent.results?.web?.[0]).toEqual({
+    expect(result.structuredContent.results?.web?.[0]).toMatchObject({
       url: 'https://web.com',
       title: 'Web Title',
+      page_age: '2023-01-01T00:00:00',
     });
-    expect(result.structuredContent.results?.news?.[0]).toEqual({
+    expect(result.structuredContent.results?.news?.[0]).toMatchObject({
       url: 'https://news.com/article',
       title: 'News Title',
+      page_age: '2023-01-01T00:00:00',
     });
   });
 });

package/src/shared/format-search-results-text.ts

@@ -8,19 +8,27 @@ type GenericSearchResult = {
   description?: string;
   snippet?: string;
   snippets?: string[];
+  page_age?: string;
 };
 
 /**
  * Format array of search results into display text
  * Used by both search and express agent formatting
  * @param results - Array of search results to format
- * @param includeUrls - Whether to include URLs in the text (default: true)
  */
 export const formatSearchResultsText = (results: GenericSearchResult[]): string => {
   return results
     .map((result) => {
       const parts: string[] = [`Title: ${result.title}`];
 
+      // Add URL
+      parts.push(`URL: ${result.url}`);
+
+      // Add page age if present
+      if (result.page_age) {
+        parts.push(`Published: ${result.page_age}`);
+      }
+
       // Add description if present (from Search API)
       if (result.description) {
         parts.push(`Description: ${result.description}`);

package/src/tests/tool.spec.ts

@@ -85,8 +85,8 @@ describe('registerSearchTool', () => {
       const text = content[0]?.text;
       expect(text).toContain('WEB RESULTS:');
       expect(text).toContain('Title:');
-      // URL should NOT be in text content anymore
-      expect(text).not.toContain('URL:');
+      // URL should be in text content
+      expect(text).toContain('URL:');
       expect(text).toContain('Description:');
       expect(text).toContain('Snippets:');