@youdotcom-oss/mcp 3.2.2 → 3.3.0

package/bin/stdio.js

@@ -12572,7 +12572,7 @@ var ResearchQuerySchema = object({
 var ResearchSourceSchema = object({
   url: string2().describe("Source webpage URL"),
   title: string2().optional().describe("Source webpage title"),
-  snippets: array(string2()).describe("Relevant excerpts from the source page used in generating the answer")
+  snippets: array(string2()).optional().describe("Relevant excerpts from the source page used in generating the answer")
 });
 var ResearchOutputSchema = object({
   content: string2().describe("Comprehensive response with inline citations, formatted in Markdown"),
@@ -12634,7 +12634,7 @@ var formatResearchResponse = (response) => {
 `);
       parts.push(`**URL:** ${source.url}
 `);
-      if (source.snippets.length > 0) {
+      if (source.snippets?.length) {
         parts.push(`
 **Key Excerpts:**
 `);
@@ -12747,8 +12747,17 @@ var SearchQuerySchema = object({
   ]).optional().describe("Country code"),
   safesearch: _enum(["off", "moderate", "strict"]).optional().describe("Filter level"),
   livecrawl: _enum(["web", "news", "all"]).optional().describe("Live-crawl sections for full content"),
-  livecrawl_formats: _enum(["html", "markdown"]).optional().describe("Format for crawled content")
+  livecrawl_formats: array(_enum(["html", "markdown"])).optional().describe("Formats for crawled content"),
+  language: LanguageSchema.optional().describe("Language code (BCP 47 format)"),
+  include_domains: array(string2()).max(500).optional().describe("Domains to include in results (up to 500)"),
+  exclude_domains: array(string2()).max(500).optional().describe("Domains to exclude from results (up to 500)"),
+  crawl_timeout: number2().int().min(1).max(60).optional().describe("Crawl timeout in seconds (1-60)")
 });
+var validateSearchQuery = (searchQuery) => {
+  if (searchQuery.include_domains && searchQuery.exclude_domains) {
+    throw new Error("Cannot combine include_domains and exclude_domains");
+  }
+};
 var WebResultSchema = object({
   url: string2().describe("URL"),
   title: string2().describe("Title"),
@@ -12807,23 +12816,18 @@ var fetchSearchResults = async ({
   getUserAgent,
   customHeaders
 }) => {
-  const url = new URL(SEARCH_API_URL);
-  const searchParams = new URLSearchParams;
-  for (const [name, value] of Object.entries(searchQuery)) {
-    if (value !== undefined && value !== null) {
-      searchParams.append(name, `${value}`);
-    }
-  }
-  url.search = searchParams.toString();
+  validateSearchQuery(searchQuery);
   const options = {
-    method: "GET",
+    method: "POST",
     headers: new Headers({
       ...customHeaders,
       "X-API-Key": YDC_API_KEY || "",
+      "Content-Type": "application/json",
       "User-Agent": getUserAgent()
-    })
+    }),
+    body: JSON.stringify(searchQuery)
   };
-  const response = await fetch(url, options);
+  const response = await fetch(SEARCH_API_URL, options);
   if (!response.ok) {
     const errorCode = response.status;
     if (errorCode === 429) {
@@ -12885,29 +12889,12 @@ var getLogger = (sendNotification) => async (params) => {
   await sendNotification({ method: "notifications/message", params });
 };
 
-// src/contents/contents.schemas.ts
-var ContentsStructuredContentSchema = object({
-  count: number2().describe("URLs processed"),
-  formats: array(string2()).describe("Content formats requested"),
-  items: array(object({
-    url: string2().describe("URL"),
-    title: string2().optional().describe("Title"),
-    markdown: string2().optional().describe("Markdown content"),
-    html: string2().optional().describe("HTML content"),
-    metadata: object({
-      favicon_url: string2().describe("Favicon URL"),
-      site_name: string2().optional().nullable().describe("Site name")
-    }).optional().nullable().describe("Page metadata")
-  })).describe("Extracted items")
-});
-
 // src/contents/contents.utils.ts
 var formatContentsResponse = (response, formats) => {
   const textParts = [`Successfully extracted content from ${response.length} URL(s):
 `];
   textParts.push(`Formats: ${formats.join(", ")}
 `);
-  const items = [];
   for (const item of response) {
     textParts.push(`
 ## ${item.title || "Untitled"}`);
@@ -12953,28 +12940,14 @@ var formatContentsResponse = (response, formats) => {
     textParts.push(`
 ---
 `);
-    items.push({
-      url: item.url,
-      title: item.title ?? undefined,
-      markdown: item.markdown ?? undefined,
-      html: item.html ?? undefined,
-      metadata: item.metadata ?? undefined
-    });
   }
-  return {
-    content: [
-      {
-        type: "text",
-        text: textParts.join(`
+  return [
+    {
+      type: "text",
+      text: textParts.join(`
 `)
-      }
-    ],
-    structuredContent: {
-      count: response.length,
-      formats,
-      items
     }
-  };
+  ];
 };
 
 // src/contents/register-contents-tool.ts
@@ -12986,8 +12959,10 @@ var registerContentsTool = ({
   mcp.registerTool("you-contents", {
     title: "Extract Web Page Contents",
     description: "Extract page content in markdown or HTML",
-    inputSchema: ContentsQuerySchema.shape,
-    outputSchema: ContentsStructuredContentSchema.shape
+    inputSchema: ContentsQuerySchema,
+    outputSchema: object({
+      output: ContentsApiResponseSchema
+    })
   }, async (contentsQuery, { sendNotification }) => {
     const logger = getLogger(sendNotification);
     try {
@@ -13003,14 +12978,16 @@ var registerContentsTool = ({
         YDC_API_KEY,
         getUserAgent
       });
-      const { content, structuredContent } = formatContentsResponse(response, requestFormats);
+      const content = formatContentsResponse(response, requestFormats);
       await logger({
         level: "info",
         data: `Contents API call successful: extracted ${response.length} page(s)`
       });
       return {
         content,
-        structuredContent
+        structuredContent: {
+          output: response
+        }
       };
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
@@ -20460,7 +20437,7 @@ var EMPTY_COMPLETION_RESULT = {
 // package.json
 var package_default = {
   name: "@youdotcom-oss/mcp",
-  version: "3.2.2",
+  version: "3.3.0",
   description: "You.com MCP server — web search, AI research, and content extraction via You.com APIs",
   license: "MIT",
   engines: {
@@ -20513,11 +20490,12 @@ var package_default = {
   mcpName: "io.github.youdotcom-oss/mcp",
   dependencies: {
     "@modelcontextprotocol/sdk": "^1.28.0",
-    "@youdotcom-oss/api": "0.5.1",
+    "@youdotcom-oss/api": "0.5.2",
     zod: "^4.3.6"
   },
   devDependencies: {
-    "@modelcontextprotocol/inspector": "0.21.1"
+    "@modelcontextprotocol/inspector": "0.21.2",
+    "@types/bun": "latest"
   }
 };
 
@@ -20533,37 +20511,15 @@ var getMcpServer = () => new McpServer({
   instructions: `Use this server to search the web, get AI-powered answers with web context, and extract content from web pages using You.com. The you-contents tool extracts page content and returns it in markdown or HTML format. Use HTML format for layout preservation, interactive content, and visual fidelity; use markdown for text extraction and simpler consumption.`
 });
 
-// src/research/research.schemas.ts
-var ResearchStructuredContentSchema = object({
-  contentType: string2().describe("Format of the content field"),
-  sourceCount: number2().describe("Number of sources used"),
-  sources: array(object({
-    url: string2().describe("Source URL"),
-    title: string2().optional().describe("Source title"),
-    snippetCount: number2().describe("Number of excerpts from this source")
-  })).describe("Sources used in the research answer")
-});
-
 // src/research/research.utils.ts
 var formatResearchResults = (response) => {
   const text = formatResearchResponse(response);
-  return {
-    content: [
-      {
-        type: "text",
-        text
-      }
-    ],
-    structuredContent: {
-      contentType: response.output.content_type,
-      sourceCount: response.output.sources.length,
-      sources: response.output.sources.map((source) => ({
-        url: source.url,
-        title: source.title,
-        snippetCount: source.snippets?.length ?? 0
-      }))
+  return [
+    {
+      type: "text",
+      text
     }
-  };
+  ];
 };
 
 // src/research/register-research-tool.ts
@@ -20575,8 +20531,8 @@ var registerResearchTool = ({
   mcp.registerTool("you-research", {
     title: "Research",
     description: "Research a topic with comprehensive answers and cited sources. Configurable effort levels (lite, standard, deep, exhaustive).",
-    inputSchema: ResearchQuerySchema.shape,
-    outputSchema: ResearchStructuredContentSchema.shape
+    inputSchema: ResearchQuerySchema,
+    outputSchema: ResearchResponseSchema
   }, async (researchQuery, { sendNotification }) => {
     const logger = getLogger(sendNotification);
     try {
@@ -20590,8 +20546,8 @@ var registerResearchTool = ({
         level: "info",
         data: `Research for "${researchQuery.input.substring(0, 100)}" complete: ${sourceCount} source(s)`
       });
-      const { content, structuredContent } = formatResearchResults(response);
-      return { content, structuredContent };
+      const content = formatResearchResults(response);
+      return { content, structuredContent: response };
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       const reportLink = generateErrorReportLink({
@@ -20619,28 +20575,8 @@ Report this issue: ${reportLink}`
   });
 };
 
-// src/search/search.schemas.ts
-var SearchStructuredContentSchema = object({
-  resultCounts: object({
-    web: number2().describe("Web results"),
-    news: number2().describe("News results"),
-    total: number2().describe("Total results")
-  }),
-  results: object({
-    web: array(object({
-      url: string2().describe("URL"),
-      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"),
-      page_age: string2().describe("Publication timestamp")
-    })).optional().describe("News results")
-  }).optional().describe("Search results")
-});
-
 // src/shared/format-search-results-text.ts
+var formatCharCount = (count) => count.toLocaleString();
 var formatSearchResultsText = (results) => {
   return results.map((result) => {
     const parts = [`Title: ${result.title}`];
@@ -20658,6 +20594,18 @@ var formatSearchResultsText = (results) => {
     } else if (result.snippet) {
       parts.push(`Snippet: ${result.snippet}`);
     }
+    if (result.contents) {
+      const formats = [];
+      if (result.contents.markdown) {
+        formats.push(`${formatCharCount(result.contents.markdown.length)} chars (markdown)`);
+      }
+      if (result.contents.html) {
+        formats.push(`${formatCharCount(result.contents.html.length)} chars (html)`);
+      }
+      if (formats.length > 0) {
+        parts.push(`Page content available: ${formats.join(", ")}`);
+      }
+    }
     return parts.join(`
 `);
   }).join(`
@@ -20675,14 +20623,7 @@ var formatSearchResults = (response) => {
 ${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(`
-
----
-
-`);
+    const newsResults = formatSearchResultsText(response.results.news);
     if (formattedResults) {
       formattedResults += `
 
@@ -20694,44 +20635,14 @@ ${"=".repeat(50)}
 
 ${newsResults}`;
   }
-  const structuredResults = {};
-  if (response.results.web?.length) {
-    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,
-      page_age: article.page_age
-    }));
-  }
-  return {
-    content: [
-      {
-        type: "text",
-        text: `Search Results for "${response.metadata.query}":
+  return [
+    {
+      type: "text",
+      text: `Search Results for "${response.metadata.query}":
 
 ${formattedResults}`
-      }
-    ],
-    structuredContent: {
-      resultCounts: {
-        web: response.results.web?.length || 0,
-        news: response.results.news?.length || 0,
-        total: (response.results.web?.length || 0) + (response.results.news?.length || 0)
-      },
-      results: Object.keys(structuredResults).length > 0 ? structuredResults : undefined
-    },
-    fullResponse: response
-  };
+    }
+  ];
 };
 
 // src/search/register-search-tool.ts
@@ -20742,9 +20653,9 @@ var registerSearchTool = ({
 }) => {
   mcp.registerTool("you-search", {
     title: "Web Search",
-    description: "Web and news search via You.com",
-    inputSchema: SearchQuerySchema.shape,
-    outputSchema: SearchStructuredContentSchema.shape
+    description: "Web and news search via You.com. Supports domain filtering, language selection, livecrawl for full page content, and date freshness controls.",
+    inputSchema: SearchQuerySchema,
+    outputSchema: SearchResponseSchema
   }, async (searchQuery, { sendNotification }) => {
     const logger = getLogger(sendNotification);
     try {
@@ -20762,21 +20673,15 @@ var registerSearchTool = ({
         });
         return {
           content: [{ type: "text", text: "No results found." }],
-          structuredContent: {
-            resultCounts: {
-              web: 0,
-              news: 0,
-              total: 0
-            }
-          }
+          structuredContent: response
         };
       }
       await logger({
         level: "info",
         data: `Search successful for query: "${searchQuery.query}" - ${webCount} web results, ${newsCount} news results (${webCount + newsCount} total)`
       });
-      const { content, structuredContent } = formatSearchResults(response);
-      return { content, structuredContent };
+      const content = formatSearchResults(response);
+      return { content, structuredContent: response };
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       const reportLink = generateErrorReportLink({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/mcp",
-  "version": "3.2.2",
+  "version": "3.3.0",
   "description": "You.com MCP server — web search, AI research, and content extraction via You.com APIs",
   "license": "MIT",
   "engines": {
@@ -53,10 +53,11 @@
   "mcpName": "io.github.youdotcom-oss/mcp",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",
-    "@youdotcom-oss/api": "0.5.1",
+    "@youdotcom-oss/api": "0.5.2",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@modelcontextprotocol/inspector": "0.21.1"
+    "@modelcontextprotocol/inspector": "0.21.2",
+    "@types/bun": "latest"
   }
 }

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.youdotcom-oss/mcp",
   "title": "You.com Web Access & AI",
   "description": "Web search, AI agent, and content extraction via You.com APIs",
-  "version": "3.0.0",
+  "version": "3.2.3",
   "remotes": [
     {
       "type": "streamable-http",
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "@youdotcom-oss/mcp",
-      "version": "3.0.0",
+      "version": "3.2.3",
       "transport": {
         "type": "stdio"
       },
@@ -39,7 +39,7 @@
           "description": "Remote MCP server URL (defaults to https://api.you.com/mcp)",
           "isRequired": false,
           "isSecret": false,
-          "format": "uri"
+          "format": "string"
         }
       ]
     }

package/src/contents/contents.utils.ts

@@ -1,33 +1,23 @@
 import type { ContentsApiResponse } from '@youdotcom-oss/api'
-import type { ContentsStructuredContent } from './contents.schemas.ts'
 
 /**
  * Format contents API response for MCP output
- * Returns full content in both text and structured formats
  * @param response - Validated API response
  * @param formats - Formats used for extraction
- * @returns Formatted response with content and structuredContent
+ * @returns Text content blocks for the MCP response
  */
 export const formatContentsResponse = (
   response: ContentsApiResponse,
   formats: string[],
-): {
-  content: Array<{ type: 'text'; text: string }>
-  structuredContent: ContentsStructuredContent
-} => {
-  // Build text content with full extracted content
+): Array<{ type: 'text'; text: string }> => {
   const textParts: string[] = [`Successfully extracted content from ${response.length} URL(s):\n`]
   textParts.push(`Formats: ${formats.join(', ')}\n`)
 
-  const items: ContentsStructuredContent['items'] = []
-
   for (const item of response) {
-    // Add header for this item
     textParts.push(`\n## ${item.title || 'Untitled'}`)
     textParts.push(`URL: ${item.url}\n`)
     textParts.push('---\n')
 
-    // Add content based on requested formats
     if (formats.includes('markdown') && item.markdown) {
       textParts.push('\n### Markdown Content\n')
       textParts.push(item.markdown)
@@ -35,7 +25,7 @@ export const formatContentsResponse = (
     }
 
     if (formats.includes('html') && item.html) {
-      // Text output is a brief preview only — full HTML is in structuredContent.items[].html
+      // Text output is a brief preview only — full HTML is in structuredContent.output[].html
       textParts.push('\n### HTML Content\n')
       textParts.push(`Length: ${item.html.length} characters\n`)
       textParts.push(item.html.substring(0, 500))
@@ -58,28 +48,12 @@ export const formatContentsResponse = (
     }
 
     textParts.push('\n---\n')
-
-    // Add to structured content
-    items.push({
-      url: item.url,
-      title: item.title ?? undefined,
-      markdown: item.markdown ?? undefined,
-      html: item.html ?? undefined,
-      metadata: item.metadata ?? undefined,
-    })
   }
 
-  return {
-    content: [
-      {
-        type: 'text',
-        text: textParts.join('\n'),
-      },
-    ],
-    structuredContent: {
-      count: response.length,
-      formats,
-      items,
+  return [
+    {
+      type: 'text',
+      text: textParts.join('\n'),
     },
-  }
+  ]
 }

package/src/contents/register-contents-tool.ts

@@ -1,7 +1,12 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import { ContentsQuerySchema, fetchContents, generateErrorReportLink } from '@youdotcom-oss/api'
+import {
+  ContentsApiResponseSchema,
+  ContentsQuerySchema,
+  fetchContents,
+  generateErrorReportLink,
+} from '@youdotcom-oss/api'
+import * as z from 'zod'
 import { getLogger } from '../shared/get-logger.ts'
-import { ContentsStructuredContentSchema } from './contents.schemas.ts'
 import { formatContentsResponse } from './contents.utils.ts'
 
 /**
@@ -17,43 +22,39 @@ export const registerContentsTool = ({
   YDC_API_KEY?: string
   getUserAgent: () => string
 }) => {
-  // Register the tool
   mcp.registerTool(
     'you-contents',
     {
       title: 'Extract Web Page Contents',
       description: 'Extract page content in markdown or HTML',
-      inputSchema: ContentsQuerySchema.shape,
-      outputSchema: ContentsStructuredContentSchema.shape,
+      inputSchema: ContentsQuerySchema,
+      outputSchema: z.object({
+        output: ContentsApiResponseSchema,
+      }),
     },
     async (contentsQuery, { sendNotification }) => {
       const logger = getLogger(sendNotification)
 
       try {
-        // Validate and parse input
         const { urls, formats, format, crawl_timeout } = contentsQuery
 
         // Handle backward compatibility: prefer formats array, fallback to format string, default to ['markdown']
         const requestFormats = formats || (format ? [format] : ['markdown'])
 
-        // Log the request
         const timeoutInfo = crawl_timeout ? ` with timeout: ${crawl_timeout}s` : ''
         await logger({
           level: 'info',
           data: `Contents API call initiated for ${urls.length} URL(s) with formats: ${requestFormats.join(', ')}${timeoutInfo}`,
         })
 
-        // Fetch contents from API
         const response = await fetchContents({
           contentsQuery,
           YDC_API_KEY,
           getUserAgent,
         })
 
-        // Format response with full content
-        const { content, structuredContent } = formatContentsResponse(response, requestFormats)
+        const content = formatContentsResponse(response, requestFormats)
 
-        // Log success
         await logger({
           level: 'info',
           data: `Contents API call successful: extracted ${response.length} page(s)`,
@@ -61,10 +62,11 @@ export const registerContentsTool = ({
 
         return {
           content,
-          structuredContent,
+          structuredContent: {
+            output: response,
+          },
         }
       } catch (err: unknown) {
-        // Handle and log errors
         const errorMessage = err instanceof Error ? err.message : String(err)
         const reportLink = generateErrorReportLink({
           errorMessage,