@automatey-org/mcp

Provider-agnostic Model Context Protocol helpers for the Vercel AI SDK.

• McpHttpClient (aka NativeMcpHttpClient) — a lazily-connecting MCP client over Streamable HTTP. Normalizes network failures into friendly "unavailable" errors while re-throwing abort errors so callers can tell cancellation apart from an outage.
• buildMcpToolSet() — turns MCP tools into an AI SDK ToolSet: each tool's JSON Schema is wrapped with jsonSchema(), destructive tools are gated unless unattended, results are flattened for the model, and call/result/error callbacks fire around every invocation.
• tooling — safeToolName, compactToolResult, isDestructiveToolName, destructiveActionPattern (all overridable via buildMcpToolSet options).

import { McpHttpClient, buildMcpToolSet } from "@automatey-org/mcp";
import { streamText } from "ai";

const mcp = new McpHttpClient("http://127.0.0.1:8123/mcp", abortSignal);
const tools = buildMcpToolSet({
  tools: await mcp.listTools(),
  mcp,
  unattended: false,
  onToolCall: (name, input) => console.log("call", name, input),
});

const result = streamText({ model, tools, prompt });

Peer deps: ai (>=7 <8), @modelcontextprotocol/sdk (>=1.29 <2).