How to integrate Tave MCP with Vercel AI SDK v6

This guide walks you through connecting Tave to Vercel AI SDK v6 using the Composio tool router. By the end, you'll have a working Tave agent that can list all open jobs assigned to me, add a new client to tave contacts, update status of a job to 'completed' through natural language commands. This guide will help you understand how to give your Vercel AI SDK agent real control over a Tave account through Composio's Tave MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved.

Tave logoTave
Api Key

Tave is a studio management app for photographers, streamlining client management, job tracking, and business workflows. It helps studios stay organized and operate efficiently.

129 Tools

Introduction

This guide walks you through connecting Tave to Vercel AI SDK v6 using the Composio tool router. By the end, you'll have a working Tave agent that can list all open jobs assigned to me, add a new client to tave contacts, update status of a job to 'completed' through natural language commands.

This guide will help you understand how to give your Vercel AI SDK agent real control over a Tave account through Composio's Tave MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Tave with

TL;DR

Here's what you'll learn:
  • How to set up and configure a Vercel AI SDK agent with Tave integration
  • Using Composio's Tool Router to dynamically load and access Tave tools
  • Creating an MCP client connection using HTTP transport
  • Building an interactive CLI chat interface with conversation history management
  • Handling tool calls and results within the Vercel AI SDK framework

What is Vercel AI SDK?

The Vercel AI SDK is a TypeScript library for building AI-powered applications. It provides tools for creating agents that can use external services and maintain conversation state.

Key features include:

  • streamText: Core function for streaming responses with real-time tool support
  • MCP Client: Built-in support for Model Context Protocol via @ai-sdk/mcp
  • Step Counting: Control multi-step tool execution with stopWhen: stepCountIs()
  • OpenAI Provider: Native integration with OpenAI models

What is the Tave MCP server, and what's possible with it?

The Tave MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Tave account. It provides structured and secure access so your agent can perform Tave operations on your behalf.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before you begin, make sure you have:
  • Node.js and npm installed
  • A Composio account with API key
  • An OpenAI API key
2

Getting API Keys for OpenAI and Composio

OpenAI API Key
  • Go to the OpenAI dashboard and create an API key. You'll need credits to use the models, or you can connect to another model provider.
  • Keep the API key safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Navigate to your API settings and generate a new API key.
  • Store this key securely as you'll need it for authentication.
3

Install required dependencies

bash
npm install @ai-sdk/openai @ai-sdk/mcp @composio/core ai dotenv

First, install the necessary packages for your project.

What you're installing:

  • @ai-sdk/openai: Vercel AI SDK's OpenAI provider
  • @ai-sdk/mcp: MCP client for Vercel AI SDK
  • @composio/core: Composio SDK for tool integration
  • ai: Core Vercel AI SDK
  • dotenv: Environment variable management
4

Set up environment variables

bash
OPENAI_API_KEY=your_openai_api_key_here
COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_user_id_here

Create a .env file in your project root.

What's needed:

  • OPENAI_API_KEY: Your OpenAI API key for GPT model access
  • COMPOSIO_API_KEY: Your Composio API key for tool access
  • COMPOSIO_USER_ID: A unique identifier for the user session
5

Import required modules and validate environment

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Composio } from "@composio/core";
import * as readline from "readline";
import { streamText, type ModelMessage, stepCountIs } from "ai";
import { createMCPClient } from "@ai-sdk/mcp";

const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!process.env.OPENAI_API_KEY) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey,
});
What's happening:
  • We're importing all necessary libraries including Vercel AI SDK's OpenAI provider and Composio
  • The dotenv/config import automatically loads environment variables
  • The MCP client import enables connection to Composio's tool server
6

Create Tool Router session and initialize MCP client

typescript
async function main() {
  // Create a tool router session for the user
  const session = await composio.create(composioUserID!, {
    toolkits: ["tave"],
  });

  const mcpUrl = session.mcp.url;
What's happening:
  • We're creating a Tool Router session that gives your agent access to Tave tools
  • The create method takes the user ID and specifies which toolkits should be available
  • The returned mcp object contains the URL and authentication headers needed to connect to the MCP server
  • This session provides access to all Tave-related tools through the MCP protocol
7

Connect to MCP server and retrieve tools

typescript
const mcpClient = await createMCPClient({
  transport: {
    type: "http",
    url: mcpUrl,
    headers: session.mcp.headers, // Authentication headers for the Composio MCP server
  },
});

const tools = await mcpClient.tools();
What's happening:
  • We're creating an MCP client that connects to our Composio Tool Router session via HTTP
  • The mcp.url provides the endpoint, and mcp.headers contains authentication credentials
  • The type: "http" is important - Composio requires HTTP transport
  • tools() retrieves all available Tave tools that the agent can use
8

Initialize conversation and CLI interface

typescript
let messages: ModelMessage[] = [];

console.log("Chat started! Type 'exit' or 'quit' to end the conversation.\n");
console.log(
  "Ask any questions related to tave, like summarize my last 5 emails, send an email, etc... :)))\n",
);

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: "> ",
});

rl.prompt();
What's happening:
  • We initialize an empty messages array to maintain conversation history
  • A readline interface is created to accept user input from the command line
  • Instructions are displayed to guide the user on how to interact with the agent
9

Handle user input and stream responses with real-time tool feedback

typescript
rl.on("line", async (userInput: string) => {
  const trimmedInput = userInput.trim();

  if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
    console.log("\nGoodbye!");
    rl.close();
    process.exit(0);
  }

  if (!trimmedInput) {
    rl.prompt();
    return;
  }

  messages.push({ role: "user", content: trimmedInput });
  console.log("\nAgent is thinking...\n");

  try {
    const stream = streamText({
      model: openai("gpt-5"),
      messages,
      tools,
      toolChoice: "auto",
      stopWhen: stepCountIs(10),
      onStepFinish: (step) => {
        for (const toolCall of step.toolCalls) {
          console.log(`[Using tool: ${toolCall.toolName}]`);
          }
          if (step.toolCalls.length > 0) {
            console.log(""); // Add space after tool calls
          }
        },
      });

      for await (const chunk of stream.textStream) {
        process.stdout.write(chunk);
      }

      console.log("\n\n---\n");

      // Get final result for message history
      const response = await stream.response;
      if (response?.messages?.length) {
        messages.push(...response.messages);
      }
    } catch (error) {
      console.error("\nAn error occurred while talking to the agent:");
      console.error(error);
      console.log(
        "\nYou can try again or restart the app if it keeps happening.\n",
      );
    } finally {
      rl.prompt();
    }
  });

  rl.on("close", async () => {
    await mcpClient.close();
    console.log("\n👋 Session ended.");
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});
What's happening:
  • We use streamText instead of generateText to stream responses in real-time
  • toolChoice: "auto" allows the model to decide when to use Tave tools
  • stopWhen: stepCountIs(10) allows up to 10 steps for complex multi-tool operations
  • onStepFinish callback displays which tools are being used in real-time
  • We iterate through the text stream to create a typewriter effect as the agent responds
  • The complete response is added to conversation history to maintain context
  • Errors are caught and displayed with helpful retry suggestions

Complete Code

Here's the complete code to get you started with Tave and Vercel AI SDK:

typescript
import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Composio } from "@composio/core";
import * as readline from "readline";
import { streamText, type ModelMessage, stepCountIs } from "ai";
import { createMCPClient } from "@ai-sdk/mcp";

const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!process.env.OPENAI_API_KEY) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey,
});

async function main() {
  // Create a tool router session for the user
  const session = await composio.create(composioUserID!, {
    toolkits: ["tave"],
  });

  const mcpUrl = session.mcp.url;

  const mcpClient = await createMCPClient({
    transport: {
      type: "http",
      url: mcpUrl,
      headers: session.mcp.headers, // Authentication headers for the Composio MCP server
    },
  });

  const tools = await mcpClient.tools();

  let messages: ModelMessage[] = [];

  console.log("Chat started! Type 'exit' or 'quit' to end the conversation.\n");
  console.log(
    "Ask any questions related to tave, like summarize my last 5 emails, send an email, etc... :)))\n",
  );

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: "> ",
  });

  rl.prompt();

  rl.on("line", async (userInput: string) => {
    const trimmedInput = userInput.trim();

    if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
      console.log("\nGoodbye!");
      rl.close();
      process.exit(0);
    }

    if (!trimmedInput) {
      rl.prompt();
      return;
    }

    messages.push({ role: "user", content: trimmedInput });
    console.log("\nAgent is thinking...\n");

    try {
      const stream = streamText({
        model: openai("gpt-5"),
        messages,
        tools,
        toolChoice: "auto",
        stopWhen: stepCountIs(10),
        onStepFinish: (step) => {
          for (const toolCall of step.toolCalls) {
            console.log(`[Using tool: ${toolCall.toolName}]`);
          }
          if (step.toolCalls.length > 0) {
            console.log(""); // Add space after tool calls
          }
        },
      });

      for await (const chunk of stream.textStream) {
        process.stdout.write(chunk);
      }

      console.log("\n\n---\n");

      // Get final result for message history
      const response = await stream.response;
      if (response?.messages?.length) {
        messages.push(...response.messages);
      }
    } catch (error) {
      console.error("\nAn error occurred while talking to the agent:");
      console.error(error);
      console.log(
        "\nYou can try again or restart the app if it keeps happening.\n",
      );
    } finally {
      rl.prompt();
    }
  });

  rl.on("close", async () => {
    await mcpClient.close();
    console.log("\n👋 Session ended.");
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});

Conclusion

You've successfully built a Tave agent using the Vercel AI SDK with streaming capabilities! This implementation provides a powerful foundation for building AI applications with natural language interfaces and real-time feedback.

Key features of this implementation:

  • Real-time streaming responses for a better user experience with typewriter effect
  • Live tool execution feedback showing which tools are being used as the agent works
  • Dynamic tool loading through Composio's Tool Router with secure authentication
  • Multi-step tool execution with configurable step limits (up to 10 steps)
  • Comprehensive error handling for robust agent execution
  • Conversation history maintenance for context-aware responses

You can extend this further by adding custom error handling, implementing specific business logic, or integrating additional Composio toolkits to create multi-app workflows.
TOOLS

Supported Tools

Every Tave action and event your agent gets out of the box.

Apply Payment to Order

Tool to apply a payment to a specific order in Tave.

Create Brand

Tool to create a new brand in VSCO Workspace.

Create Custom Field

Tool to create a custom field in Tave for Jobs or Contacts.

Create Discount Type

Tool to create a new discount type in Tave.

Create Gallery

Tool to create a new gallery in Tave (VSCO Workspace).

Create Address Book Entry

Tool to create an entry in the address book.

Create Discount

Tool to create a discount in Tave.

Create Event

Tool to create a new event in Tave (VSCO Workspace).

Create Event Type

Tool to create a new event type in Tave.

Create File

Tool to create a file in Tave.

Create Job

Tool to create a new job in Tave (VSCO Workspace).

Create Job Closed Reason

Tool to create a job closed reason in Tave.

Create Job Contact

Tool to create a job contact in Tave.

Create Job Order

Tool to create an order on a job in Tave (VSCO Workspace).

Create Job Role

Tool to create a job role in Tave (VSCO Workspace).

Create Job Type

Tool to create a new job type in Tave.

Create Job Worksheet

Tool to create a job using a worksheet in Tave (VSCO Workspace).

Create Lead Source

Tool to create a lead source in Tave.

Create Lead Status

Tool to create a lead status in Tave.

Create Note

Tool to create a note in Tave (VSCO Workspace).

Create Payment

Tool to create a payment in Tave.

Create Product

Tool to create a product in Tave.

Create Product Type

Tool to create a product type in Tave.

Create Profit Center

Tool to create a profit center in Tave.

Create RestHook Subscription

Tool to create a RestHook webhook subscription in Tave.

Create Tax Rate

Tool to create a tax rate in Tave.

Create User

Tool to create a new user in Tave.

Delete Address Book Entry

Tool to delete an entry in the address book.

Delete Brand

Tool to delete a brand by its ULID.

Delete Custom Field

Tool to delete a custom field by its ULID identifier.

Delete Event Type

Tool to delete an event type by its ULID identifier.

Delete Gallery

Tool to permanently delete a gallery by its ULID.

Delete Discount

Tool to delete a specific discount by its ULID.

Delete Discount Type

Tool to delete a specific discount type by its ULID.

Delete Event

Tool to delete an event by its ULID identifier.

Delete Job

Tool to delete a job by its ULID identifier.

Delete Job Closed Reason

Tool to delete a job closed reason by its ULID identifier.

Delete Job Contact

Tool to delete a job contact by its ULID.

Delete Job Role

Tool to delete a job role by its ULID identifier.

Delete Job Type

Tool to delete a job type by its ULID.

Delete Lead Source

Tool to delete a specific lead source by its ULID.

Delete Lead Status

Tool to delete a specific lead status by its ULID.

Delete Note

Tool to delete a note by its ULID identifier.

Delete Payment

Tool to delete a specific payment by its ULID.

Delete Product

Tool to delete a specific product by its ULID.

Delete Product Type

Tool to delete a specific product type by its ULID.

Delete Profit Center

Tool to delete a profit center by its ULID.

Delete RestHook

Tool to unsubscribe from and delete a RestHook webhook subscription by its ULID.

Delete Tax Group

Tool to delete a specific tax group by its ULID.

Delete Tax Rate

Tool to delete a specific tax rate by its ULID.

Delete User

Tool to delete a user by its ULID.

Get Brand

Tool to retrieve a specific brand from Tave by its ULID.

Get Event

Tool to get a specific event by its ID.

Get Event Type

Tool to retrieve a specific event type by ID.

Get Gallery

Tool to retrieve a specific gallery by ID from Tave/VSCO Workspace.

Get Address Book Entity

Tool to fetch a specific Address Book entity by its ULID.

Get Address Book Address

Tool to fetch the address associated with a given location ID.

Get Custom Field

Tool to fetch a specific custom field by ID from Tave.

Get Discount

Tool to retrieve a specific discount by its ID.

Get Discount Type

Tool to get a specific discount type by ID.

Get Job

Tool to fetch a specific job by ID from Tave.

Get Job Closed Reason

Tool to retrieve a specific job closed reason by its ID.

Get Job Contact

Tool to fetch a specific job contact by ID from Tave.

Get Job Role

Tool to retrieve a specific job role by its ID.

Get Job Type

Tool to retrieve a specific job type by ID.

Get Job Worksheet

Tool to fetch a Job Worksheet for a specific job by job ID.

Get Lead Source

Tool to retrieve a specific lead source by its ID.

Get Lead Status

Tool to retrieve a specific lead status by its ID.

Get My Studio

Tool to retrieve information about your studio from Tave.

Get Note

Tool to fetch a specific note by ID from Tave.

Get Order

Tool to fetch a specific order by ID from Tave.

Get Payment

Tool to fetch a specific payment by ID from Tave.

Get Payment Method

Tool to retrieve a specific payment method by its ID.

Get Product

Tool to retrieve a specific product by its ID.

Get Product Type

Tool to retrieve a specific product type by its ID.

Get Profit Center

Tool to retrieve a specific profit center by its ID.

Get Tax Rate

Tool to retrieve a specific tax rate by its ULID.

Get Timezone

Tool to retrieve a specific timezone by its ULID from Tave.

Get User by ID

Tool to retrieve a specific user by their ULID identifier.

List Address Book Contacts

Tool to list contacts in the studio's address book.

List Brands

Tool to list brands of a studio.

List Discount Types

Tool to get a list of discount types from Tave.

List Studio Events

Tool to list a studio's events from Tave.

List Event Types

Tool to list a studio's event types.

List Files

Tool to list files in Tave.

List Resource Custom Fields

Tool to list custom fields configured on a studio.

List Resource Discount

Tool to get a list of discounts from Tave.

List Galleries

Tool to list all galleries for a studio.

List Resource Job

Tool to list jobs of a studio.

List Job Closed Reasons

Tool to list a studio's job closed reasons.

List Resource Job Contact

Tool to list a job's contacts.

List Resource Job Orders

Tool to list orders on a given job.

List Job Payments

Tool to get a list of payments for a specific job.

List Job Roles

Tool to list a studio's job roles.

List Resource Job Type

Tool to list job types of a studio.

List Resource Lead Source

Tool to list lead sources of a studio.

List Resource Lead Status

Tool to list lead statuses of a studio.

List Resource Note

Tool to list notes from Tave.

List Resource Order

Tool to get a list of all orders.

List Resource Payment

Tool to get a list of payments from Tave.

List Resource Payment Method

Tool to get a list of payment methods from Tave.

List Resource Product

Tool to get a list of products from Tave.

List Product Types

Tool to get a list of product types from Tave.

List Resource Profit Center

Tool to list profit centers of a studio.

List REST Hooks

Tool to list REST hooks configured in Tave.

List Resource Tax Groups

Tool to get a list of Tax Groups from Tave.

List Resource Tax Rates

Tool to get a list of tax rates from Tave.

List Resource Timezone

Tool to get a list of timezones from Tave.

List Resource User

Tool to list users of a studio.

Update Address Book Entry

Tool to update a specific entry in the Tave address book.

Update Brand

Tool to update a specific brand in Tave.

Update Event Type

Tool to update an existing event type in Tave.

Update Custom Field

Tool to update a specific custom field in Tave.

Update Event

Tool to update a specific event in Tave.

Update Gallery

Tool to update a specific gallery in Tave (VSCO Workspace).

Update Job

Tool to update a specific job in Tave (VSCO Workspace).

Update Job Closed Reason

Tool to update a job closed reason in Tave.

Update Job Contact

Tool to update a specific job contact in Tave.

Update Job Role

Tool to update a job role in Tave.

Update Job Type

Tool to update an existing job type in Tave.

Update Lead Source

Tool to update a specific lead source in Tave.

Update Lead Status

Tool to update a specific lead status in Tave.

Update Note

Tool to update a specific note in Tave.

Update Order

Tool to update a specific order in Tave (VSCO Workspace).

Update Profit Center

Tool to update a specific profit center in Tave.

Update Tax Group

Tool to update a specific tax group in Tave.

Update Tax Rate

Tool to update a specific tax rate in Tave.

Update User

Tool to update a specific user in Tave.

Update Studio Readonly Mode

Tool to set studio readonly mode in Tave.

FAQ

Frequently asked questions

With a standalone Tave MCP server, the agents and LLMs can only access a fixed set of Tave tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Tave and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Vercel AI SDK v6 fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Tave tools.

Yes, absolutely. You can configure which Tave scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Tave data and credentials are handled as safely as possible.

Start with Tave.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Tave tool your agent needs.Free to start.

Start building