# How to integrate Raisely MCP with Vercel AI SDK v6 ```json { "title": "How to integrate Raisely MCP with Vercel AI SDK v6", "toolkit": "Raisely", "toolkit_slug": "raisely", "framework": "Vercel AI SDK", "framework_slug": "ai-sdk", "url": "https://composio.dev/toolkits/raisely/framework/ai-sdk", "markdown_url": "https://composio.dev/toolkits/raisely/framework/ai-sdk.md", "updated_at": "2026-05-12T10:23:20.689Z" } ``` ## Introduction This guide walks you through connecting Raisely to Vercel AI SDK v6 using the Composio tool router. By the end, you'll have a working Raisely agent that can list all active fundraising campaigns, show all fundraising profiles for a campaign, retrieve recent posts from our raisely site through natural language commands. This guide will help you understand how to give your Vercel AI SDK agent real control over a Raisely account through Composio's Raisely MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved. ## Also integrate Raisely with - [OpenAI Agents SDK](https://composio.dev/toolkits/raisely/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/raisely/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/raisely/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/raisely/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/raisely/framework/codex) - [OpenClaw](https://composio.dev/toolkits/raisely/framework/openclaw) - [Hermes](https://composio.dev/toolkits/raisely/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/raisely/framework/cli) - [Google ADK](https://composio.dev/toolkits/raisely/framework/google-adk) - [LangChain](https://composio.dev/toolkits/raisely/framework/langchain) - [Mastra AI](https://composio.dev/toolkits/raisely/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/raisely/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/raisely/framework/crew-ai) ## TL;DR Here's what you'll learn: - How to set up and configure a Vercel AI SDK agent with Raisely integration - Using Composio's Tool Router to dynamically load and access Raisely 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 Raisely MCP server, and what's possible with it? The Raisely MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Raisely account. It provides structured and secure access to your fundraising campaigns, so your agent can perform actions like listing campaigns, managing profiles, retrieving fundraising posts, and overseeing users or webhook subscriptions on your behalf. - Campaign discovery and management: Instantly fetch and list all your Raisely campaigns, making it easy to organize or review ongoing fundraising efforts. - Profile and supporter insights: Retrieve detailed fundraising profiles within any campaign, or list all supporter profiles to track progress and engagement. - Posts and communications access: Pull all posts published on the Raisely platform, allowing your agent to keep you updated or summarize campaign communications. - User administration: Get a comprehensive list of users on your platform or drill into user-specific fundraising profiles, streamlining supporter management. - Webhook and event monitoring: View all configured webhook subscriptions and available event types, helping you automate notifications and stay on top of campaign activity. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `RAISELY_CHECK_PROFILE_URL` | Check Profile URL Availability | Tool to verify if a profile URL is available for a given campaign and get suggestions if unavailable. Use when creating a new profile to ensure the desired URL path is not already taken, or to get alternative path suggestions. | | `RAISELY_CHECK_USER` | Check User Registration | Tool to check if a user is already registered to a campaign with a specific email address. Use when validating sign-up forms to prompt existing users to log in instead of creating duplicate accounts. | | `RAISELY_CREATE_CAMPAIGN` | Create Campaign | Tool to create a new campaign in Raisely. Use when you need to create a new fundraising campaign or clone an existing one. | | `RAISELY_CREATE_DONATION` | Create Offline Donation | Tool to record an offline donation in Raisely. Use when recording donations that were processed externally (outside of Raisely's payment flow). These donations are marked with type=OFFLINE to indicate they were processed elsewhere. | | `RAISELY_CREATE_EXERCISE_LOG` | Create Exercise Log | Tool to create a new exercise log in Raisely. Use when you need to record physical activity data for a user, such as running, cycling, or swimming. Requires userUuid and profileUuid. | | `RAISELY_CREATE_INTERACTION` | Create Interaction | Tool to create a new interaction in Raisely. Use when you need to record an interaction event. Either categoryUuid or categoryPath must be provided. | | `RAISELY_CREATE_POST` | Create Post | Create a new post in Raisely. Use when you need to add a blog post or update to a profile or campaign. | | `RAISELY_CREATE_PROMO_CODE` | Create Promo Code | Tool to create a new promo code in Raisely. Use when you need to add discount codes for campaigns, create promotional offers, or set up limited-time discounts. | | `RAISELY_CREATE_WEBHOOK` | Create Webhook | Tool to add a new webhook to your Raisely account. Use when you need to subscribe to event notifications. By default, webhooks trigger for events across all campaigns unless a specific campaignUuid is provided. | | `RAISELY_DELETE_EXERCISE_LOG` | Delete Exercise Log | Tool to delete an exercise log from Raisely. Use when you need to remove a specific exercise log record by its UUID. Returns the deleted exercise log data for confirmation. | | `RAISELY_DELETE_INTERACTION` | Delete Interaction | Tool to delete an existing custom interaction from Raisely. Use when you need to remove a custom interaction by its UUID. Cannot delete system-generated or read-only interactions. | | `RAISELY_DELETE_POST` | Delete Raisely Post | Tool to delete a post from the Raisely platform. Use when you need to permanently remove a blog post by its path or UUID. Returns the deleted post record upon successful deletion. | | `RAISELY_DELETE_PROFILE` | Delete Profile | Tool to archive a profile in Raisely. Archived profiles are hidden from the campaign but not permanently deleted. Use when a fundraiser wants to remove their profile from public view or when cleaning up campaign profiles. | | `RAISELY_DELETE_WEBHOOK` | Delete Raisely Webhook | Tool to delete a webhook from the Raisely platform. Use when you need to permanently remove a webhook subscription by its UUID. Returns the deleted webhook record upon successful deletion. | | `RAISELY_GET_API_DOCS` | Retrieve Raisely API Documentation Summary | Retrieve a summary of the Raisely API documentation including metadata and sample endpoints. Returns the OpenAPI version, API info (title, version, description, contact), and a sample of available paths. Use this to understand the general structure of the Raisely API. | | `RAISELY_GET_AUTHENTICATE` | Authenticate Token | Authenticate a token to confirm it's valid and check the logged-in user. Use to verify token validity, get the authenticated user's details, and find the organisation UUID for future requests. | | `RAISELY_GET_AVAILABLE_EVENTS` | Get Available Events | Tool to retrieve a list of available Raisely webhook events. Use when you need to know all event types Raisely can send via webhooks. | | `RAISELY_GET_CAMPAIGN` | Get Campaign | Tool to retrieve a specific campaign from Raisely. Use when you need to get details for a single campaign by UUID, path, or domain. | | `RAISELY_GET_CAMPAIGN_PROFILE` | Get Campaign Profile | Tool to retrieve the campaign profile for a Raisely campaign. The campaign profile is the top-level profile for all profiles in the campaign. It is hidden from the fundraising website, but will have the same name, path, and goal as your campaign. | | `RAISELY_GET_CAMPAIGNS` | Get campaigns | Tool to retrieve a paginated list of campaigns from Raisely. Use when you need to list campaigns after obtaining a valid API token. | | `RAISELY_GET_CAMPAIGNS_PROFILES` | List Campaign Profiles | List all fundraising profiles in a Raisely campaign. Profiles represent individuals, teams, or organizations participating in a fundraising campaign. Returns profile details including name, fundraising goal, amount raised, and associated user information. Supports search, pagination, and sorting. Use 'limit' and 'offset' for paging through large result sets. | | `RAISELY_GET_EXERCISE_LOG` | Get Exercise Log | Retrieve a specific exercise log by UUID from the Raisely platform. Use when you need to fetch detailed information about a particular exercise activity. | | `RAISELY_GET_INTERACTION` | Get Interaction | Tool to retrieve a specific interaction from Raisely by its UUID. Use when you need to fetch details about a particular interaction record. | | `RAISELY_GET_POST` | Get Post | Tool to retrieve a specific post from the Raisely fundraising platform. Use when you need to fetch details of a single post by its UUID or path. | | `RAISELY_GET_PROFILE` | Get Profile | Retrieves a specific fundraising profile from Raisely by UUID or path. Use this tool to get detailed information about an individual, team, or organisation profile including fundraising totals, activity metrics, goals, and associated user information. Set private=true to access private custom fields when authenticated with proper permissions. | | `RAISELY_GET_PROFILES` | Raisely Get Profiles | Retrieves a paginated list of fundraising profiles for a Raisely campaign. Use this tool to: - List all fundraisers (profiles) in a campaign - Search for specific profiles by name or description - Filter profiles by user or organisation - Rank profiles by amount raised, donor count, or activity metrics - Paginate through large result sets The 'campaign' parameter is required and accepts a campaign UUID, path, or domain. | | `RAISELY_GET_USER` | Get User | Tool to retrieve a specific user from Raisely by UUID. Use when you need detailed information about a single user including their contact details, admin status, and custom fields. | | `RAISELY_GET_USER_PROFILES` | Get User Profiles | Tool to retrieve all profiles associated with a specific user. Use when you have a user UUID and need to list both public and optionally private profiles. | | `RAISELY_GET_USERS` | Get Users | Retrieve a paginated list of users from the Raisely platform. Returns all users in the organisation with optional pagination, sorting, and private data. Use the 'private' parameter to include sensitive user details like email, address, and phone number. Default limit is 100 records. Use 'offset' for pagination through large result sets. | | `RAISELY_LIST_CAMPAIGN_DONATIONS` | List Campaign Donations | Tool to retrieve donations from a specific campaign in Raisely. Returns a paginated list of donations in descending order by creation date (most recent first) unless otherwise specified. Use this when you need to view donation history, track fundraising progress, or analyze donor patterns for a campaign. | | `RAISELY_LIST_CAMPAIGN_PRODUCTS` | List Campaign Products | Retrieves all products available in a Raisely campaign. Use this to list tickets, merchandise, or other items configured for sale in a specific campaign. Products include details such as price, availability, and stock information. | | `RAISELY_LIST_CAMPAIGN_SUBSCRIPTIONS` | List Campaign Subscriptions | List all subscriptions for a specific Raisely campaign. Returns a paginated list of recurring donation subscriptions with detailed payment and subscriber information. Use when you need to retrieve subscriptions for a specific campaign by campaign UUID, path, or domain. Supports filtering by status, mode, source, user, and search queries, with sorting and pagination options. | | `RAISELY_LIST_DONATIONS` | Raisely List Donations | Retrieve donations from Raisely. Returns a paginated list of all donations in descending order of creation time (unless specified otherwise). Use this to view donation history, analyze giving patterns, or track specific donations by status, campaign, or user. Supports extensive filtering and sorting options. | | `RAISELY_LIST_EXERCISE_LOGS` | Raisely List Exercise Logs | Retrieve exercise logs from Raisely. Returns a paginated list of exercise logs you've previously created, in descending order of when they were created unless specified otherwise. Use this to view exercise activities, track fitness progress, or analyze activity data for fundraising campaigns. | | `RAISELY_LIST_INTERACTION_CATEGORIES` | List Interaction Categories | Tool to retrieve all interaction categories in the organisation from Raisely. Use when you need to list available interaction categories for categorizing supporter interactions, such as phone calls, emails, or meetings. Supports search, filtering, sorting, and pagination. | | `RAISELY_LIST_INTERACTIONS` | List Interactions | Tool to retrieve all interactions from Raisely. Use when you need to list user interactions, track engagement history, or audit activity records. Supports filtering by user, category, and text search with pagination and sorting options. | | `RAISELY_LIST_ORDERS` | List Orders | Tool to retrieve all orders in a campaign from Raisely. Use when you need to list orders, view order details, or analyze purchase data. Supports filtering, sorting, and pagination. | | `RAISELY_LIST_POSTS` | List Posts | Tool to retrieve a list of posts you've previously created on Raisely. Posts are returned in descending order of creation date by default, unless you specify otherwise using the 'sort' and 'order' parameters. | | `RAISELY_LIST_PROFILE_DONATIONS` | List Profile Donations | Retrieves a paginated list of donations for a specific fundraising profile from Raisely. Returns donations in descending order of creation date by default (most recent first). Use this tool to: - View all donations received by a specific fundraiser profile - Track donation history for reporting and analysis - Search for specific donations by donor information - Filter donations by status, type, currency, or other criteria - Monitor suspicious or fraudulent donations for a profile | | `RAISELY_LIST_PROFILE_MEMBERS` | List Profile Members | Retrieves a paginated list of all members belonging to a team profile in Raisely. Use this tool when you need to list all individual fundraisers who are members of a specific team. The 'path' parameter is required and accepts either the team profile's UUID or its path/slug. | | `RAISELY_LIST_PROFILE_POSTS` | List Profile Posts | List all posts created by a specific profile in Raisely. Returns posts in descending order of creation date by default (newest first). Use when you need to retrieve a profile's activity feed or blog posts. | | `RAISELY_LIST_PROMO_CODES` | List Promo Codes | Tool to retrieve all promo codes in a campaign from Raisely. Use when you need to list available discount codes, view promo code details, or check usage statistics for promotional campaigns. | | `RAISELY_LIST_SEGMENTS` | List Segments | Tool to retrieve all segments from Raisely. Use when you need to list previously created segments, view segment definitions, or filter segments by sharing status. Results are returned in descending order of creation time unless specified otherwise. | | `RAISELY_LIST_SUBSCRIPTIONS2` | Raisely List Subscriptions 2 | Tool to retrieve subscriptions from Raisely. Returns a list of subscriptions you've previously created in descending order of creation time. Use when you need to view subscription history, analyze recurring donation patterns, or filter subscriptions by status, campaign, user, or other criteria. | | `RAISELY_LIST_TAGS` | List Tags | Tool to retrieve the list of tags from Raisely. Use when you need to fetch all available tags for categorization or filtering purposes. Note that tags flagged as private will not be included unless the 'private' parameter is set to true (requires authentication). | | `RAISELY_LIST_USER_DONATIONS` | List User Donations | Retrieves a paginated list of donations for a specific user from Raisely. Returns donations in descending order of creation date by default (most recent first). Use this to view all donations created by or associated with a specific user. | | `RAISELY_LIST_USER_INTERACTIONS` | List User Interactions | Retrieves all interactions for a given user from Raisely. Returns a paginated list of user activities including donations, profile updates, comments, and other events. Use this to track user engagement and activity history. Supports filtering by category, search queries, and pagination options. | | `RAISELY_LIST_USER_SUBSCRIPTIONS` | Raisely List User Subscriptions | Retrieve subscriptions for a specific user from Raisely. Returns a paginated list of subscriptions in descending order of creation time (unless specified otherwise). Use this to view recurring donation patterns for a specific user, identify their active subscriptions, or track subscription history. | | `RAISELY_LIST_WEBHOOKS` | List Webhooks | Tool to retrieve the list of webhooks configured for a campaign. Use when you need to list all webhook subscriptions for a specific campaign after authenticating. | | `RAISELY_MOVE_DONATION` | Move Donation | Tool to move a donation to a different profile in Raisely. Use when you need to reassign a donation from one fundraiser or campaign profile to another. The target profile may be in a different campaign. | | `RAISELY_POST_LOGOUT` | Logout from Raisely | Tool to invalidate the current user's token and log out. Use when ending an authenticated Raisely session to ensure the token is invalidated. | | `RAISELY_POST_USERS` | Create User | Create a new user in Raisely. Fails if a user with the same email already exists. Use for adding new users to your organization's user database. | | `RAISELY_UPDATE_CAMPAIGN` | Update Campaign | Tool to update an existing campaign in Raisely. Use when you need to modify campaign settings like name, goal, mode, or custom fields. The campaign can be identified by its UUID, path, or domain. Only provide the fields you want to update. | | `RAISELY_UPDATE_CAMPAIGN_CONFIG` | Update Campaign Config | Tool to update a specific configuration attribute for a campaign in Raisely. Use when you need to modify campaign settings or custom configuration values. | | `RAISELY_UPDATE_EXERCISE_LOG` | Update Exercise Log | Update an existing exercise log in Raisely. Use when you need to modify distance, time, activity type, or other details of a logged exercise. | | `RAISELY_UPDATE_POST` | Update Post | Tool to update a specified post in Raisely. Use when you need to modify an existing post's title, body, date, path, or photo URL. Requires the post's UUID or path identifier. | | `RAISELY_UPDATE_PROFILE` | Update Profile | Updates a specific profile in Raisely. Use when you need to modify profile details like description, goal, name, photo, or custom fields. | | `RAISELY_UPDATE_USER` | Update User | Tool to update a specified user in Raisely. Use when you need to modify an existing user's profile information, contact details, or custom fields. | | `RAISELY_UPDATE_WEBHOOK` | Update Webhook | Tool to update a specified webhook in Raisely. Use when you need to modify an existing webhook's URL, events, or secret. Requires the webhook's UUID identifier. | | `RAISELY_UPLOAD_CAMPAIGN_MEDIA` | Upload Campaign Media | Tool to upload one or more files to a campaign's media library in Raisely. Use when you need to add images, documents, or other media files to a specific campaign folder. | | `RAISELY_UPSERT_USER` | Upsert User | Tool to upsert a user record in Raisely, optionally tagging and creating an interaction. Use when accepting form submissions or creating/updating user records. Creates a new user if the email doesn't exist, or updates the existing user if it does. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Raisely MCP server is an implementation of the Model Context Protocol that connects your AI agent to Raisely. It provides structured and secure access so your agent can perform Raisely operations on your behalf through a secure, permission-based interface. With Composio's managed implementation, you don't have to create your own developer app. For production, if you're building an end product, we recommend using your own credentials. The managed server helps you prototype fast and go from 0-1 faster. ## Step-by-step Guide ### 1. Prerequisites Before you begin, make sure you have: - Node.js and npm installed - A Composio account with API key - An OpenAI API key ### 1. Getting API Keys for OpenAI and Composio OpenAI API Key - Go to the [OpenAI dashboard](https://platform.openai.com/settings/organization/api-keys) 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](https://dashboard.composio.dev?utm_source=toolkits&utm_medium=framework_docs). - Navigate to your API settings and generate a new API key. - Store this key securely as you'll need it for authentication. ### 2. Install required dependencies 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 ```bash npm install @ai-sdk/openai @ai-sdk/mcp @composio/core ai dotenv ``` ### 3. Set up environment variables 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 ```bash OPENAI_API_KEY=your_openai_api_key_here COMPOSIO_API_KEY=your_composio_api_key_here COMPOSIO_USER_ID=your_user_id_here ``` ### 4. Import required modules and validate environment 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 ```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, }); ``` ### 5. Create Tool Router session and initialize MCP client What's happening: - We're creating a Tool Router session that gives your agent access to Raisely 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 Raisely-related tools through the MCP protocol ```typescript async function main() { // Create a tool router session for the user const session = await composio.create(composioUserID!, { toolkits: ["raisely"], }); const mcpUrl = session.mcp.url; ``` ### 6. Connect to MCP server and retrieve 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 Raisely tools that the agent can use ```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(); ``` ### 7. Initialize conversation and CLI interface 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 ```typescript let messages: ModelMessage[] = []; console.log("Chat started! Type 'exit' or 'quit' to end the conversation.\n"); console.log( "Ask any questions related to raisely, like summarize my last 5 emails, send an email, etc... :)))\n", ); const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: "> ", }); rl.prompt(); ``` ### 8. Handle user input and stream responses with real-time tool feedback 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 Raisely 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 ```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); }); ``` ## Complete Code ```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: ["raisely"], }); 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 raisely, 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 Raisely 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. ## How to build Raisely MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/raisely/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/raisely/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/raisely/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/raisely/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/raisely/framework/codex) - [OpenClaw](https://composio.dev/toolkits/raisely/framework/openclaw) - [Hermes](https://composio.dev/toolkits/raisely/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/raisely/framework/cli) - [Google ADK](https://composio.dev/toolkits/raisely/framework/google-adk) - [LangChain](https://composio.dev/toolkits/raisely/framework/langchain) - [Mastra AI](https://composio.dev/toolkits/raisely/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/raisely/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/raisely/framework/crew-ai) ## Related Toolkits - [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable. - [Google Calendar](https://composio.dev/toolkits/googlecalendar) - Google Calendar is a time management service for scheduling meetings, events, and reminders. It streamlines personal and team organization with integrated notifications and sharing options. - [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices. - [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management. - [Twitter](https://composio.dev/toolkits/twitter) - Twitter is a social media platform for sharing real-time updates, conversations, and news. Stay connected, informed, and engaged with communities worldwide. - [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly. - [Supabase](https://composio.dev/toolkits/supabase) - Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure. - [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed. - [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place. - [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place. - [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations. - [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze. - [Google Super](https://composio.dev/toolkits/googlesuper) - Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization. - [Hubspot](https://composio.dev/toolkits/hubspot) - HubSpot is an all-in-one marketing, sales, and customer service platform. It lets teams nurture leads, automate outreach, and track every customer interaction in one place. - [Codeinterpreter](https://composio.dev/toolkits/codeinterpreter) - Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms. - [Gong](https://composio.dev/toolkits/gong) - Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action. - [Asana](https://composio.dev/toolkits/asana) - Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals. - [Ashby](https://composio.dev/toolkits/ashby) - Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics. - [Pipedrive](https://composio.dev/toolkits/pipedrive) - Pipedrive is a sales management platform offering pipeline visualization, lead tracking, and workflow automation. It helps sales teams keep deals moving forward efficiently and never miss a follow-up. - [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Raisely MCP? With a standalone Raisely MCP server, the agents and LLMs can only access a fixed set of Raisely tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Raisely and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Vercel AI SDK v6? 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 Raisely tools. ### Can I manage the permissions and scopes for Raisely while using Tool Router? Yes, absolutely. You can configure which Raisely 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. ### How safe is my data with Composio Tool Router? 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 Raisely data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)