# How to integrate Raisely MCP with Pydantic AI ```json { "title": "How to integrate Raisely MCP with Pydantic AI", "toolkit": "Raisely", "toolkit_slug": "raisely", "framework": "Pydantic AI", "framework_slug": "pydantic-ai", "url": "https://composio.dev/toolkits/raisely/framework/pydantic-ai", "markdown_url": "https://composio.dev/toolkits/raisely/framework/pydantic-ai.md", "updated_at": "2026-05-12T10:23:20.689Z" } ``` ## Introduction This guide walks you through connecting Raisely to Pydantic AI 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 Pydantic AI 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) - [Vercel AI SDK](https://composio.dev/toolkits/raisely/framework/ai-sdk) - [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 your Composio API key and User ID - How to create a Composio Tool Router session for Raisely - How to attach an MCP Server to a Pydantic AI agent - How to stream responses and maintain chat history - How to build a simple REPL-style chat interface to test your Raisely workflows ## What is Pydantic AI? Pydantic AI is a Python framework for building AI agents with strong typing and validation. It leverages Pydantic's data validation capabilities to create robust, type-safe AI applications. Key features include: - Type Safety: Built on Pydantic for automatic data validation - MCP Support: Native support for Model Context Protocol servers - Streaming: Built-in support for streaming responses - Async First: Designed for async/await patterns ## 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 starting, make sure you have: - Python 3.9 or higher - A Composio account with an active API key - Basic familiarity with Python and async programming ### 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 dependencies Install the required libraries. What's happening: - composio connects your agent to external SaaS tools like Raisely - pydantic-ai lets you create structured AI agents with tool support - python-dotenv loads your environment variables securely from a .env file ```bash pip install composio pydantic-ai python-dotenv ``` ### 3. Set up environment variables Create a .env file in your project root. What's happening: - COMPOSIO_API_KEY authenticates your agent to Composio's API - USER_ID associates your session with your account for secure tool access - OPENAI_API_KEY to access OpenAI LLMs ```bash COMPOSIO_API_KEY=your_composio_api_key_here USER_ID=your_user_id_here OPENAI_API_KEY=your_openai_api_key ``` ### 4. Import dependencies What's happening: - We load environment variables and import required modules - Composio manages connections to Raisely - MCPServerStreamableHTTP connects to the Raisely MCP server endpoint - Agent from Pydantic AI lets you define and run the AI assistant ```python import asyncio import os from dotenv import load_dotenv from composio import Composio from pydantic_ai import Agent from pydantic_ai.mcp import MCPServerStreamableHTTP load_dotenv() ``` ### 5. Create a Tool Router Session 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 session.mcp.url is the MCP server URL that your agent will use ```python async def main(): api_key = os.getenv("COMPOSIO_API_KEY") user_id = os.getenv("USER_ID") if not api_key or not user_id: raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment") # Create a Composio Tool Router session for Raisely composio = Composio(api_key=api_key) session = composio.create( user_id=user_id, toolkits=["raisely"], ) url = session.mcp.url if not url: raise ValueError("Composio session did not return an MCP URL") ``` ### 6. Initialize the Pydantic AI Agent What's happening: - The MCP client connects to the Raisely endpoint - The agent uses GPT-5 to interpret user commands and perform Raisely operations - The instructions field defines the agent's role and behavior ```python # Attach the MCP server to a Pydantic AI Agent raisely_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY}) agent = Agent( "openai:gpt-5", toolsets=[raisely_mcp], instructions=( "You are a Raisely assistant. Use Raisely tools to help users " "with their requests. Ask clarifying questions when needed." ), ) ``` ### 7. Build the chat interface What's happening: - The agent reads input from the terminal and streams its response - Raisely API calls happen automatically under the hood - The model keeps conversation history to maintain context across turns ```python # Simple REPL with message history history = [] print("Chat started! Type 'exit' or 'quit' to end.\n") print("Try asking the agent to help you with Raisely.\n") while True: user_input = input("You: ").strip() if user_input.lower() in {"exit", "quit", "bye"}: print("\nGoodbye!") break if not user_input: continue print("\nAgent is thinking...\n", flush=True) async with agent.run_stream(user_input, message_history=history) as stream_result: collected_text = "" async for chunk in stream_result.stream_output(): text_piece = None if isinstance(chunk, str): text_piece = chunk elif hasattr(chunk, "delta") and isinstance(chunk.delta, str): text_piece = chunk.delta elif hasattr(chunk, "text"): text_piece = chunk.text if text_piece: collected_text += text_piece result = stream_result print(f"Agent: {collected_text}\n") history = result.all_messages() ``` ### 8. Run the application What's happening: - The asyncio loop launches the agent and keeps it running until you exit ```python if __name__ == "__main__": asyncio.run(main()) ``` ## Complete Code ```python import asyncio import os from dotenv import load_dotenv from composio import Composio from pydantic_ai import Agent from pydantic_ai.mcp import MCPServerStreamableHTTP load_dotenv() async def main(): api_key = os.getenv("COMPOSIO_API_KEY") user_id = os.getenv("USER_ID") if not api_key or not user_id: raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment") # Create a Composio Tool Router session for Raisely composio = Composio(api_key=api_key) session = composio.create( user_id=user_id, toolkits=["raisely"], ) url = session.mcp.url if not url: raise ValueError("Composio session did not return an MCP URL") # Attach the MCP server to a Pydantic AI Agent raisely_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY}) agent = Agent( "openai:gpt-5", toolsets=[raisely_mcp], instructions=( "You are a Raisely assistant. Use Raisely tools to help users " "with their requests. Ask clarifying questions when needed." ), ) # Simple REPL with message history history = [] print("Chat started! Type 'exit' or 'quit' to end.\n") print("Try asking the agent to help you with Raisely.\n") while True: user_input = input("You: ").strip() if user_input.lower() in {"exit", "quit", "bye"}: print("\nGoodbye!") break if not user_input: continue print("\nAgent is thinking...\n", flush=True) async with agent.run_stream(user_input, message_history=history) as stream_result: collected_text = "" async for chunk in stream_result.stream_output(): text_piece = None if isinstance(chunk, str): text_piece = chunk elif hasattr(chunk, "delta") and isinstance(chunk.delta, str): text_piece = chunk.delta elif hasattr(chunk, "text"): text_piece = chunk.text if text_piece: collected_text += text_piece result = stream_result print(f"Agent: {collected_text}\n") history = result.all_messages() if __name__ == "__main__": asyncio.run(main()) ``` ## Conclusion You've built a Pydantic AI agent that can interact with Raisely through Composio's Tool Router. With this setup, your agent can perform real Raisely actions through natural language. You can extend this further by: - Adding other toolkits like Gmail, HubSpot, or Salesforce - Building a web-based chat interface around this agent - Using multiple MCP endpoints to enable cross-app workflows (for example, Gmail + Raisely for workflow automation) This architecture makes your AI agent "agent-native", able to securely use APIs in a unified, composable way without custom integrations. ## 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) - [Vercel AI SDK](https://composio.dev/toolkits/raisely/framework/ai-sdk) - [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 Pydantic AI? Yes, you can. Pydantic AI 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)