Skip to main content

Documentation Index

Fetch the complete documentation index at: https://metorial.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Vercel AI SDK integration (@metorial/ai-sdk) is the recommended way to use Metorial in TypeScript applications. It provides excellent streaming support, a unified interface across multiple model providers, and seamless tool integration. This integration works with any model provider supported by the AI SDK, including Anthropic, OpenAI, Google, and more. You get all the benefits of the AI SDK’s streaming and tool handling while Metorial manages your provider connections. What this example does:
  1. Creates a Metorial session connected to your provider deployment
  2. Passes MCP tools directly to the AI SDK’s streamText function
  3. Streams the AI’s response in real-time

​
Example

import { Metorial } from 'metorial';
import { metorialAiSdk } from '@metorial/ai-sdk';
import { anthropic } from '@ai-sdk/anthropic';
import { streamText } from 'ai';

let metorial = new Metorial({
	apiKey: process.env.METORIAL_API_KEY
});

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [{ providerDeploymentId: 'your-provider-deployment-id' }]
});


let result = streamText({
  model: anthropic("claude-sonnet-4-5"),
  prompt: "Help me",
  tools: session.tools(),
});

for await (let text of result.textStream) {
  process.stdout.write(text);
}