@youdotcom-oss/mcp 3.3.0 → 3.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@youdotcom-oss/mcp",
-  "version": "3.3.0",
-  "description": "You.com MCP server — web search, AI research, and content extraction via You.com APIs",
+  "version": "3.4.0",
+  "description": "You.com MCP STDIO bridge for the hosted You.com MCP server",
   "license": "MIT",
   "engines": {
     "node": ">=18",
@@ -25,25 +25,21 @@
   ],
   "bin": "bin/stdio.js",
   "type": "module",
-  "exports": {
-    ".": "./src/main.ts"
-  },
   "files": [
     "bin/stdio.js",
-    "src",
     "server.json"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "bun build ./src/stdio-server.ts --outfile ./bin/stdio.js --target=node",
+    "build": "bun build ./src/stdio-bridge.ts --outfile ./bin/stdio.js --target=node",
     "check": "bun run check:biome && bun run check:types && bun run check:package",
     "check:biome": "biome check",
     "check:package": "format-package --check",
     "check:types": "tsc --noEmit",
     "check:write": "biome check --write && bun run format:package",
-    "dev": "bun src/stdio-server.ts",
+    "dev": "bun src/stdio-bridge.ts",
     "format:package": "format-package --write",
     "inspector": "test -n \"$YDC_API_KEY\" || (echo 'YDC_API_KEY is not set' && exit 1); mcp-inspector --config mcp-inspector.json -e YDC_API_KEY=$YDC_API_KEY",
     "prepublishOnly": "bun run build",
@@ -52,9 +48,7 @@
   },
   "mcpName": "io.github.youdotcom-oss/mcp",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.28.0",
-    "@youdotcom-oss/api": "0.5.2",
-    "zod": "^4.3.6"
+    "@modelcontextprotocol/sdk": "^1.28.0"
   },
   "devDependencies": {
     "@modelcontextprotocol/inspector": "0.21.2",

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.2.3",
+  "version": "3.3.0",
   "remotes": [
     {
       "type": "streamable-http",
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "@youdotcom-oss/mcp",
-      "version": "3.2.3",
+      "version": "3.3.0",
       "transport": {
         "type": "stdio"
       },
@@ -35,8 +35,15 @@
           "format": "string"
         },
         {
-          "name": "MCP_SERVER_URL",
-          "description": "Remote MCP server URL (defaults to https://api.you.com/mcp)",
+          "name": "YDC_PROFILE",
+          "description": "Hosted MCP profile to expose through the STDIO bridge (currently supports free)",
+          "isRequired": false,
+          "isSecret": false,
+          "format": "string"
+        },
+        {
+          "name": "YDC_ALLOWED_TOOLS",
+          "description": "Comma-separated hosted tool ids to expose through the STDIO bridge",
           "isRequired": false,
           "isSecret": false,
           "format": "string"

package/src/contents/contents.utils.ts

@@ -1,59 +0,0 @@
-import type { ContentsApiResponse } from '@youdotcom-oss/api'
-
-/**
- * Format contents API response for MCP output
- * @param response - Validated API response
- * @param formats - Formats used for extraction
- * @returns Text content blocks for the MCP response
- */
-export const formatContentsResponse = (
-  response: ContentsApiResponse,
-  formats: string[],
-): Array<{ type: 'text'; text: string }> => {
-  const textParts: string[] = [`Successfully extracted content from ${response.length} URL(s):\n`]
-  textParts.push(`Formats: ${formats.join(', ')}\n`)
-
-  for (const item of response) {
-    textParts.push(`\n## ${item.title || 'Untitled'}`)
-    textParts.push(`URL: ${item.url}\n`)
-    textParts.push('---\n')
-
-    if (formats.includes('markdown') && item.markdown) {
-      textParts.push('\n### Markdown Content\n')
-      textParts.push(item.markdown)
-      textParts.push('\n')
-    }
-
-    if (formats.includes('html') && item.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))
-      if (item.html.length > 500) {
-        textParts.push('...\n(truncated for display — full HTML available in structuredContent)')
-      }
-      textParts.push('\n')
-    }
-
-    if (formats.includes('metadata') && item.metadata) {
-      textParts.push('\n### Metadata\n')
-
-      if (item.metadata.site_name) {
-        textParts.push(`**Site Name:** ${item.metadata.site_name}\n`)
-      }
-
-      if (item.metadata.favicon_url) {
-        textParts.push(`**Favicon:** ${item.metadata.favicon_url}\n`)
-      }
-    }
-
-    textParts.push('\n---\n')
-  }
-
-  return [
-    {
-      type: 'text',
-      text: textParts.join('\n'),
-    },
-  ]
-}

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

@@ -1,95 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import {
-  ContentsApiResponseSchema,
-  ContentsQuerySchema,
-  fetchContents,
-  generateErrorReportLink,
-} from '@youdotcom-oss/api'
-import * as z from 'zod'
-import { getLogger } from '../shared/get-logger.ts'
-import { formatContentsResponse } from './contents.utils.ts'
-
-/**
- * Register the you-contents tool with the MCP server
- * Extracts and returns full content from multiple URLs in markdown or HTML format
- */
-export const registerContentsTool = ({
-  mcp,
-  YDC_API_KEY,
-  getUserAgent,
-}: {
-  mcp: McpServer
-  YDC_API_KEY?: string
-  getUserAgent: () => string
-}) => {
-  mcp.registerTool(
-    'you-contents',
-    {
-      title: 'Extract Web Page Contents',
-      description: 'Extract page content in markdown or HTML',
-      inputSchema: ContentsQuerySchema,
-      outputSchema: z.object({
-        output: ContentsApiResponseSchema,
-      }),
-    },
-    async (contentsQuery, { sendNotification }) => {
-      const logger = getLogger(sendNotification)
-
-      try {
-        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'])
-
-        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}`,
-        })
-
-        const response = await fetchContents({
-          contentsQuery,
-          YDC_API_KEY,
-          getUserAgent,
-        })
-
-        const content = formatContentsResponse(response, requestFormats)
-
-        await logger({
-          level: 'info',
-          data: `Contents API call successful: extracted ${response.length} page(s)`,
-        })
-
-        return {
-          content,
-          structuredContent: {
-            output: response,
-          },
-        }
-      } catch (err: unknown) {
-        const errorMessage = err instanceof Error ? err.message : String(err)
-        const reportLink = generateErrorReportLink({
-          errorMessage,
-          tool: 'you-contents',
-          clientInfo: getUserAgent(),
-        })
-
-        await logger({
-          level: 'error',
-          data: `Contents API call failed: ${errorMessage}\n\nReport this issue: ${reportLink}`,
-        })
-
-        return {
-          content: [
-            {
-              type: 'text' as const,
-              text: `Error extracting contents: ${errorMessage}`,
-            },
-          ],
-          structuredContent: undefined,
-          isError: true,
-        }
-      }
-    },
-  )
-}

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

@@ -1,99 +0,0 @@
-import { describe, expect, test } from 'bun:test'
-import type { ContentsApiResponse } from '@youdotcom-oss/api'
-import { formatContentsResponse } from '../contents.utils.ts'
-
-describe('formatContentsResponse', () => {
-  test('formats single markdown content correctly', () => {
-    const mockResponse: ContentsApiResponse = [
-      {
-        url: 'https://example.com',
-        title: 'Example Page',
-        markdown: '# Hello\n\nThis is a test page with some content.',
-      },
-    ]
-
-    const result = formatContentsResponse(mockResponse, ['markdown'])
-
-    expect(Array.isArray(result)).toBe(true)
-    expect(result[0]).toHaveProperty('type', 'text')
-    expect(result[0]).toHaveProperty('text')
-
-    const text = result[0]?.text
-    expect(text).toContain('Example Page')
-    expect(text).toContain('https://example.com')
-    expect(text).toContain('Formats: markdown')
-    expect(text).toContain('# Hello')
-    expect(text).toContain('This is a test page with some content.')
-  })
-
-  test('formats multiple items correctly', () => {
-    const mockResponse: ContentsApiResponse = [
-      {
-        url: 'https://example1.com',
-        title: 'Page 1',
-        markdown: 'Content 1',
-      },
-      {
-        url: 'https://example2.com',
-        title: 'Page 2',
-        markdown: 'Content 2',
-      },
-    ]
-
-    const result = formatContentsResponse(mockResponse, ['markdown'])
-
-    const text = result[0]?.text
-    expect(text).toContain('Successfully extracted content from 2 URL(s)')
-    expect(text).toContain('Page 1')
-    expect(text).toContain('Page 2')
-    expect(text).toContain('https://example1.com')
-    expect(text).toContain('https://example2.com')
-  })
-
-  test('handles html format', () => {
-    const mockResponse: ContentsApiResponse = [
-      {
-        url: 'https://example.com',
-        title: 'HTML Page',
-        html: '<html><body><h1>Hello</h1></body></html>',
-      },
-    ]
-
-    const result = formatContentsResponse(mockResponse, ['html'])
-
-    const text = result[0]?.text
-    expect(text).toContain('Formats: html')
-    expect(text).toContain('<html>')
-  })
-
-  test('includes full content for long text', () => {
-    const longContent = 'a'.repeat(1000)
-    const mockResponse: ContentsApiResponse = [
-      {
-        url: 'https://example.com',
-        title: 'Long Page',
-        markdown: longContent,
-      },
-    ]
-
-    const result = formatContentsResponse(mockResponse, ['markdown'])
-
-    const text = result[0]?.text
-    expect(text).toContain(longContent)
-  })
-
-  test('handles empty content gracefully', () => {
-    const mockResponse: ContentsApiResponse = [
-      {
-        url: 'https://example.com',
-        title: 'Empty Page',
-        markdown: '',
-      },
-    ]
-
-    const result = formatContentsResponse(mockResponse, ['markdown'])
-
-    const text = result[0]?.text
-    expect(text).toContain('Empty Page')
-  })
-})

package/src/get-mcp-server.ts

@@ -1,17 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import packageJson from '../package.json' with { type: 'json' }
-
-export const getMcpServer = () =>
-  new McpServer(
-    {
-      name: 'You.com',
-      version: packageJson.version,
-    },
-    {
-      capabilities: {
-        logging: {},
-        tools: { listChanged: true },
-      },
-      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.`,
-    },
-  )

package/src/main.ts

@@ -1,5 +0,0 @@
-export { registerContentsTool } from './contents/register-contents-tool.ts'
-export { getMcpServer } from './get-mcp-server.ts'
-export { registerResearchTool } from './research/register-research-tool.ts'
-export { registerSearchTool } from './search/register-search-tool.ts'
-export { useGetClientVersion } from './shared/use-client-version.ts'

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

@@ -1,68 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import { callResearch, generateErrorReportLink, ResearchQuerySchema, ResearchResponseSchema } from '@youdotcom-oss/api'
-import { getLogger } from '../shared/get-logger.ts'
-import { formatResearchResults } from './research.utils.ts'
-
-export const registerResearchTool = ({
-  mcp,
-  YDC_API_KEY,
-  getUserAgent,
-}: {
-  mcp: McpServer
-  YDC_API_KEY?: string
-  getUserAgent: () => string
-}) => {
-  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,
-      outputSchema: ResearchResponseSchema,
-    },
-    async (researchQuery, { sendNotification }) => {
-      const logger = getLogger(sendNotification)
-      try {
-        const response = await callResearch({
-          researchQuery,
-          YDC_API_KEY,
-          getUserAgent,
-        })
-
-        const sourceCount = response.output.sources.length
-
-        await logger({
-          level: 'info',
-          data: `Research for "${researchQuery.input.substring(0, 100)}" complete: ${sourceCount} source(s)`,
-        })
-
-        const content = formatResearchResults(response)
-        return { content, structuredContent: response }
-      } catch (err: unknown) {
-        const errorMessage = err instanceof Error ? err.message : String(err)
-        const reportLink = generateErrorReportLink({
-          errorMessage,
-          tool: 'you-research',
-          clientInfo: getUserAgent(),
-        })
-
-        await logger({
-          level: 'error',
-          data: `Research API call failed: ${errorMessage}\n\nReport this issue: ${reportLink}`,
-        })
-
-        return {
-          content: [
-            {
-              type: 'text' as const,
-              text: `Error: ${errorMessage}`,
-            },
-          ],
-          structuredContent: undefined,
-          isError: true,
-        }
-      }
-    },
-  )
-}

package/src/research/research.utils.ts

@@ -1,12 +0,0 @@
-import type { ResearchResponse } from '@youdotcom-oss/api'
-import { formatResearchResponse } from '@youdotcom-oss/api'
-
-export const formatResearchResults = (response: ResearchResponse): Array<{ type: 'text'; text: string }> => {
-  const text = formatResearchResponse(response)
-  return [
-    {
-      type: 'text',
-      text,
-    },
-  ]
-}

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

@@ -1,51 +0,0 @@
-import { describe, expect, test } from 'bun:test'
-import type { ResearchResponse } from '@youdotcom-oss/api'
-import { formatResearchResults } from '../research.utils.ts'
-
-describe('formatResearchResults', () => {
-  test('formats research response with sources correctly', () => {
-    const mockResponse: ResearchResponse = {
-      output: {
-        content: '# Research Answer\n\nThis is a comprehensive answer about the topic.',
-        content_type: 'text',
-        sources: [
-          {
-            url: 'https://example.com/source1',
-            title: 'Source One',
-            snippets: ['First snippet', 'Second snippet'],
-          },
-          {
-            url: 'https://example.com/source2',
-            title: 'Source Two',
-            snippets: ['Another snippet'],
-          },
-        ],
-      },
-    }
-
-    const result = formatResearchResults(mockResponse)
-
-    expect(Array.isArray(result)).toBe(true)
-    expect(result[0]).toHaveProperty('type', 'text')
-    expect(result[0]).toHaveProperty('text')
-
-    const text = result[0]?.text
-    expect(text).toContain('Research Answer')
-    expect(text).toContain('Source One')
-    expect(text).toContain('https://example.com/source1')
-  })
-
-  test('handles response with zero sources', () => {
-    const mockResponse: ResearchResponse = {
-      output: {
-        content: 'An answer with no cited sources.',
-        content_type: 'text',
-        sources: [],
-      },
-    }
-
-    const result = formatResearchResults(mockResponse)
-
-    expect(result[0]?.text).toContain('An answer with no cited sources.')
-  })
-})

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

@@ -1,86 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import {
-  fetchSearchResults,
-  generateErrorReportLink,
-  SearchQuerySchema,
-  SearchResponseSchema,
-} from '@youdotcom-oss/api'
-import { getLogger } from '../shared/get-logger.ts'
-import { formatSearchResults } from './search.utils.ts'
-
-export const registerSearchTool = ({
-  mcp,
-  YDC_API_KEY,
-  getUserAgent,
-}: {
-  mcp: McpServer
-  YDC_API_KEY?: string
-  getUserAgent: () => string
-}) => {
-  mcp.registerTool(
-    'you-search',
-    {
-      title: 'Web Search',
-      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 {
-        const response = await fetchSearchResults({
-          searchQuery,
-          YDC_API_KEY,
-          getUserAgent,
-        })
-
-        const webCount = response.results.web?.length ?? 0
-        const newsCount = response.results.news?.length ?? 0
-
-        if (!webCount && !newsCount) {
-          await logger({
-            level: 'info',
-            data: `No results found for query: "${searchQuery.query}"`,
-          })
-
-          return {
-            content: [{ type: 'text' as const, text: 'No results found.' }],
-            structuredContent: response,
-          }
-        }
-
-        await logger({
-          level: 'info',
-          data: `Search successful for query: "${searchQuery.query}" - ${webCount} web results, ${newsCount} news results (${webCount + newsCount} total)`,
-        })
-
-        const content = formatSearchResults(response)
-        return { content, structuredContent: response }
-      } catch (err: unknown) {
-        const errorMessage = err instanceof Error ? err.message : String(err)
-        const reportLink = generateErrorReportLink({
-          errorMessage,
-          tool: 'you-search',
-          clientInfo: getUserAgent(),
-        })
-
-        await logger({
-          level: 'error',
-          data: `Search API call failed: ${errorMessage}\n\nReport this issue: ${reportLink}`,
-        })
-
-        return {
-          content: [
-            {
-              type: 'text' as const,
-              text: `Error: ${errorMessage}`,
-            },
-          ],
-          structuredContent: undefined,
-          isError: true,
-        }
-      }
-    },
-  )
-}

package/src/search/search.utils.ts

@@ -1,27 +0,0 @@
-import type { SearchResponse } from '@youdotcom-oss/api'
-import { formatSearchResultsText } from '../shared/format-search-results-text.ts'
-
-export const formatSearchResults = (response: SearchResponse) => {
-  let formattedResults = ''
-
-  if (response.results.web?.length) {
-    const webResults = formatSearchResultsText(response.results.web)
-    formattedResults += `WEB RESULTS:\n\n${webResults}`
-  }
-
-  if (response.results.news?.length) {
-    const newsResults = formatSearchResultsText(response.results.news)
-
-    if (formattedResults) {
-      formattedResults += `\n\n${'='.repeat(50)}\n\n`
-    }
-    formattedResults += `NEWS RESULTS:\n\n${newsResults}`
-  }
-
-  return [
-    {
-      type: 'text' as const,
-      text: `Search Results for "${response.metadata.query}":\n\n${formattedResults}`,
-    },
-  ]
-}