@youdotcom-oss/mcp 1.1.6 → 1.2.1

package/README.md

@@ -34,6 +34,115 @@ This server can be integrated with MCP clients in two ways:
 }
 ```
 
+### you-express
+
+Fast AI-powered agent for quick responses with optional real-time web search integration.
+
+**Parameters:**
+- `input` (string, required): The query or instruction to send to the Express agent. Example: "What is the capital of France?"
+- `tools` (array, optional): Array of tool objects to expand the agent's capabilities. Currently supports:
+  - `{ type: "web_search" }` - Enables real-time web search to provide more accurate and up-to-date information
+
+**Features:**
+- Fast response times optimized for straightforward queries
+- Optional web search integration for real-time information
+- AI-synthesized answers with source citations (when web_search is enabled)
+- Progress notifications support (when client provides `progressToken` in request metadata)
+- Non-streaming JSON responses for reliability
+
+**Response Structure:**
+
+The tool returns a token-efficient MCP response format:
+- `answer` (string, required): AI-synthesized answer from the Express agent
+- `results` (object, optional): Web search results included when `web_search` tool is used
+  - `web` (array): Array of search result objects, each containing:
+    - `url` (string): The URL of the search result
+    - `title` (string): The title of the search result
+    - `snippet` (string): A text snippet from the search result
+- `agent` (string, optional): Agent identifier (e.g., "express")
+
+**Example 1: Simple query without web_search**
+
+Input:
+```json
+{
+  "input": "What is 2 + 2?"
+}
+```
+
+Response:
+```json
+{
+  "content": [
+    {
+      "type": "text",
+      "text": "Express Agent Answer:\n\n2 + 2 equals 4."
+    }
+  ],
+  "structuredContent": {
+    "answer": "2 + 2 equals 4.",
+    "agent": "express"
+  }
+}
+```
+
+**Example 2: Query with web_search enabled**
+
+Input:
+```json
+{
+  "input": "What is the capital of France?",
+  "tools": [{ "type": "web_search" }]
+}
+```
+
+Response:
+```json
+{
+  "content": [
+    {
+      "type": "text",
+      "text": "Express Agent Answer:\n\nThe capital of France is Paris, the country's largest city and its political, economic, and cultural center..."
+    },
+    {
+      "type": "text",
+      "text": "\nSearch Results:\n\nTitle: Paris - Wikipedia\nURL: https://en.wikipedia.org/wiki/Paris\nSnippet: Paris is the capital and most populous city of France. With an official estimated population of 2,102,650 residents...\n\nTitle: Paris | History, Map, Population, & Facts | Britannica\nURL: https://www.britannica.com/place/Paris\nSnippet: Paris, city and capital of France, situated in the north-central part of the country..."
+    }
+  ],
+  "structuredContent": {
+    "answer": "The capital of France is Paris, the country's largest city and its political, economic, and cultural center...",
+    "results": {
+      "web": [
+        {
+          "url": "https://en.wikipedia.org/wiki/Paris",
+          "title": "Paris - Wikipedia",
+          "snippet": "Paris is the capital and most populous city of France. With an official estimated population of 2,102,650 residents..."
+        },
+        {
+          "url": "https://www.britannica.com/place/Paris",
+          "title": "Paris | History, Map, Population, & Facts | Britannica",
+          "snippet": "Paris, city and capital of France, situated in the north-central part of the country..."
+        }
+      ]
+    },
+    "agent": "express"
+  }
+}
+```
+
+**Progress Notifications:**
+
+When a client provides a `progressToken` in the request metadata, the tool sends progress notifications at key milestones:
+- 0% - Starting Express agent query
+- 33% - Connecting to You.com API
+- 100% - Complete (implicit with final response)
+
+**Notes:**
+- The `content` array always displays the answer first, followed by search results (if web_search was used)
+- The response format is optimized for token efficiency, returning only essential fields
+- Search results are formatted consistently with the `you-search` tool using shared formatting utilities
+```
+
 **Local NPM Package:**
 ```json
 {
@@ -364,7 +473,7 @@ echo "export YDC_API_KEY=<you-api-key>" > .env
 
 ```bash
 # Build is optional for development, required for production bin executables
-bun run build  # Builds only stdio.ts to dist/stdio.js
+bun run build  # Builds only stdio.ts to bin/stdio.js
 ```
 
 **For MCP Client Integration:**
@@ -392,7 +501,7 @@ Use the full path to your local server installation in your `.mcp.json`:
     "ydc-search": {
       "type": "stdio",
       "command": "node",
-      "args": ["/full/path/to/you-mcp-server/bin/stdio"],
+      "args": ["/full/path/to/you-mcp-server/bin/stdio.js"],
       "env": {
         "YDC_API_KEY": "<you-api-key>"
       }
@@ -425,15 +534,20 @@ export YDC_API_KEY="your-api-key-here"
 ### Available Scripts
 
 - `bun run dev` - Start server in stdio mode for development
-- `bun run build` - Build stdio.ts to dist/ for production
+- `bun run build` - Build stdio.ts to bin/ for production
 - `bun start` - Start HTTP server on port 4000 (or PORT env var)
 - `bun run test` - Run test suite
+- `bun run test:coverage` - Run tests with coverage report
+- `bun run test:coverage:watch` - Run tests with coverage in watch mode
 - `bun run check` - Run Biome linting and formatting checks
+- `bun run check:write` - Auto-fix linting and formatting issues
+- `bun run inspect` - Start MCP inspector with environment variables loaded
+- `bun run prepare` - Set up git hooks for the repository
 
 ### Executable Scripts
 
 The project includes executable scripts in `bin/`:
-- `./bin/stdio` - Stdio transport server (requires `bun run build` first)
+- `./bin/stdio.js` - Stdio transport server (requires `bun run build` first)
 - `./bin/http` - HTTP transport server (runs directly from source)
 
 ### Running the Server
@@ -447,7 +561,7 @@ bun src/stdio.ts
 
 # Production mode (built distribution)
 bun run build  # Build first
-./bin/stdio    # Run built version
+./bin/stdio.js # Run built version
 ```
 
 **HTTP Mode** - For web applications and remote clients:
@@ -541,6 +655,8 @@ To use this MCP server with Claude Code via Docker:
 
 ## API Reference
 
+This MCP server provides two tools for different AI-powered workflows:
+
 ### you-search
 
 Performs a comprehensive web and news search using the You.com Search API.

package/bin/stdio.js

@@ -10171,12 +10171,7 @@ var coerce = {
 var NEVER = INVALID;
 // node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
 var LATEST_PROTOCOL_VERSION = "2025-06-18";
-var SUPPORTED_PROTOCOL_VERSIONS = [
-  LATEST_PROTOCOL_VERSION,
-  "2025-03-26",
-  "2024-11-05",
-  "2024-10-07"
-];
+var SUPPORTED_PROTOCOL_VERSIONS = [LATEST_PROTOCOL_VERSION, "2025-03-26", "2024-11-05", "2024-10-07"];
 var JSONRPC_VERSION = "2.0";
 var ProgressTokenSchema = exports_external.union([exports_external.string(), exports_external.number().int()]);
 var CursorSchema = exports_external.string();
@@ -10236,12 +10231,7 @@ var JSONRPCErrorSchema = exports_external.object({
   })
 }).strict();
 var isJSONRPCError = (value) => JSONRPCErrorSchema.safeParse(value).success;
-var JSONRPCMessageSchema = exports_external.union([
-  JSONRPCRequestSchema,
-  JSONRPCNotificationSchema,
-  JSONRPCResponseSchema,
-  JSONRPCErrorSchema
-]);
+var JSONRPCMessageSchema = exports_external.union([JSONRPCRequestSchema, JSONRPCNotificationSchema, JSONRPCResponseSchema, JSONRPCErrorSchema]);
 var EmptyResultSchema = ResultSchema.strict();
 var CancelledNotificationSchema = NotificationSchema.extend({
   method: exports_external.literal("notifications/cancelled"),
@@ -10253,7 +10243,10 @@ var CancelledNotificationSchema = NotificationSchema.extend({
 var IconSchema = exports_external.object({
   src: exports_external.string(),
   mimeType: exports_external.optional(exports_external.string()),
-  sizes: exports_external.optional(exports_external.string())
+  sizes: exports_external.optional(exports_external.array(exports_external.string()))
+}).passthrough();
+var IconsSchema = exports_external.object({
+  icons: exports_external.array(IconSchema).optional()
 }).passthrough();
 var BaseMetadataSchema = exports_external.object({
   name: exports_external.string(),
@@ -10261,9 +10254,8 @@ var BaseMetadataSchema = exports_external.object({
 }).passthrough();
 var ImplementationSchema = BaseMetadataSchema.extend({
   version: exports_external.string(),
-  websiteUrl: exports_external.optional(exports_external.string()),
-  icons: exports_external.optional(exports_external.array(IconSchema))
-});
+  websiteUrl: exports_external.optional(exports_external.string())
+}).merge(IconsSchema);
 var ClientCapabilitiesSchema = exports_external.object({
   experimental: exports_external.optional(exports_external.object({}).passthrough()),
   sampling: exports_external.optional(exports_external.object({}).passthrough()),
@@ -10349,15 +10341,14 @@ var ResourceSchema = BaseMetadataSchema.extend({
   uri: exports_external.string(),
   description: exports_external.optional(exports_external.string()),
   mimeType: exports_external.optional(exports_external.string()),
-  icons: exports_external.optional(exports_external.array(IconSchema)),
   _meta: exports_external.optional(exports_external.object({}).passthrough())
-});
+}).merge(IconsSchema);
 var ResourceTemplateSchema = BaseMetadataSchema.extend({
   uriTemplate: exports_external.string(),
   description: exports_external.optional(exports_external.string()),
   mimeType: exports_external.optional(exports_external.string()),
   _meta: exports_external.optional(exports_external.object({}).passthrough())
-});
+}).merge(IconsSchema);
 var ListResourcesRequestSchema = PaginatedRequestSchema.extend({
   method: exports_external.literal("resources/list")
 });
@@ -10408,9 +10399,8 @@ var PromptArgumentSchema = exports_external.object({
 var PromptSchema = BaseMetadataSchema.extend({
   description: exports_external.optional(exports_external.string()),
   arguments: exports_external.optional(exports_external.array(PromptArgumentSchema)),
-  icons: exports_external.optional(exports_external.array(IconSchema)),
   _meta: exports_external.optional(exports_external.object({}).passthrough())
-});
+}).merge(IconsSchema);
 var ListPromptsRequestSchema = PaginatedRequestSchema.extend({
   method: exports_external.literal("prompts/list")
 });
@@ -10487,9 +10477,8 @@ var ToolSchema = BaseMetadataSchema.extend({
     required: exports_external.optional(exports_external.array(exports_external.string()))
   }).passthrough()),
   annotations: exports_external.optional(ToolAnnotationsSchema),
-  icons: exports_external.optional(exports_external.array(IconSchema)),
   _meta: exports_external.optional(exports_external.object({}).passthrough())
-});
+}).merge(IconsSchema);
 var ListToolsRequestSchema = PaginatedRequestSchema.extend({
   method: exports_external.literal("tools/list")
 });
@@ -10514,16 +10503,7 @@ var CallToolRequestSchema = RequestSchema.extend({
 var ToolListChangedNotificationSchema = NotificationSchema.extend({
   method: exports_external.literal("notifications/tools/list_changed")
 });
-var LoggingLevelSchema = exports_external.enum([
-  "debug",
-  "info",
-  "notice",
-  "warning",
-  "error",
-  "critical",
-  "alert",
-  "emergency"
-]);
+var LoggingLevelSchema = exports_external.enum(["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"]);
 var SetLevelRequestSchema = RequestSchema.extend({
   method: exports_external.literal("logging/setLevel"),
   params: BaseRequestParamsSchema.extend({
@@ -10568,11 +10548,7 @@ var CreateMessageResultSchema = ResultSchema.extend({
   model: exports_external.string(),
   stopReason: exports_external.optional(exports_external.enum(["endTurn", "stopSequence", "maxTokens"]).or(exports_external.string())),
   role: exports_external.enum(["user", "assistant"]),
-  content: exports_external.discriminatedUnion("type", [
-    TextContentSchema,
-    ImageContentSchema,
-    AudioContentSchema
-  ])
+  content: exports_external.discriminatedUnion("type", [TextContentSchema, ImageContentSchema, AudioContentSchema])
 });
 var BooleanSchemaSchema = exports_external.object({
   type: exports_external.literal("boolean"),
@@ -10602,12 +10578,7 @@ var EnumSchemaSchema = exports_external.object({
   enum: exports_external.array(exports_external.string()),
   enumNames: exports_external.optional(exports_external.array(exports_external.string()))
 }).passthrough();
-var PrimitiveSchemaDefinitionSchema = exports_external.union([
-  BooleanSchemaSchema,
-  StringSchemaSchema,
-  NumberSchemaSchema,
-  EnumSchemaSchema
-]);
+var PrimitiveSchemaDefinitionSchema = exports_external.union([BooleanSchemaSchema, StringSchemaSchema, NumberSchemaSchema, EnumSchemaSchema]);
 var ElicitRequestSchema = RequestSchema.extend({
   method: exports_external.literal("elicitation/create"),
   params: BaseRequestParamsSchema.extend({
@@ -10686,18 +10657,8 @@ var ClientNotificationSchema = exports_external.union([
   InitializedNotificationSchema,
   RootsListChangedNotificationSchema
 ]);
-var ClientResultSchema = exports_external.union([
-  EmptyResultSchema,
-  CreateMessageResultSchema,
-  ElicitResultSchema,
-  ListRootsResultSchema
-]);
-var ServerRequestSchema = exports_external.union([
-  PingRequestSchema,
-  CreateMessageRequestSchema,
-  ElicitRequestSchema,
-  ListRootsRequestSchema
-]);
+var ClientResultSchema = exports_external.union([EmptyResultSchema, CreateMessageResultSchema, ElicitResultSchema, ListRootsResultSchema]);
+var ServerRequestSchema = exports_external.union([PingRequestSchema, CreateMessageRequestSchema, ElicitRequestSchema, ListRootsRequestSchema]);
 var ServerNotificationSchema = exports_external.union([
   CancelledNotificationSchema,
   ProgressNotificationSchema,
@@ -10819,6 +10780,329 @@ class StdioServerTransport {
     });
   }
 }
+// package.json
+var package_default = {
+  name: "@youdotcom-oss/mcp",
+  version: "1.2.1",
+  description: "You.com API Model Context Protocol Server",
+  type: "module",
+  bin: "bin/stdio.js",
+  scripts: {
+    build: "bun build ./src/stdio.ts --outfile ./bin/stdio.js --target=node",
+    dev: "bun src/stdio.ts",
+    inspect: "bash -c 'source .env 2>/dev/null || true; bunx @modelcontextprotocol/inspector -e YDC_API_KEY=$YDC_API_KEY bun dev'",
+    start: "bun run bin/http",
+    test: "bun test",
+    "test:coverage": "bun test --coverage",
+    "test:coverage:watch": "bun test --coverage --watch",
+    check: "biome check",
+    "check:write": "biome check --write",
+    prepare: "git config core.hooksPath .hooks"
+  },
+  keywords: [
+    "mcp",
+    "web search",
+    "model context protocol"
+  ],
+  author: "You.com (https://you.com)",
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/youdotcom-oss/youdotcom-mcp-server.git"
+  },
+  bugs: {
+    url: "https://github.com/youdotcom-oss/youdotcom-mcp-server/issues"
+  },
+  homepage: "https://github.com/youdotcom-oss/youdotcom-mcp-server/tree/main#readme",
+  files: [
+    "bin/stdio.js"
+  ],
+  publishConfig: {
+    access: "public"
+  },
+  engines: {
+    node: ">=18",
+    bun: ">= 1.2.21"
+  },
+  devDependencies: {
+    "@biomejs/biome": "2.3.2",
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@eslint/js": "9.38.0",
+    "@modelcontextprotocol/inspector": "0.17.2",
+    "@types/bun": "latest",
+    typescript: "5.9.3",
+    "lint-staged": "^16.2.6",
+    "@hono/bun-compress": "0.1.0",
+    "@hono/mcp": "0.1.5",
+    "@modelcontextprotocol/sdk": "1.20.2",
+    hono: "^4.10.4",
+    neverthrow: "8.2.0",
+    zod: "3.25.76"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,json}": [
+      "bunx @biomejs/biome check --write"
+    ]
+  }
+};
+
+// src/shared/shared.utils.ts
+var useGetClientVersion = (mcp) => () => {
+  const clientVersion = mcp.server.getClientVersion();
+  if (clientVersion) {
+    const { name, version, title, websiteUrl } = clientVersion;
+    return [name, version, title, websiteUrl].filter(Boolean).join("; ");
+  }
+  return "UNKNOWN";
+};
+var setUserAgent = (client) => `MCP/${package_default.version} (You.com; ${client})`;
+var getLogger = (mcp) => async (params, _sessionId) => {
+  await mcp.server.sendLoggingMessage(params);
+};
+var checkResponseForErrors = (responseData) => {
+  if (typeof responseData === "object" && responseData !== null && "error" in responseData) {
+    const errorMessage = typeof responseData.error === "string" ? responseData.error : JSON.stringify(responseData.error);
+    throw new Error(`You.com API Error: ${errorMessage}`);
+  }
+  return responseData;
+};
+var formatSearchResultItem = (result, _index) => {
+  const parts = [`Title: ${result.title}`, `URL: ${result.url}`];
+  if (result.description) {
+    parts.push(`Description: ${result.description}`);
+  }
+  if (result.snippets && result.snippets.length > 0) {
+    parts.push(`Snippets:
+- ${result.snippets.join(`
+- `)}`);
+  } else if (result.snippet) {
+    parts.push(`Snippet: ${result.snippet}`);
+  }
+  return parts.join(`
+`);
+};
+var formatSearchResultsText = (results) => {
+  return results.map((result, index) => formatSearchResultItem(result, index + 1)).join(`
+
+`);
+};
+
+// src/express/express.schemas.ts
+var ExpressAgentInputSchema = objectType({
+  input: stringType().min(1, "Input is required").describe('The query or prompt to send to the Express agent. Example: "What is the capital of France?"'),
+  tools: arrayType(objectType({
+    type: enumType(["web_search"]).describe('Tool type: currently only "web_search" is supported for Express agent')
+  })).optional().describe("Tools the system can call to expand its capabilities, providing more precise answers. Currently supports web search only.")
+});
+var ApiSearchResultItemSchema = objectType({
+  source_type: stringType().optional(),
+  citation_uri: stringType().optional(),
+  url: stringType(),
+  title: stringType(),
+  snippet: stringType(),
+  thumbnail_url: stringType().optional(),
+  provider: anyType().optional()
+});
+var ExpressAgentApiOutputItemSchema = unionType([
+  objectType({
+    type: literalType("web_search.results"),
+    content: arrayType(ApiSearchResultItemSchema)
+  }),
+  objectType({
+    type: literalType("message.answer"),
+    text: stringType()
+  })
+]);
+var ExpressAgentApiResponseSchema = objectType({
+  output: arrayType(ExpressAgentApiOutputItemSchema),
+  agent: stringType().optional().describe("The agent identifier at the response level."),
+  mode: stringType().optional().describe("The mode used for the agent."),
+  input: arrayType(anyType()).optional().describe("The input messages sent to the agent.")
+}).passthrough();
+var McpSearchResultItemSchema = objectType({
+  url: stringType().describe("The URL of the search result."),
+  title: stringType().describe("The title of the search result."),
+  snippet: stringType().describe("A text snippet from the search result.")
+});
+var ExpressAgentMcpResponseSchema = objectType({
+  answer: stringType().describe("The AI-synthesized answer from Express agent."),
+  results: objectType({
+    web: arrayType(McpSearchResultItemSchema).describe("Array of web search results.")
+  }).optional().describe("Web search results when web_search tool is used."),
+  agent: stringType().optional().describe("The agent identifier at the response level.")
+});
+var ExpressAgentResponseSchema = ExpressAgentMcpResponseSchema;
+var ExpressAgentErrorSchema = objectType({
+  errors: arrayType(objectType({
+    status: stringType(),
+    code: stringType(),
+    title: stringType(),
+    detail: stringType()
+  }))
+});
+
+// src/express/express.utils.ts
+var AGENTS_RUN_URL = "https://api.you.com/v1/agents/runs";
+var agentThrowOnFailedStatus = async (response) => {
+  const errorCode = response.status;
+  const errorData = await response.json();
+  checkResponseForErrors(errorData);
+  if (errorCode === 400) {
+    throw new Error(`Bad Request:
+${JSON.stringify(errorData)}`);
+  } else if (errorCode === 401) {
+    throw new Error(`Unauthorized: The Agent APIs require a valid You.com API key with agent access. Note: Agent APIs use Bearer token authentication, while Search API uses X-API-Key. Ensure your YDC_API_KEY has permissions for agent endpoints.`);
+  } else if (errorCode === 403) {
+    throw new Error(`Forbidden: You are not allowed to use the requested tool for this agent or tenant`);
+  } else if (errorCode === 429) {
+    throw new Error("Rate limited by You.com API. Please try again later.");
+  }
+  throw new Error(`Failed to call agent. Error code: ${errorCode}`);
+};
+var callExpressAgent = async ({
+  YDC_API_KEY = process.env.YDC_API_KEY,
+  agentInput: { input, tools },
+  getClientVersion,
+  progressToken,
+  sendProgress
+}) => {
+  const requestBody = {
+    agent: "express",
+    input,
+    stream: false
+  };
+  if (tools) {
+    requestBody.tools = tools;
+  }
+  if (progressToken && sendProgress) {
+    await sendProgress({
+      progressToken,
+      progress: 33,
+      total: 100,
+      message: "Connecting to You.com API..."
+    });
+  }
+  const options = {
+    method: "POST",
+    headers: new Headers({
+      Authorization: `Bearer ${YDC_API_KEY || ""}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      "User-Agent": setUserAgent(getClientVersion())
+    }),
+    body: JSON.stringify(requestBody)
+  };
+  const response = await fetch(AGENTS_RUN_URL, options);
+  if (!response.ok) {
+    await agentThrowOnFailedStatus(response);
+  }
+  const jsonResponse = await response.json();
+  checkResponseForErrors(jsonResponse);
+  const apiResponse = ExpressAgentApiResponseSchema.parse(jsonResponse);
+  const answerItem = apiResponse.output.find((item) => item.type === "message.answer");
+  const searchItem = apiResponse.output.find((item) => item.type === "web_search.results");
+  const mcpResponse = {
+    answer: answerItem.text,
+    agent: apiResponse.agent
+  };
+  if (searchItem && "content" in searchItem && Array.isArray(searchItem.content)) {
+    mcpResponse.results = {
+      web: searchItem.content.map((item) => ({
+        url: item.url || item.citation_uri || "",
+        title: item.title || "",
+        snippet: item.snippet || ""
+      }))
+    };
+  }
+  return mcpResponse;
+};
+var formatExpressAgentResponse = (response) => {
+  const _agentId = response.agent || "express";
+  const content = [];
+  content.push({
+    type: "text",
+    text: `Express Agent Answer:
+
+${response.answer}`
+  });
+  if (response.results?.web?.length) {
+    const formattedResults = formatSearchResultsText(response.results.web);
+    content.push({
+      type: "text",
+      text: `
+Search Results:
+
+${formattedResults}`
+    });
+  }
+  return {
+    content,
+    structuredContent: response
+  };
+};
+
+// src/express/register-express-tool.ts
+var registerExpressTool = ({
+  mcp,
+  YDC_API_KEY,
+  getClientVersion
+}) => {
+  mcp.registerTool("you-express", {
+    title: "You.com Express Agent",
+    description: "Calls the You.com Express agent for quick AI-powered responses with optional web search capabilities. Returns an AI-synthesized answer and optionally web search results when the web_search tool is used. Best for straightforward queries that benefit from real-time web information.",
+    inputSchema: ExpressAgentInputSchema.shape,
+    outputSchema: ExpressAgentResponseSchema.shape
+  }, async (agentInput, extra) => {
+    const logger = getLogger(mcp);
+    const progressToken = extra?._meta?.progressToken;
+    try {
+      if (progressToken) {
+        await mcp.server.notification({
+          method: "notifications/progress",
+          params: {
+            progressToken,
+            progress: 0,
+            total: 100,
+            message: "Starting Express agent query..."
+          }
+        });
+      }
+      const response = await callExpressAgent({
+        agentInput,
+        YDC_API_KEY,
+        getClientVersion,
+        progressToken,
+        sendProgress: progressToken ? async (params) => {
+          await mcp.server.notification({
+            method: "notifications/progress",
+            params
+          });
+        } : undefined
+      });
+      await logger({
+        level: "info",
+        data: `Express agent call successful for input: "${agentInput.input}"`
+      });
+      return formatExpressAgentResponse(response);
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : String(err);
+      await logger({
+        level: "error",
+        data: `Express agent call failed: ${errorMessage}`
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error: ${errorMessage}`
+          }
+        ],
+        isError: true
+      };
+    }
+  });
+};
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
 var DEFAULT_REQUEST_TIMEOUT_MSEC = 60000;
@@ -10860,7 +11144,10 @@ class Protocol {
     const totalElapsed = Date.now() - info.startTime;
     if (info.maxTotalTimeout && totalElapsed >= info.maxTotalTimeout) {
       this._timeoutInfo.delete(messageId);
-      throw new McpError(ErrorCode.RequestTimeout, "Maximum total timeout exceeded", { maxTotalTimeout: info.maxTotalTimeout, totalElapsed });
+      throw new McpError(ErrorCode.RequestTimeout, "Maximum total timeout exceeded", {
+        maxTotalTimeout: info.maxTotalTimeout,
+        totalElapsed
+      });
     }
     clearTimeout(info.timeoutId);
     info.timeoutId = setTimeout(info.onTimeout, info.timeout);
@@ -12688,13 +12975,17 @@ class McpServer {
           title: tool.title,
           description: tool.description,
           inputSchema: tool.inputSchema ? zodToJsonSchema(tool.inputSchema, {
-            strictUnions: true
+            strictUnions: true,
+            pipeStrategy: "input"
           }) : EMPTY_OBJECT_JSON_SCHEMA,
           annotations: tool.annotations,
           _meta: tool._meta
         };
         if (tool.outputSchema) {
-          toolDefinition.outputSchema = zodToJsonSchema(tool.outputSchema, { strictUnions: true });
+          toolDefinition.outputSchema = zodToJsonSchema(tool.outputSchema, {
+            strictUnions: true,
+            pipeStrategy: "output"
+          });
         }
         return toolDefinition;
       })
@@ -13214,71 +13505,6 @@ var EMPTY_COMPLETION_RESULT = {
     hasMore: false
   }
 };
-// package.json
-var package_default = {
-  name: "@youdotcom-oss/mcp",
-  version: "1.1.6",
-  description: "You.com API Model Context Protocol Server",
-  type: "module",
-  bin: "bin/stdio.js",
-  scripts: {
-    build: "bun build ./src/stdio.ts --outfile ./bin/stdio.js --target=node",
-    dev: "bun src/stdio.ts",
-    inspect: "bash -c 'source .env 2>/dev/null || true; bunx @modelcontextprotocol/inspector -e YDC_API_KEY=$YDC_API_KEY bun dev'",
-    start: "bun run bin/http",
-    test: "bun test",
-    "test:coverage": "bun test --coverage",
-    "test:coverage:watch": "bun test --coverage --watch",
-    check: "biome check",
-    "check:write": "biome check --write",
-    prepare: "git config core.hooksPath .hooks"
-  },
-  keywords: [
-    "mcp",
-    "web search",
-    "model context protocol"
-  ],
-  author: "You.com (https://you.com)",
-  license: "MIT",
-  repository: {
-    type: "git",
-    url: "git+https://github.com/youdotcom-oss/youdotcom-mcp-server.git"
-  },
-  bugs: {
-    url: "https://github.com/youdotcom-oss/youdotcom-mcp-server/issues"
-  },
-  homepage: "https://github.com/youdotcom-oss/youdotcom-mcp-server/tree/main#readme",
-  files: [
-    "bin/stdio.js"
-  ],
-  publishConfig: {
-    access: "public"
-  },
-  engines: {
-    node: ">=18",
-    bun: ">= 1.2.21"
-  },
-  devDependencies: {
-    "@biomejs/biome": "2.2.4",
-    "@commitlint/cli": "^19.8.1",
-    "@commitlint/config-conventional": "^19.8.1",
-    "@eslint/js": "9.36.0",
-    "@modelcontextprotocol/inspector": "0.16.8",
-    "@types/bun": "latest",
-    typescript: "5.9.2",
-    "lint-staged": "^16.2.0",
-    "@hono/mcp": "0.1.4",
-    "@modelcontextprotocol/sdk": "1.18.1",
-    hono: "^4.9.8",
-    neverthrow: "8.2.0",
-    zod: "3.25.76"
-  },
-  "lint-staged": {
-    "*.{ts,tsx,json}": [
-      "bunx @biomejs/biome check --write"
-    ]
-  }
-};
 
 // src/get-mcp-server.ts
 var getMCpServer = () => new McpServer({
@@ -13437,7 +13663,8 @@ var fetchSearchResults = async ({
     exactTerms,
     excludeTerms,
     ...rest
-  }
+  },
+  getClientVersion
 }) => {
   const url = new URL("https://api.ydc-index.io/v1/search");
   const searchParams = new URLSearchParams;
@@ -13459,7 +13686,8 @@ var fetchSearchResults = async ({
   const options = {
     method: "GET",
     headers: new Headers({
-      "X-API-Key": YDC_API_KEY || ""
+      "X-API-Key": YDC_API_KEY || "",
+      "User-Agent": setUserAgent(getClientVersion())
     })
   };
   const response = await fetch(url, options);
@@ -13473,22 +13701,14 @@ var fetchSearchResults = async ({
     throw new Error(`Failed to perform search. Error code: ${errorCode}`);
   }
   const results = await response.json();
+  checkResponseForErrors(results);
   const parsedResults = SearchResponseSchema.parse(results);
   return parsedResults;
 };
 var formatSearchResults = (response) => {
   let formattedResults = "";
   if (response.results.web?.length) {
-    const webResults = response.results.web.map((hit) => `Title: ${hit.title}
-URL: ${hit.url}
-Description: ${hit.description}
-Snippets:
-- ${hit.snippets.join(`
-- `)}`).join(`
-
----
-
-`);
+    const webResults = formatSearchResultsText(response.results.web);
     formattedResults += `WEB RESULTS:
 
 ${webResults}`;
@@ -13527,22 +13747,28 @@ ${formattedResults}`
 };
 
 // src/search/register-search-tool.ts
-var registerSearchTool = (server, YDC_API_KEY) => {
-  server.registerTool("you-search", {
+var registerSearchTool = ({
+  mcp,
+  YDC_API_KEY,
+  getClientVersion
+}) => {
+  mcp.registerTool("you-search", {
     title: "You.com Search",
     description: "Performs a web and news search using the You.com Search API and returns a formatted list of results.",
     inputSchema: SearchQuerySchema.shape,
     outputSchema: SearchResponseSchema.shape
   }, async (searchQuery) => {
+    const logger = getLogger(mcp);
     try {
       const response = await fetchSearchResults({
         searchQuery,
-        YDC_API_KEY
+        YDC_API_KEY,
+        getClientVersion
       });
       const webCount = response.results.web?.length ?? 0;
       const newsCount = response.results.news?.length ?? 0;
       if (!webCount && !newsCount) {
-        await server.server.sendLoggingMessage({
+        await logger({
           level: "info",
           data: `No results found for query: "${searchQuery.query}"`
         });
@@ -13551,14 +13777,14 @@ var registerSearchTool = (server, YDC_API_KEY) => {
           structuredContent: response
         };
       }
-      await server.server.sendLoggingMessage({
+      await logger({
         level: "info",
         data: `Search successful for query: "${searchQuery.query}" - ${webCount} web results, ${newsCount} news results (${webCount + newsCount} total)`
       });
       return formatSearchResults(response);
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
-      await server.server.sendLoggingMessage({
+      await logger({
         level: "error",
         data: `Search API call failed: ${errorMessage}`
       });
@@ -13578,10 +13804,12 @@ var registerSearchTool = (server, YDC_API_KEY) => {
 // src/stdio.ts
 var YDC_API_KEY = process.env.YDC_API_KEY;
 try {
-  const mcpServer = getMCpServer();
-  registerSearchTool(mcpServer, YDC_API_KEY);
+  const mcp = getMCpServer();
+  const getClientVersion = useGetClientVersion(mcp);
+  registerSearchTool({ mcp, YDC_API_KEY, getClientVersion });
+  registerExpressTool({ mcp, YDC_API_KEY, getClientVersion });
   const transport = new StdioServerTransport;
-  await mcpServer.connect(transport);
+  await mcp.connect(transport);
 } catch (error) {
   console.error("Failed to start server:", error);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/mcp",
-  "version": "1.1.6",
+  "version": "1.2.1",
   "description": "You.com API Model Context Protocol Server",
   "type": "module",
   "bin": "bin/stdio.js",
@@ -42,17 +42,18 @@
     "bun": ">= 1.2.21"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.4",
-    "@commitlint/cli": "^19.8.1",
-    "@commitlint/config-conventional": "^19.8.1",
-    "@eslint/js": "9.36.0",
-    "@modelcontextprotocol/inspector": "0.16.8",
+    "@biomejs/biome": "2.3.2",
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@eslint/js": "9.38.0",
+    "@modelcontextprotocol/inspector": "0.17.2",
     "@types/bun": "latest",
-    "typescript": "5.9.2",
-    "lint-staged": "^16.2.0",
-    "@hono/mcp": "0.1.4",
-    "@modelcontextprotocol/sdk": "1.18.1",
-    "hono": "^4.9.8",
+    "typescript": "5.9.3",
+    "lint-staged": "^16.2.6",
+    "@hono/bun-compress": "0.1.0",
+    "@hono/mcp": "0.1.5",
+    "@modelcontextprotocol/sdk": "1.20.2",
+    "hono": "^4.10.4",
     "neverthrow": "8.2.0",
     "zod": "3.25.76"
   },