@youdotcom-oss/mcp 1.3.7 → 1.3.8

package/README.md

@@ -22,6 +22,8 @@ Visit [you.com/platform/api-keys](https://you.com/platform/api-keys) to get your
 
 ### 2. Choose your setup
 
+You can discover this server in the [Anthropic MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.youdotcom-oss/mcp`, or configure it manually:
+
 **Remote server (recommended)** - No installation, always up-to-date, just add the URL and API key
 - Use `https://api.you.com/mcp` with HTTP transport
 - Authentication via `Authorization: Bearer <your-key>` header

package/bin/stdio.js

@@ -12155,7 +12155,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@youdotcom-oss/mcp",
-  version: "1.3.7",
+  version: "1.3.8",
   description: "You.com API Model Context Protocol Server",
   license: "MIT",
   engines: {
@@ -12214,6 +12214,7 @@ var package_default = {
     "test:coverage:watch": "bun test --coverage --watch",
     "test:watch": "bun test --watch"
   },
+  mcpName: "io.github.youdotcom-oss/mcp",
   dependencies: {
     zod: "^4.1.13",
     "@hono/mcp": "^0.2.0",
@@ -20062,8 +20063,8 @@ var getMCpServer = () => new McpServer({
 // src/search/search.schemas.ts
 var SearchQuerySchema = object({
   query: string2().min(1, "Query is required").describe("Search query (supports +, -, site:, filetype:, lang:)"),
-  count: number2().int().min(1).max(20).optional().describe("Max results per section"),
-  freshness: _enum(["day", "week", "month", "year"]).optional().describe("Filter by freshness"),
+  count: number2().int().min(1).max(100).optional().describe("Max results per section"),
+  freshness: string2().optional().describe("day/week/month/year or YYYY-MM-DDtoYYYY-MM-DD"),
   offset: number2().int().min(0).max(9).optional().describe("Pagination offset"),
   country: _enum([
     "AR",
@@ -20108,7 +20109,9 @@ var SearchQuerySchema = object({
   fileType: string2().optional().describe("File type"),
   language: string2().optional().describe("ISO 639-1 language code"),
   excludeTerms: string2().optional().describe("Terms to exclude (pipe-separated)"),
-  exactTerms: string2().optional().describe("Exact terms (pipe-separated)")
+  exactTerms: string2().optional().describe("Exact terms (pipe-separated)"),
+  livecrawl: _enum(["web", "news", "all"]).optional().describe("Live-crawl sections for full content"),
+  livecrawl_formats: _enum(["html", "markdown"]).optional().describe("Format for crawled content")
 });
 var WebResultSchema = object({
   url: string2().describe("URL"),
@@ -20116,16 +20119,27 @@ var WebResultSchema = object({
   description: string2().describe("Description"),
   snippets: array(string2()).describe("Content snippets"),
   page_age: string2().optional().describe("Publication timestamp"),
-  authors: array(string2()).optional().describe("Authors")
+  authors: array(string2()).optional().describe("Authors"),
+  thumbnail_url: string2().optional().describe("Thumbnail image URL"),
+  favicon_url: string2().optional().describe("Favicon URL"),
+  contents: object({
+    html: string2().optional().describe("Full HTML content"),
+    markdown: string2().optional().describe("Full Markdown content")
+  }).optional().describe("Live-crawled page content")
 });
 var NewsResultSchema = object({
   title: string2().describe("Title"),
   description: string2().describe("Description"),
   page_age: string2().describe("Publication timestamp"),
-  url: string2().describe("URL")
+  url: string2().describe("URL"),
+  thumbnail_url: string2().optional().describe("Thumbnail image URL"),
+  contents: object({
+    html: string2().optional().describe("Full HTML content"),
+    markdown: string2().optional().describe("Full Markdown content")
+  }).optional().describe("Live-crawled page content")
 });
 var MetadataSchema = object({
-  request_uuid: string2().optional().describe("Request ID"),
+  search_uuid: string2().optional().describe("Unique search request ID"),
   query: string2().describe("Query"),
   latency: number2().describe("Latency in seconds")
 });
@@ -20164,7 +20178,7 @@ var fetchSearchResults = async ({
   const searchParams = new URLSearchParams;
   const searchQuery = [query];
   site && searchQuery.push(`site:${site}`);
-  fileType && searchQuery.push(`fileType:${fileType}`);
+  fileType && searchQuery.push(`filetype:${fileType}`);
   language && searchQuery.push(`lang:${language}`);
   if (exactTerms && excludeTerms) {
     throw new Error("Cannot specify both exactTerms and excludeTerms - please use only one");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/mcp",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "You.com API Model Context Protocol Server",
   "license": "MIT",
   "engines": {
@@ -59,6 +59,7 @@
     "test:coverage:watch": "bun test --coverage --watch",
     "test:watch": "bun test --watch"
   },
+  "mcpName": "io.github.youdotcom-oss/mcp",
   "dependencies": {
     "zod": "^4.1.13",
     "@hono/mcp": "^0.2.0",

package/src/search/search.schemas.ts

@@ -2,8 +2,8 @@ import * as z from 'zod';
 
 export const SearchQuerySchema = z.object({
   query: z.string().min(1, 'Query is required').describe('Search query (supports +, -, site:, filetype:, lang:)'),
-  count: z.number().int().min(1).max(20).optional().describe('Max results per section'),
-  freshness: z.enum(['day', 'week', 'month', 'year']).optional().describe('Filter by freshness'),
+  count: z.number().int().min(1).max(100).optional().describe('Max results per section'),
+  freshness: z.string().optional().describe('day/week/month/year or YYYY-MM-DDtoYYYY-MM-DD'),
   offset: z.number().int().min(0).max(9).optional().describe('Pagination offset'),
   country: z
     .enum([
@@ -52,6 +52,8 @@ export const SearchQuerySchema = z.object({
   language: z.string().optional().describe('ISO 639-1 language code'),
   excludeTerms: z.string().optional().describe('Terms to exclude (pipe-separated)'),
   exactTerms: z.string().optional().describe('Exact terms (pipe-separated)'),
+  livecrawl: z.enum(['web', 'news', 'all']).optional().describe('Live-crawl sections for full content'),
+  livecrawl_formats: z.enum(['html', 'markdown']).optional().describe('Format for crawled content'),
 });
 
 export type SearchQuery = z.infer<typeof SearchQuerySchema>;
@@ -63,6 +65,15 @@ const WebResultSchema = z.object({
   snippets: z.array(z.string()).describe('Content snippets'),
   page_age: z.string().optional().describe('Publication timestamp'),
   authors: z.array(z.string()).optional().describe('Authors'),
+  thumbnail_url: z.string().optional().describe('Thumbnail image URL'),
+  favicon_url: z.string().optional().describe('Favicon URL'),
+  contents: z
+    .object({
+      html: z.string().optional().describe('Full HTML content'),
+      markdown: z.string().optional().describe('Full Markdown content'),
+    })
+    .optional()
+    .describe('Live-crawled page content'),
 });
 
 const NewsResultSchema = z.object({
@@ -70,12 +81,20 @@ const NewsResultSchema = z.object({
   description: z.string().describe('Description'),
   page_age: z.string().describe('Publication timestamp'),
   url: z.string().describe('URL'),
+  thumbnail_url: z.string().optional().describe('Thumbnail image URL'),
+  contents: z
+    .object({
+      html: z.string().optional().describe('Full HTML content'),
+      markdown: z.string().optional().describe('Full Markdown content'),
+    })
+    .optional()
+    .describe('Live-crawled page content'),
 });
 
 export type NewsResult = z.infer<typeof NewsResultSchema>;
 
 const MetadataSchema = z.object({
-  request_uuid: z.string().optional().describe('Request ID'),
+  search_uuid: z.string().optional().describe('Unique search request ID'),
   query: z.string().describe('Query'),
   latency: z.number().describe('Latency in seconds'),
 });
@@ -91,7 +110,7 @@ export const SearchResponseSchema = z.object({
 export type SearchResponse = z.infer<typeof SearchResponseSchema>;
 
 // Minimal schema for structuredContent (reduces payload duplication)
-// Excludes metadata (query, request_uuid, latency) as these are not actionable by LLM
+// Excludes metadata (query, search_uuid, latency) as these are not actionable by LLM
 export const SearchStructuredContentSchema = z.object({
   resultCounts: z.object({
     web: z.number().describe('Web results'),

package/src/search/search.utils.ts

@@ -18,7 +18,7 @@ export const fetchSearchResults = async ({
   // Build Query Param
   const searchQuery = [query];
   site && searchQuery.push(`site:${site}`);
-  fileType && searchQuery.push(`fileType:${fileType}`);
+  fileType && searchQuery.push(`filetype:${fileType}`);
   language && searchQuery.push(`lang:${language}`);
   if (exactTerms && excludeTerms) {
     throw new Error('Cannot specify both exactTerms and excludeTerms - please use only one');

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

@@ -22,8 +22,8 @@ describe('fetchSearchResults', () => {
     expect(typeof result.metadata?.query).toBe('string');
 
     // Optional fields: only assert type if present
-    if (result.metadata?.request_uuid !== undefined) {
-      expect(typeof result.metadata.request_uuid).toBe('string');
+    if (result.metadata?.search_uuid !== undefined) {
+      expect(typeof result.metadata.search_uuid).toBe('string');
     }
   });
 
@@ -66,6 +66,52 @@ describe('fetchSearchResults', () => {
     expect(newsResult).toHaveProperty('description');
     expect(newsResult).toHaveProperty('page_age');
   });
+
+  test('handles livecrawl parameters', async () => {
+    const result = await fetchSearchResults({
+      searchQuery: {
+        query: 'python tutorial',
+        count: 2,
+        livecrawl: 'web',
+        livecrawl_formats: 'markdown',
+      },
+      getUserAgent,
+    });
+
+    expect(result.results.web?.length).toBeLessThanOrEqual(2);
+    // If livecrawl worked, results should have contents field
+    if (result.results.web?.[0]?.contents) {
+      expect(result.results.web[0].contents).toHaveProperty('markdown');
+      expect(typeof result.results.web[0].contents.markdown).toBe('string');
+    }
+  });
+
+  test('handles freshness date ranges', async () => {
+    const result = await fetchSearchResults({
+      searchQuery: {
+        query: 'AI news',
+        freshness: '2024-01-01to2024-12-31',
+        count: 3,
+      },
+      getUserAgent,
+    });
+
+    expect(result).toHaveProperty('results');
+    expect(result.metadata?.query).toContain('AI news');
+  });
+
+  test('handles count greater than 20', async () => {
+    const result = await fetchSearchResults({
+      searchQuery: {
+        query: 'machine learning',
+        count: 50,
+      },
+      getUserAgent,
+    });
+
+    expect(result.results.web?.length).toBeGreaterThan(0);
+    expect(result.results.web?.length).toBeLessThanOrEqual(50);
+  });
 });
 
 describe('formatSearchResults', () => {
@@ -85,7 +131,7 @@ describe('formatSearchResults', () => {
         news: [],
       },
       metadata: {
-        request_uuid: 'test-uuid',
+        search_uuid: 'test-uuid',
         query: 'test query',
         latency: 0.1,
       },
@@ -132,7 +178,7 @@ describe('formatSearchResults', () => {
         ],
       },
       metadata: {
-        request_uuid: 'test-uuid',
+        search_uuid: 'test-uuid',
         query: 'test query',
         latency: 0.1,
       },
@@ -182,7 +228,7 @@ describe('formatSearchResults', () => {
         ],
       },
       metadata: {
-        request_uuid: 'test-uuid',
+        search_uuid: 'test-uuid',
         query: 'test query',
         latency: 0.1,
       },