@mcp-ts/sdk 1.3.1 → 1.3.2

package/README.md

@@ -106,12 +106,53 @@ export const { GET, POST } = createNextMcpHandler({
     //  your logic here
   }
 });
-});
 ```
 
-### Using with Vercel AI SDK
+### Client-Side (React)
+
+```typescript
+'use client';
+
+import { useMcp } from '@mcp-ts/sdk/client/react';
+
+function App() {
+  const { connections, connect } = useMcp({
+    url: '/api/mcp',
+    identity: 'user-123',
+  });
+
+  return (
+    <div className="flex flex-col items-center gap-4">
+      <button
+        onClick={() =>
+          connect({
+            serverId: 'my-server',
+            serverName: 'My MCP Server',
+            serverUrl: 'https://mcp.example.com',
+            callbackUrl: `${window.location.origin}/callback`,
+          })
+        }
+      >
+        Connect
+      </button>
+      {connections.map((conn) => (
+        <div key={conn.sessionId}>
+          <h3>{conn.serverName}</h3>
+          <p>State: {conn.state}</p>
+          <p>Tools: {conn.tools.length}</p>
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+### Adapters
 
-For advanced usage with `ai` SDK (e.g., `streamText`), use `MultiSessionClient` to aggregate tools from multiple servers.
+Integrating with agent frameworks is simple using built-in adapters.
+
+<details>
+<summary>Vercel AI SDK</summary>
 
 ```typescript
 // app/api/chat/route.ts
@@ -132,63 +173,57 @@ export async function POST(req: Request) {
       messages,
       tools,
       onFinish: async () => {
-        await mcp.disconnect();
+        await client.disconnect();
       }
     });
     return result.toDataStreamResponse();
   } catch (error) {
-    await mcp.disconnect();
+    await client.disconnect();
     throw error;
   }
 }
 ```
 
-### Client-Side (React)
-
-```typescript
-'use client';
-
-import { useMcp } from '@mcp-ts/sdk/client/react';
-
-function App() {
-  const { connections, connect, status } = useMcp({
-    url: '/api/mcp',
-    identity: 'user-123',
-  });
-
-  return (
-    <>
-      <p>Status: {status}</p>
-
-      <button
-        onClick={() =>
-          connect({
-            serverId: 'my-server',
-            serverName: 'My MCP Server',
-            serverUrl: 'https://mcp.example.com',
-            callbackUrl: `${window.location.origin}/callback`,
-          })
-        }
-      >
-        Connect
-      </button>
-
-      {connections.map((conn) => (
-        <div key={conn.sessionId}>
-          <h3>{conn.serverName}</h3>
-          <p>State: {conn.state}</p>
-          <p>Tools: {conn.tools.length}</p>
-        </div>
-      ))}
-    </>
-  );
-}
-```
-
-### <img src="docs/static/img/agent-framework/agui.webp" width="20" height="20" align="center" /> AG-UI Middleware
+</details>
+
+<details>
+<summary>Agui Adapter</summary>
+
+```typescript
+import { MultiSessionClient } from '@mcp-ts/sdk/server';
+import { AguiAdapter } from '@mcp-ts/sdk/adapters/agui-adapter';
+
+const client = new MultiSessionClient("user_123");
+await client.connect();
+
+const adapter = new AguiAdapter(client);
+const tools = await adapter.getTools();
+```
+
+</details>
+
+<details>
+<summary>Mastra Adapter</summary>
+
+```typescript
+import { MultiSessionClient } from '@mcp-ts/sdk/server';
+import { MastraAdapter } from '@mcp-ts/sdk/adapters/mastra-adapter';
+
+const client = new MultiSessionClient("user_123");
+await client.connect();
+
+const tools = await MastraAdapter.getTools(client);
+```
+
+</details>
+
+### AG-UI Middleware
 
 Execute MCP tools server-side when using remote agents (LangGraph, AutoGen, etc.):
 
+<details>
+<summary>View AG-UI (Agent Middleware)</summary>
+
 ```typescript
 import { HttpAgent } from "@ag-ui/client";
 import { AguiAdapter } from "@mcp-ts/sdk/adapters/agui-adapter";
@@ -211,8 +246,51 @@ agent.use(createMcpMiddleware({
 }));
 ```
 
+</details>
+
 The middleware intercepts tool calls from remote agents, executes MCP tools server-side, and returns results back to the agent.
 
+### MCP Apps (SEP-1865)
+
+Render interactive UIs for your tools using the `useMcpApps` hook.
+
+<details>
+<summary>View MCP Apps</summary>
+
+```typescript
+import { useRenderToolCall } from "@copilotkit/react-core";
+import { useMcpApps } from "@mcp-ts/sdk/client/react";
+import { useMcpContext } from "./mcp";
+
+export function ToolRenderer() {
+  const { mcpClient } = useMcpContext();
+  const { getAppMetadata, McpAppRenderer } = useMcpApps(mcpClient);
+
+  useRenderToolCall({
+    name: "*",
+    render: ({ name, args, result, status }) => {
+      const metadata = getAppMetadata(name);
+      
+      if (!metadata) return null;
+
+      return (
+        <McpAppRenderer
+          metadata={metadata}
+          input={args}
+          result={result}
+          status={status}
+          sseClient={mcpClient.sseClient}
+        />
+      );
+    },
+  });
+
+  return null;
+}
+```
+
+</details>
+
 ## Documentation
 
 Full documentation is available at: **[Docs](https://zonlabs.github.io/mcp-ts/)**
@@ -316,9 +394,13 @@ For more details, refer to the documentation and follow the **installation guide
 
 Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how to contribute.
 
-## License
 
-MIT © MCP Assistant
+<br />
+
+<p align="center">
+  <em> Thanks for visiting ✨ @mcp-ts!</em><br><br>
+  <img src="https://visitor-badge.laobi.icu/badge?page_id=zonlabs.mcp-ts&style=for-the-badge&color=00d4ff" alt="Views">
+</p>
 
 
 

package/dist/adapters/agui-adapter.d.mts

@@ -1,8 +1,8 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CxogNckF.mjs';
-import '../events-BgeztGYZ.mjs';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-B1DBx5yR.mjs';
+import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 /**
  * MCP Adapter for AG-UI Integration

package/dist/adapters/agui-adapter.d.ts

@@ -1,8 +1,8 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-cox_WXUj.js';
-import '../events-BgeztGYZ.js';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DyFzyJUx.js';
+import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 /**
  * MCP Adapter for AG-UI Integration

package/dist/adapters/agui-middleware.d.mts

@@ -2,11 +2,11 @@ import { Observable } from 'rxjs';
 import { Middleware, RunAgentInput, AbstractAgent, BaseEvent } from '@ag-ui/client';
 export { AbstractAgent, BaseEvent, EventType, Middleware, RunAgentInput, Tool, ToolCallEndEvent } from '@ag-ui/client';
 import { AguiTool } from './agui-adapter.mjs';
-import '../multi-session-client-CxogNckF.mjs';
-import '../events-BgeztGYZ.mjs';
+import '../multi-session-client-B1DBx5yR.mjs';
+import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 /**
  * AG-UI Middleware for MCP Tool Execution

package/dist/adapters/agui-middleware.d.ts

@@ -2,11 +2,11 @@ import { Observable } from 'rxjs';
 import { Middleware, RunAgentInput, AbstractAgent, BaseEvent } from '@ag-ui/client';
 export { AbstractAgent, BaseEvent, EventType, Middleware, RunAgentInput, Tool, ToolCallEndEvent } from '@ag-ui/client';
 import { AguiTool } from './agui-adapter.js';
-import '../multi-session-client-cox_WXUj.js';
-import '../events-BgeztGYZ.js';
+import '../multi-session-client-DyFzyJUx.js';
+import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 /**
  * AG-UI Middleware for MCP Tool Execution

package/dist/adapters/ai-adapter.d.mts

@@ -1,9 +1,9 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CxogNckF.mjs';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-B1DBx5yR.mjs';
 import { ToolSet } from 'ai';
-import '../events-BgeztGYZ.mjs';
+import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 interface AIAdapterOptions {
     /**

package/dist/adapters/ai-adapter.d.ts

@@ -1,9 +1,9 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-cox_WXUj.js';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DyFzyJUx.js';
 import { ToolSet } from 'ai';
-import '../events-BgeztGYZ.js';
+import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 interface AIAdapterOptions {
     /**

package/dist/adapters/langchain-adapter.d.mts

@@ -1,9 +1,9 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CxogNckF.mjs';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-B1DBx5yR.mjs';
 import { StructuredTool } from '@langchain/core/tools';
-import '../events-BgeztGYZ.mjs';
+import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 interface LangChainAdapterOptions {
     /**

package/dist/adapters/langchain-adapter.d.ts

@@ -1,9 +1,9 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-cox_WXUj.js';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DyFzyJUx.js';
 import { StructuredTool } from '@langchain/core/tools';
-import '../events-BgeztGYZ.js';
+import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 interface LangChainAdapterOptions {
     /**

package/dist/adapters/mastra-adapter.d.mts

@@ -1,9 +1,9 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CxogNckF.mjs';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-B1DBx5yR.mjs';
 import { z } from 'zod';
-import '../events-BgeztGYZ.mjs';
+import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 interface MastraAdapterOptions {
     /**

package/dist/adapters/mastra-adapter.d.ts

@@ -1,9 +1,9 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-cox_WXUj.js';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DyFzyJUx.js';
 import { z } from 'zod';
-import '../events-BgeztGYZ.js';
+import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
-import '@modelcontextprotocol/sdk/shared/auth.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/sdk/shared/auth.js';
 
 interface MastraAdapterOptions {
     /**

package/dist/client/index.d.mts

@@ -1,7 +1,7 @@
-import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from '../events-BgeztGYZ.mjs';
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, c as McpConnectionState } from '../events-BgeztGYZ.mjs';
-import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CLccx9wW.mjs';
-export { p as McpRpcRequest, q as McpRpcResponse, T as ToolInfo } from '../types-CLccx9wW.mjs';
+import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from '../events-CK3N--3g.mjs';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, c as McpConnectionState } from '../events-CK3N--3g.mjs';
+import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-PjM1W07s.mjs';
+export { p as McpRpcRequest, q as McpRpcResponse, T as ToolInfo } from '../types-PjM1W07s.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 
 /**

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
-import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from '../events-BgeztGYZ.js';
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, c as McpConnectionState } from '../events-BgeztGYZ.js';
-import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CLccx9wW.js';
-export { p as McpRpcRequest, q as McpRpcResponse, T as ToolInfo } from '../types-CLccx9wW.js';
+import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from '../events-CK3N--3g.js';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, c as McpConnectionState } from '../events-CK3N--3g.js';
+import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-PjM1W07s.js';
+export { p as McpRpcRequest, q as McpRpcResponse, T as ToolInfo } from '../types-PjM1W07s.js';
 import '@modelcontextprotocol/sdk/types.js';
 
 /**

package/dist/client/react.d.mts

@@ -1,9 +1,9 @@
 import { SSEClient, AppHost } from './index.mjs';
 export { SSEClientOptions } from './index.mjs';
-import { c as McpConnectionState, M as McpConnectionEvent } from '../events-BgeztGYZ.mjs';
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-BgeztGYZ.mjs';
-import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CLccx9wW.mjs';
-export { p as McpRpcRequest, q as McpRpcResponse } from '../types-CLccx9wW.mjs';
+import { c as McpConnectionState, M as McpConnectionEvent } from '../events-CK3N--3g.mjs';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
+import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-PjM1W07s.mjs';
+export { p as McpRpcRequest, q as McpRpcResponse } from '../types-PjM1W07s.mjs';
 import React$1 from 'react';
 import '@modelcontextprotocol/sdk/types.js';
 
@@ -64,7 +64,7 @@ interface McpConnection {
     state: McpConnectionState;
     tools: ToolInfo[];
     error?: string;
-    connectedAt?: Date;
+    createdAt?: Date;
 }
 interface McpClient$1 {
     /**

package/dist/client/react.d.ts

@@ -1,9 +1,9 @@
 import { SSEClient, AppHost } from './index.js';
 export { SSEClientOptions } from './index.js';
-import { c as McpConnectionState, M as McpConnectionEvent } from '../events-BgeztGYZ.js';
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-BgeztGYZ.js';
-import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CLccx9wW.js';
-export { p as McpRpcRequest, q as McpRpcResponse } from '../types-CLccx9wW.js';
+import { c as McpConnectionState, M as McpConnectionEvent } from '../events-CK3N--3g.js';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-CK3N--3g.js';
+import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-PjM1W07s.js';
+export { p as McpRpcRequest, q as McpRpcResponse } from '../types-PjM1W07s.js';
 import React$1 from 'react';
 import '@modelcontextprotocol/sdk/types.js';
 
@@ -64,7 +64,7 @@ interface McpConnection {
     state: McpConnectionState;
     tools: ToolInfo[];
     error?: string;
-    connectedAt?: Date;
+    createdAt?: Date;
 }
 interface McpClient$1 {
     /**

package/dist/client/react.js

@@ -390,16 +390,26 @@ function useMcp(options) {
           const existing = prev.find((c) => c.sessionId === event.sessionId);
           if (existing) {
             return prev.map(
-              (c) => c.sessionId === event.sessionId ? { ...c, state: event.state } : c
+              (c) => c.sessionId === event.sessionId ? {
+                ...c,
+                state: event.state,
+                // update createdAt if present in event, otherwise keep existing
+                createdAt: event.createdAt ? new Date(event.createdAt) : c.createdAt
+              } : c
             );
           } else {
+            if (event.state === "DISCONNECTED") {
+              return prev;
+            }
             return [
               ...prev,
               {
                 sessionId: event.sessionId,
                 serverId: event.serverId,
                 serverName: event.serverName,
+                serverUrl: event.serverUrl,
                 state: event.state,
+                createdAt: event.createdAt ? new Date(event.createdAt) : void 0,
                 tools: []
               }
             ];
@@ -454,6 +464,7 @@ function useMcp(options) {
             serverUrl: s.serverUrl,
             transport: s.transport,
             state: "VALIDATING",
+            createdAt: new Date(s.createdAt),
             tools: []
           }))
         );