@openrouter/mcp 0.0.1

package/esm/schema/json-schema-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-guards.js","sourceRoot":"","sources":["../../src/schema/json-schema-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAG/C,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CACjC,MAA+B;IAE/B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC9B,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC"}

package/esm/schema/json-schema-to-zod.d.ts

@@ -0,0 +1,20 @@
+import type { $ZodObject } from 'zod/v4/core';
+/**
+ * How to handle a JSON Schema (sub)schema that Zod cannot represent.
+ * - `looseLeaf` (default): substitute `z.unknown()` for only the offending
+ *   property so the rest of the tool's parameters stay faithful.
+ * - `throw`: surface the conversion failure to the caller.
+ */
+export type UnconvertibleSchemaMode = 'looseLeaf' | 'throw';
+/**
+ * Convert an MCP tool's JSON Schema (input or output) into a Zod v4 object
+ * schema. `callModel` derives the model-facing parameters from this Zod schema,
+ * so the conversion must be faithful — a permissive passthrough would make the
+ * model call the tool blind.
+ *
+ * Strategy: attempt a holistic `z.fromJSONSchema` conversion first (handles
+ * `$ref`/`$defs`, `anyOf`, formats, nesting); on failure, fall back per the
+ * chosen `mode`.
+ */
+export declare function convertMcpInputSchema(jsonSchema: Record<string, unknown>, mode?: UnconvertibleSchemaMode): $ZodObject;
+//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/esm/schema/json-schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.d.ts","sourceRoot":"","sources":["../../src/schema/json-schema-to-zod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AAIxD;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,OAAO,CAAC;AA+C5D;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,GAAE,uBAAqC,GAC1C,UAAU,CAkBZ"}

package/esm/schema/json-schema-to-zod.js

@@ -0,0 +1,72 @@
+import * as z from 'zod';
+import { MCPError } from '../errors.js';
+import { getSchemaProperties, isJsonSchemaObject } from './json-schema-guards.js';
+/** Narrow a Zod schema to an object schema via its runtime type tag (no `as`). */
+function isZodObject(schema) {
+    return schema._zod.def.type === 'object';
+}
+/** The `required` array of an object schema, filtered to string keys. */
+function requiredKeys(schema) {
+    const { required } = schema;
+    if (!Array.isArray(required)) {
+        return new Set();
+    }
+    return new Set(required.filter((key) => typeof key === 'string'));
+}
+/**
+ * Build a Zod object by converting each property independently, substituting
+ * `z.unknown()` for any property Zod cannot represent. Always yields a
+ * `$ZodObject`, which is what `callModel`'s `tool()` factory requires.
+ */
+function buildObjectFromProperties(jsonSchema, mode) {
+    const properties = getSchemaProperties(jsonSchema) ?? {};
+    const required = requiredKeys(jsonSchema);
+    const shape = {};
+    for (const [key, propSchema] of Object.entries(properties)) {
+        let zodProp;
+        try {
+            zodProp = isJsonSchemaObject(propSchema) ? z.fromJSONSchema(propSchema) : z.unknown();
+        }
+        catch (err) {
+            if (mode === 'throw') {
+                throw new MCPError(`Cannot convert JSON Schema for property "${key}" to Zod`, {
+                    cause: err,
+                });
+            }
+            zodProp = z.unknown();
+        }
+        shape[key] = required.has(key) ? zodProp : z.optional(zodProp);
+    }
+    return z.object(shape);
+}
+/**
+ * Convert an MCP tool's JSON Schema (input or output) into a Zod v4 object
+ * schema. `callModel` derives the model-facing parameters from this Zod schema,
+ * so the conversion must be faithful — a permissive passthrough would make the
+ * model call the tool blind.
+ *
+ * Strategy: attempt a holistic `z.fromJSONSchema` conversion first (handles
+ * `$ref`/`$defs`, `anyOf`, formats, nesting); on failure, fall back per the
+ * chosen `mode`.
+ */
+export function convertMcpInputSchema(jsonSchema, mode = 'looseLeaf') {
+    try {
+        const converted = z.fromJSONSchema(jsonSchema);
+        if (isZodObject(converted)) {
+            return converted;
+        }
+        // MCP guarantees object-typed tool schemas; if a server sends something
+        // else, degrade to a per-property object rather than handing callModel a
+        // non-object schema it cannot use.
+        return buildObjectFromProperties(jsonSchema, mode);
+    }
+    catch (err) {
+        if (mode === 'throw') {
+            throw new MCPError('Cannot convert MCP JSON Schema to Zod', {
+                cause: err,
+            });
+        }
+        return buildObjectFromProperties(jsonSchema, mode);
+    }
+}
+//# sourceMappingURL=json-schema-to-zod.js.map

package/esm/schema/json-schema-to-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.js","sourceRoot":"","sources":["../../src/schema/json-schema-to-zod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAUlF,kFAAkF;AAClF,SAAS,WAAW,CAAC,MAAgB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC3C,CAAC;AAED,yEAAyE;AACzE,SAAS,YAAY,CAAC,MAA+B;IACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,SAAS,yBAAyB,CAChC,UAAmC,EACnC,IAA6B;IAE7B,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,KAAK,GAA6B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,MAAM,IAAI,QAAQ,CAAC,4CAA4C,GAAG,UAAU,EAAE;oBAC5E,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAmC,EACnC,OAAgC,WAAW;IAE3C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,wEAAwE;QACxE,yEAAyE;QACzE,mCAAmC;QACnC,OAAO,yBAAyB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE;gBAC1D,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;QACL,CAAC;QACD,OAAO,yBAAyB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/esm/tool-wrapper.d.ts

@@ -0,0 +1,26 @@
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { McpBranded } from '@openrouter/agent/tool-types';
+import type { UnconvertibleSchemaMode } from './schema/json-schema-to-zod.js';
+/** A discovered MCP tool definition (the fields we consume). */
+export interface McpToolDef {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+export interface WrapToolOptions {
+    client: Client;
+    namePrefix?: string;
+    schemaMode?: UnconvertibleSchemaMode;
+    emitProgress?: boolean;
+    signal?: AbortSignal;
+}
+/**
+ * Wrap one discovered MCP tool as an `@openrouter/agent` tool. Emits a
+ * generator tool (streaming progress events) when `emitProgress` is on,
+ * otherwise a regular tool. The input schema (and output schema, when declared)
+ * are converted to Zod so the model sees faithful parameters. The abort signal,
+ * if supplied, is threaded into the underlying `callTool`.
+ */
+export declare function wrapMcpTool(def: McpToolDef, options: WrapToolOptions): McpBranded;
+//# sourceMappingURL=tool-wrapper.d.ts.map

package/esm/tool-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wrapper.d.ts","sourceRoot":"","sources":["../src/tool-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAG9E,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA4CD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,UAAU,CAuFjF"}

package/esm/tool-wrapper.js

@@ -0,0 +1,118 @@
+import { markMcp, tool } from '@openrouter/agent/tool';
+import * as z from 'zod';
+import { mapCallToolResult } from './result-mapper.js';
+import { isJsonSchemaObject } from './schema/json-schema-guards.js';
+import { convertMcpInputSchema } from './schema/json-schema-to-zod.js';
+/** Event yielded by a progress-emitting generator tool. */
+const progressEventSchema = z.object({
+    type: z.literal('progress'),
+    progress: z.number(),
+    total: z.optional(z.number()),
+    message: z.optional(z.string()),
+});
+function callToolResultIsRaw(value) {
+    return isJsonSchemaObject(value);
+}
+async function invokeTool(invokeArgs) {
+    const { options, mcpName, args, onprogress } = invokeArgs;
+    const result = await options.client.callTool({
+        name: mcpName,
+        arguments: args,
+    }, undefined, {
+        ...(options.signal !== undefined && {
+            signal: options.signal,
+        }),
+        ...(onprogress !== undefined && {
+            onprogress,
+        }),
+    });
+    if (!callToolResultIsRaw(result)) {
+        return '';
+    }
+    return mapCallToolResult(mcpName, result);
+}
+/**
+ * Wrap one discovered MCP tool as an `@openrouter/agent` tool. Emits a
+ * generator tool (streaming progress events) when `emitProgress` is on,
+ * otherwise a regular tool. The input schema (and output schema, when declared)
+ * are converted to Zod so the model sees faithful parameters. The abort signal,
+ * if supplied, is threaded into the underlying `callTool`.
+ */
+export function wrapMcpTool(def, options) {
+    const name = `${options.namePrefix ?? ''}${def.name}`;
+    const inputSchema = convertMcpInputSchema(def.inputSchema, options.schemaMode);
+    const outputSchema = def.outputSchema !== undefined
+        ? convertMcpInputSchema(def.outputSchema, options.schemaMode)
+        : undefined;
+    if (options.emitProgress === true) {
+        return markMcp(tool({
+            name,
+            ...(def.description !== undefined && {
+                description: def.description,
+            }),
+            inputSchema,
+            eventSchema: progressEventSchema,
+            outputSchema: outputSchema ?? z.unknown(),
+            execute: async function* (args) {
+                const queue = [];
+                let notify;
+                const onprogress = (p) => {
+                    queue.push({
+                        type: 'progress',
+                        progress: p.progress,
+                        ...(p.total !== undefined && {
+                            total: p.total,
+                        }),
+                        ...(typeof p.message === 'string' && {
+                            message: p.message,
+                        }),
+                    });
+                    notify?.();
+                };
+                const resultPromise = invokeTool({
+                    options,
+                    mcpName: def.name,
+                    args,
+                    onprogress,
+                });
+                let done = false;
+                const finalize = resultPromise.finally(() => {
+                    done = true;
+                    notify?.();
+                });
+                while (!done || queue.length > 0) {
+                    while (queue.length > 0) {
+                        const event = queue.shift();
+                        if (event !== undefined) {
+                            yield event;
+                        }
+                    }
+                    if (done) {
+                        break;
+                    }
+                    await new Promise((resolve) => {
+                        notify = resolve;
+                    });
+                    notify = undefined;
+                }
+                return await finalize;
+            },
+        }));
+    }
+    return markMcp(tool({
+        name,
+        ...(def.description !== undefined && {
+            description: def.description,
+        }),
+        inputSchema,
+        ...(outputSchema !== undefined && {
+            outputSchema,
+        }),
+        execute: (args) => invokeTool({
+            options,
+            mcpName: def.name,
+            args,
+        }),
+    }));
+}
+//# sourceMappingURL=tool-wrapper.js.map

package/esm/tool-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wrapper.js","sourceRoot":"","sources":["../src/tool-wrapper.ts"],"names":[],"mappings":"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"}

package/esm/transport-types.d.ts

@@ -0,0 +1,3 @@
+/** Non-stdio MCP transports this package supports. */
+export type MCPTransportKind = 'streamableHttp' | 'sse';
+//# sourceMappingURL=transport-types.d.ts.map

package/esm/transport-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-types.d.ts","sourceRoot":"","sources":["../src/transport-types.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,KAAK,CAAC"}

package/esm/transport-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport-types.js.map

package/esm/transport-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-types.js","sourceRoot":"","sources":["../src/transport-types.ts"],"names":[],"mappings":""}

package/esm/types.d.ts

@@ -0,0 +1,104 @@
+import type { Tool } from '@openrouter/agent/tool-types';
+import type { MCPAuth } from './auth/auth-types.js';
+import type { MCPCacheStore } from './cache/cache-store.js';
+import type { UnconvertibleSchemaMode } from './schema/json-schema-to-zod.js';
+import type { MCPTransportKind } from './transport-types.js';
+export type { MCPTransportKind };
+/**
+ * Response to a server-initiated elicitation request. `accept` must carry
+ * `content` matching the server's `requestedSchema`.
+ */
+export type ElicitationResponse = {
+    action: 'accept';
+    content: Record<string, unknown>;
+} | {
+    action: 'decline';
+} | {
+    action: 'cancel';
+};
+/**
+ * Handler for server-initiated `elicitation/create` requests during a tool
+ * call. If omitted from options, requests are auto-declined so a tool call
+ * needing input fails gracefully rather than hanging.
+ */
+export type ElicitationHandler = (request: {
+    message: string;
+    requestedSchema: Record<string, unknown>;
+}) => Promise<ElicitationResponse> | ElicitationResponse;
+/** How MCP resources are exposed to the model. */
+export type ResourcesOption = boolean | {
+    mode?: 'synthetic-tools';
+};
+export interface CreateMCPToolsOptions {
+    /** Remote MCP server endpoint. */
+    url: string | URL;
+    /** Transport to use; defaults to `streamableHttp` with SSE fallback. */
+    transport?: MCPTransportKind;
+    /** Authentication, supplied once and reused for discovery + every call. */
+    auth?: MCPAuth;
+    /** Custom fetch implementation for all network requests. */
+    fetch?: typeof fetch;
+    /** Client identity sent during `initialize`. */
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+    /** Prefix applied to every wrapped tool name (e.g. `"github_"`). */
+    toolNamePrefix?: string;
+    /**
+     * Allow-list of MCP tool names to expose. Applies to discovered MCP tools
+     * only; synthetic `list_resources`/`read_resource` tools are controlled
+     * exclusively by `resources`.
+     */
+    includeTools?: readonly string[];
+    /**
+     * Deny-list of MCP tool names to skip. Applies to discovered MCP tools only;
+     * synthetic `list_resources`/`read_resource` tools are controlled
+     * exclusively by `resources`.
+     */
+    excludeTools?: readonly string[];
+    /** Behavior when a tool's JSON Schema can't be fully represented in Zod. */
+    onUnconvertibleSchema?: UnconvertibleSchemaMode;
+    /** Cache store + key for automatic rehydrate-on-hit / write-on-miss. */
+    cache?: {
+        store: MCPCacheStore;
+        key?: string;
+    };
+    /** Persist resolved tokens/session into the snapshot. Off by default. */
+    cacheCredentials?: boolean;
+    /** Re-list tools when a cached snapshot is older than this. */
+    staleness?: {
+        maxAgeMs?: number;
+    };
+    /** Expose resources as synthetic `list_resources`/`read_resource` tools. */
+    resources?: ResourcesOption;
+    /** Map MCP progress notifications to generator-tool events. Default true. */
+    emitProgress?: boolean;
+    /** Auto-refresh tools on `tools/list_changed`. Default true when connected. */
+    autoRefreshOnListChanged?: boolean;
+    /** Handler for server-initiated elicitation; auto-declines when omitted. */
+    onElicitation?: ElicitationHandler;
+    /** Abort signal threaded into every underlying `callTool`. */
+    signal?: AbortSignal;
+}
+/**
+ * Handle returned by {@link createMCPTools}/`rehydrateMCPTools`. Holds a live
+ * connection (unless rehydrated offline) and the wrapped tools.
+ */
+export interface MCPToolsHandle {
+    /** Tools ready to pass into `callModel({ tools })`. */
+    readonly tools: readonly Tool[];
+    readonly serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    /** Snapshot for persistence; omits credentials unless `cacheCredentials`. */
+    serialize(): Promise<import('./cache/cache-types.js').SerializedMCPServer>;
+    /** Force a fresh `listTools()` and rebuild the tool set. */
+    refresh(): Promise<readonly Tool[]>;
+    /** Subscribe to auto-refreshes triggered by `tools/list_changed`. */
+    onToolsChanged(listener: (tools: readonly Tool[]) => void): () => void;
+    /** Close the transport and underlying client. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@openrouter/mcp",
+  "version": "0.0.1",
+  "author": "OpenRouter",
+  "description": "Expose remote MCP server tools (Streamable HTTP / SSE) as tools for @openrouter/agent's callModel, with serializable caching and pluggable auth.",
+  "keywords": [
+    "openrouter",
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "typescript",
+    "ai",
+    "tools",
+    "llm"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./esm/index.js",
+  "exports": {
+    ".": {
+      "types": "./esm/index.d.ts",
+      "default": "./esm/index.js"
+    },
+    "./create-mcp-tools": {
+      "types": "./esm/create-mcp-tools.d.ts",
+      "default": "./esm/create-mcp-tools.js"
+    },
+    "./types": {
+      "types": "./esm/types.d.ts",
+      "default": "./esm/types.js"
+    },
+    "./schema": {
+      "types": "./esm/schema/json-schema-to-zod.d.ts",
+      "default": "./esm/schema/json-schema-to-zod.js"
+    },
+    "./cache": {
+      "types": "./esm/cache/cache-store.d.ts",
+      "default": "./esm/cache/cache-store.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpenRouterTeam/typescript-agent.git",
+    "directory": "packages/mcp"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "files": [
+    "esm",
+    "package.json",
+    "README.md"
+  ],
+  "scripts": {
+    "lint": "biome check src tests",
+    "lint:fix": "biome check --write src tests",
+    "build": "tsc",
+    "test": "vitest --run --project unit",
+    "test:e2e": "vitest --run --project e2e",
+    "test:watch": "vitest --watch --project unit",
+    "typecheck": "tsc --noEmit",
+    "compile": "tsc"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@openrouter/agent": "workspace:*",
+    "zod": "^4.0.0"
+  }
+}