Skip to content
Source
Sign inSign up
TanStack/ai

packages/ai-mcp

README.md

@tanstack/ai-mcp

Host-side Model Context Protocol (MCP) client for TanStack AI.

Discover and run MCP server tools, resources, and prompts inside any TanStack AI chat() / agent loop — across any provider adapter — with optional generated TypeScript types (typed tool names and pool keys).

Features

  • createMCPClient({ transport }) — connect to a single MCP server (Streamable HTTP, SSE, or stdio)
  • createMCPClients({ ... }) — connect to many servers at once with auto-prefix collision avoidance
  • Auto-discovery (client.tools()) or explicit typed binding (client.tools([toolDefinition(...)]))
  • @tanstack/ai-mcp/stdio subpath — Node-only stdio transport, isolated so edge bundles stay clean
  • Bundled tanstack-ai-mcp generate CLI — introspects live servers and emits TypeScript types for createMCPClient<MyServer>()
  • [Symbol.asyncDispose] support — use await using for automatic cleanup

Installation

pnpm add @tanstack/ai-mcp @modelcontextprotocol/sdk

Quick Start

import { createMCPClient } from '@tanstack/ai-mcp'
import { chat } from '@tanstack/ai'
import { openaiText } from '@tanstack/ai-openai/adapters'

const mcp = await createMCPClient({
  transport: { type: 'http', url: 'https://your-mcp-server.com/mcp' },
})

const stream = chat({
  adapter: openaiText('gpt-5.5'),
  messages: [{ role: 'user', content: 'What is the weather in Brooklyn?' }],
  tools: await mcp.tools(),
})

// Tools execute lazily while the stream is consumed — close only after
// the stream is fully drained (or hand lifecycle to chat() via the `mcp` option).
for await (const chunk of stream) {
  // handle StreamChunks, or return toServerSentEventsResponse(stream) instead
}

await mcp.close()

License

MIT