# How to integrate Raisely MCP with Claude Agent SDK ```json { "title": "How to integrate Raisely MCP with Claude Agent SDK", "toolkit": "Raisely", "toolkit_slug": "raisely", "framework": "Claude Agent SDK", "framework_slug": "claude-agents-sdk", "url": "https://composio.dev/toolkits/raisely/framework/claude-agents-sdk", "markdown_url": "https://composio.dev/toolkits/raisely/framework/claude-agents-sdk.md", "updated_at": "2026-05-12T10:23:20.689Z" } ``` ## Introduction This guide walks you through connecting Raisely to the Claude Agent SDK 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 Claude Agent 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 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: - Get and set up your Claude/Anthropic and Composio API keys - Install the necessary dependencies - Initialize Composio and create a Tool Router session for Raisely - Configure an AI agent that can use Raisely as a tool - Run a live chat session where you can ask the agent to perform Raisely operations ## What is Claude Agent SDK? The Claude Agent SDK is Anthropic's official framework for building AI agents powered by Claude. It provides a streamlined interface for creating agents with MCP tool support and conversation management. Key features include: - Native MCP Support: Built-in support for Model Context Protocol servers - Permission Modes: Control tool execution permissions - Streaming Responses: Real-time response streaming for interactive applications - Context Manager: Clean async context management for sessions ## 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: - Composio API Key and Claude/Anthropic API Key - Primary know-how of Claude Agents SDK - A Raisely account - Some knowledge of Python ### 1. Getting API Keys for Claude/Anthropic and Composio Claude/Anthropic API Key - Go to the [Anthropic Console](https://console.anthropic.com/settings/organization/api-keys) and create an API key. You'll need credits to use the models. - 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 No description provided. ```python pip install composio-anthropic claude-agent-sdk python-dotenv ``` ```typescript npm install @anthropic-ai/claude-agent-sdk @composio/core dotenv ``` ### 3. Set up environment variables Create a .env file in your project root. What's happening: - COMPOSIO_API_KEY authenticates with Composio - USER_ID identifies the user for session management - ANTHROPIC_API_KEY authenticates with Anthropic/Claude ```bash COMPOSIO_API_KEY=your_composio_api_key_here USER_ID=your_user_id_here ANTHROPIC_API_KEY=your_anthropic_api_key_here ``` ### 4. Import dependencies No description provided. ```python import asyncio from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions import os from composio import Composio from dotenv import load_dotenv load_dotenv() ``` ```typescript import 'dotenv/config'; import readline from 'node:readline'; import { Composio } from '@composio/core'; import { query, type Options } from "@anthropic-ai/claude-agent-sdk"; dotenv.config(); ``` ### 5. Create a Composio instance and Tool Router session No description provided. ```python async def chat_with_remote_mcp(): api_key = os.getenv("COMPOSIO_API_KEY") if not api_key: raise RuntimeError("COMPOSIO_API_KEY is not set") composio = Composio(api_key=api_key) # Create Tool Router session for Raisely mcp_server = composio.create( user_id=os.getenv("USER_ID"), toolkits=["raisely"] ) url = mcp_server.mcp.url if not url: raise ValueError("Session URL not found") ``` ```typescript async function chat() { const { COMPOSIO_API_KEY, USER_ID } = process.env; if (!COMPOSIO_API_KEY || !USER_ID) { throw new Error('COMPOSIO_API_KEY and USER_ID required in .env'); } const composio = new Composio({ apiKey: COMPOSIO_API_KEY }); // Create Tool Router session for Raisely const session = await composio.create(USER_ID, { toolkits: ['raisely'], }); const mcpUrl = session?.mcp.url; ``` ### 6. Configure Claude Agent with MCP No description provided. ```python # Configure remote MCP server for Claude options = ClaudeAgentOptions( permission_mode="bypassPermissions", mcp_servers={ "composio": { "type": "http", "url": url, "headers": { "x-api-key": os.getenv("COMPOSIO_API_KEY") } } }, system_prompt="You are a helpful assistant with access to Raisely tools via Composio.", max_turns=10 ) ``` ```typescript const options: Options = { permissionMode: 'bypassPermissions', mcpServers: { composio: { type: 'http', url: mcpUrl, headers: { 'x-api-key': COMPOSIO_API_KEY } } }, systemPrompt: 'You are a helpful assistant with access to Raisely tools via Composio.', maxTurns: 10, }; ``` ### 7. Create client and start chat loop No description provided. ```python # Create client with context manager async with ClaudeSDKClient(options=options) as client: print("\nChat started. Type 'exit' or 'quit' to end.\n") # Main chat loop while True: user_input = input("You: ").strip() if user_input.lower() in {"exit", "quit"}: print("Goodbye!") break # Send query await client.query(user_input) # Receive and print response print("Claude: ", end="", flush=True) async for message in client.receive_response(): if hasattr(message, "content"): for block in message.content: if hasattr(block, "text"): print(block.text, end="", flush=True) print() ``` ```typescript const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: 'You: ' }); console.log('\nChat started. Type "exit" to quit.\n'); let isProcessing = false; async function ask(prompt: string) { isProcessing = true; rl.pause(); process.stdout.write('Claude is thinking...'); const stream = query({ prompt, options }); let firstChunk = true; for await (const msg of stream) { const content = (msg as any).message?.content || (msg as any).content; if (Array.isArray(content)) { for (const block of content) { if (block.type === 'text' && block.text) { if (firstChunk) { process.stdout.write('\r\x1b[K'); process.stdout.write('Claude: '); firstChunk = false; } process.stdout.write(block.text); } } } } process.stdout.write('\n\n'); isProcessing = false; rl.resume(); rl.prompt(); } rl.on('line', async (line) => { if (isProcessing) return; const input = line.trim(); if (input === 'exit') { rl.close(); process.exit(0); } if (input) await ask(input); else rl.prompt(); }); await ask('What can you help me with?'); } ``` ### 8. Run the application No description provided. ```python if __name__ == "__main__": asyncio.run(chat_with_remote_mcp()) ``` ```typescript try { await chat(); } catch (error) { console.error(error); process.exit(1); } ``` ## Complete Code ```python import asyncio from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions import os from composio import Composio from dotenv import load_dotenv load_dotenv() async def chat_with_remote_mcp(): api_key = os.getenv("COMPOSIO_API_KEY") if not api_key: raise RuntimeError("COMPOSIO_API_KEY is not set") composio = Composio(api_key=api_key) # Create Tool Router session for Raisely mcp_server = composio.create( user_id=os.getenv("USER_ID"), toolkits=["raisely"] ) url = mcp_server.mcp.url if not url: raise ValueError("Session URL not found") # Configure remote MCP server for Claude options = ClaudeAgentOptions( permission_mode="bypassPermissions", mcp_servers={ "composio": { "type": "http", "url": url, "headers": { "x-api-key": os.getenv("COMPOSIO_API_KEY") } } }, system_prompt="You are a helpful assistant with access to Raisely tools via Composio.", max_turns=10 ) # Create client with context manager async with ClaudeSDKClient(options=options) as client: print("\nChat started. Type 'exit' or 'quit' to end.\n") # Main chat loop while True: user_input = input("You: ").strip() if user_input.lower() in {"exit", "quit"}: print("Goodbye!") break # Send query await client.query(user_input) # Receive and print response print("Claude: ", end="", flush=True) async for message in client.receive_response(): if hasattr(message, "content"): for block in message.content: if hasattr(block, "text"): print(block.text, end="", flush=True) print() if __name__ == "__main__": asyncio.run(chat_with_remote_mcp()) ``` ```typescript import 'dotenv/config'; import readline from 'node:readline'; import { Composio } from '@composio/core'; import { query, type Options } from "@anthropic-ai/claude-agent-sdk"; async function chat() { const { COMPOSIO_API_KEY, USER_ID } = process.env; if (!COMPOSIO_API_KEY || !USER_ID) { throw new Error('COMPOSIO_API_KEY and USER_ID required in .env'); } const composio = new Composio({ apiKey: COMPOSIO_API_KEY }); const session = await composio.create(USER_ID, { toolkits: ['raisely'] }); const mcp_url = session?.mcp.url; const options: Options = { permissionMode: 'bypassPermissions', mcpServers: { composio: { type: 'http', url: mcp_url, headers: { 'x-api-key': COMPOSIO_API_KEY } } }, systemPrompt: 'You are a helpful assistant with access to Raisely tools via Composio.', maxTurns: 10, }; const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: 'You: ' }); console.log('\nChat started. Type "exit" to quit.\n'); let isProcessing = false; async function ask(prompt: string) { isProcessing = true; rl.pause(); process.stdout.write('Claude is thinking...'); const stream = query({ prompt, options }); let firstChunk = true; for await (const msg of stream) { const content = (msg as any).message?.content || (msg as any).content; if (Array.isArray(content)) { for (const block of content) { if (block.type === 'text' && block.text) { if (firstChunk) { process.stdout.write('\r\x1b[K'); process.stdout.write('Claude: '); firstChunk = false; } process.stdout.write(block.text); } } } } process.stdout.write('\n\n'); isProcessing = false; rl.resume(); rl.prompt(); } rl.on('line', async (line) => { if (isProcessing) return; const input = line.trim(); if (input === 'exit') { rl.close(); process.exit(0); } if (input) await ask(input); else rl.prompt(); }); await ask('What can you help me with?'); } try { await chat(); } catch (error) { console.error(error); process.exit(1); } ``` ## Conclusion You've successfully built a Claude Agent SDK agent that can interact with Raisely through Composio's Tool Router. Key features: - Native MCP support through Claude's agent framework - Streaming responses for real-time interaction - Permission bypass for smooth automated workflows You can extend this by adding more toolkits, implementing custom business logic, or building a web interface around the agent. ## How to build Raisely MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/raisely/framework/open-ai-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 Claude Agent SDK? Yes, you can. Claude Agent SDK 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)