Vercel AI SDK

StitchAPI is agent-native through the MCP surface — the canonical way to hand a stitch to any agent. @stitchapi/vercel-ai is the framework-specific convenience for apps already on the Vercel AI SDK: wrap a stitch as a tool() the model can call inside generateText / streamText.

The stitch runs as the tool's execute, so the model gets typed, validated data back — and the credential stays behind the boundary (a capability, not the credential).

Structural, version-bridged. It imports nothing from ai; the returned tool carries both parameters (AI SDK v4) and inputSchema (v5), so it drops into either.

Example

npm install @stitchapi/vercel-ai stitchapi

stitchapi is the only required peer; bring the ai SDK you already run.

stitchTool

Drop a stitch straight into a tools map:

import { getUser } from './api';

import { stitchTool } from '@stitchapi/vercel-ai';
import { generateText } from 'ai';
import { z } from 'zod';

const { text } = await generateText({
    model,
    prompt: 'Who is user 7?',
    tools: {
        getUser: stitchTool(getUser, {
            description: 'Fetch a user by id',
            inputSchema: z.object({ id: z.string() }),
            toInput: ({ id }) => ({ params: { id } }),
        }),
    },
});

• inputSchema — the schema the model fills (a Zod schema, or any AI SDK Schema).
• toInput — maps the model's args onto the stitch's { params, query, body }. Omit it when the model's args are the stitch input.

The tool's result is the stitch's validated output, so the model reasons over real data, not a guess; a failure rejects, and the AI SDK's tool-error handling reports it.

stitchExecute

If you'd rather compose the tool yourself — e.g. with ai's own tool() for tighter typing — stitchExecute is just the execute:

import { stitchExecute } from '@stitchapi/vercel-ai';
import { tool } from 'ai';
import { z } from 'zod';

const getUserTool = tool({
    description: 'Fetch a user by id',
    inputSchema: z.object({ id: z.string() }),
    execute: stitchExecute(getUser, ({ id }) => ({ params: { id } })),
});

See also