> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcp-assistant.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Adapters Overview

> Compare the mcp-ts adapters for Vercel AI SDK, LangChain, Mastra, and AG-UI and pick the right integration for your AI framework or agent runtime.

Adapters transforms MCP tools into framework-specific formats for seamless integration with AI frameworks.

## Available Adapters

| Adapter       | Framework      | Import Path                         | Dependencies             |
| ------------- | -------------- | ----------------------------------- | ------------------------ |
| **AI SDK**    | Vercel AI SDK  | `@mcp-ts/sdk/adapters/ai`           | `ai`                     |
| **LangChain** | LangChain      | `@mcp-ts/sdk/adapters/langchain`    | `@langchain/core`, `zod` |
| **Mastra**    | Mastra         | `@mcp-ts/sdk/adapters/mastra`       | `zod`                    |
| **AG-UI**     | AG-UI Protocol | `@mcp-ts/sdk/adapters/agui-adapter` | `@ag-ui/client`, `rxjs`  |

## Common Patterns

### Custom Prefix

Avoid tool name collisions by adding a custom prefix to all tools from a specific adapter:

```typescript theme={null}
const adapter = new AIAdapter(client, {
  prefix: 'myapp'  // Tools named: myapp_search, myapp_fetch, etc.
});
```

### Single Client vs. Multi-Session

Adapters work with both individual `MCPClient` instances andaggregated `MultiSessionClient`.

#### Single Client

```typescript theme={null}
import { MCPClient } from '@mcp-ts/sdk/server';

const client = new MCPClient({
  userId: 'user_123',
  sessionId: 'session_abc',
  serverUrl: 'https://mcp-server.com',
  callbackUrl: 'https://myapp.com/callback'
});

await client.connect();
const adapter = new AIAdapter(client);
```

#### Multi-Session

```typescript theme={null}
const client = new MultiSessionClient('user_123');

// Connect to multiple servers
await client.connect();

// Get all tools from all currently connected servers
const adapter = new AIAdapter(client);
const tools = await adapter.getTools();
```

## Error Handling

All adapters handle disconnected clients gracefully:

```typescript theme={null}
const adapter = new AIAdapter(client);
const tools = await adapter.getTools();
// Returns empty object/array if client is disconnected
```