# How to integrate Raisely MCP with OpenAI Agents SDK

```json
{
  "title": "How to integrate Raisely MCP with OpenAI Agents SDK",
  "toolkit": "Raisely",
  "toolkit_slug": "raisely",
  "framework": "OpenAI Agents SDK",
  "framework_slug": "open-ai-agents-sdk",
  "url": "https://composio.dev/toolkits/raisely/framework/open-ai-agents-sdk",
  "markdown_url": "https://composio.dev/toolkits/raisely/framework/open-ai-agents-sdk.md",
  "updated_at": "2026-05-12T10:23:20.689Z"
}
```

## Introduction

This guide walks you through connecting Raisely to the OpenAI Agents 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 OpenAI Agents 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

- [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:
- Get and set up your OpenAI 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 OpenAI Agents SDK?

The OpenAI Agents SDK is a lightweight framework for building AI agents that can use tools and maintain conversation state. It provides a simple interface for creating agents with hosted MCP tool support.
Key features include:
- Hosted MCP Tools: Connect to external services through hosted MCP endpoints
- SQLite Sessions: Persist conversation history across interactions
- Simple API: Clean interface with Agent, Runner, and tool configuration
- Streaming Support: Real-time response streaming for interactive applications

## 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 OpenAI API Key
- Primary know-how of OpenAI Agents SDK
- A live Raisely project
- Some knowledge of Python or Typescript

### 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).
- Go to Settings and copy your API key.

### 2. Install dependencies

Install the Composio SDK and the OpenAI Agents SDK.
```python
pip install composio_openai_agents openai-agents python-dotenv
```

```typescript
npm install @composio/openai-agents @openai/agents dotenv
```

### 3. Set up environment variables

Create a .env file and add your OpenAI and Composio API keys.
```bash
OPENAI_API_KEY=sk-...your-api-key
COMPOSIO_API_KEY=your-api-key
USER_ID=composio_user@gmail.com
```

### 4. Import dependencies

What's happening:
- You're importing all necessary libraries.
- The Composio and OpenAIAgentsProvider classes are imported to connect your OpenAI agent to Composio tools like Raisely.
```python
import asyncio
import os
from dotenv import load_dotenv

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner, HostedMCPTool, SQLiteSession
```

```typescript
import 'dotenv/config';
import { Composio } from '@composio/core';
import { OpenAIAgentsProvider } from '@composio/openai-agents';
import { Agent, hostedMcpTool, run, OpenAIConversationsSession } from '@openai/agents';
import * as readline from 'readline';
```

### 5. Set up the Composio instance

No description provided.
```python
load_dotenv()

api_key = os.getenv("COMPOSIO_API_KEY")
user_id = os.getenv("USER_ID")

if not api_key:
    raise RuntimeError("COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key")

# Initialize Composio
composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())
```

```typescript
dotenv.config();

const composioApiKey = process.env.COMPOSIO_API_KEY;
const userId = process.env.USER_ID;

if (!composioApiKey) {
  throw new Error('COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key');
}
if (!userId) {
  throw new Error('USER_ID is not set');
}

// Initialize Composio
const composio = new Composio({
  apiKey: composioApiKey,
  provider: new OpenAIAgentsProvider(),
});
```

### 6. Create a Tool Router session

What is happening:
- You give the Tool Router the user id and the toolkits you want available. Here, it is only raisely.
- The router checks the user's Raisely connection and prepares the MCP endpoint.
- The returned session.mcp.url is the MCP URL that your agent will use to access Raisely.
- This approach keeps things lightweight and lets the agent request Raisely tools only when needed during the conversation.
```python
# Create a Raisely Tool Router session
session = composio.create(
    user_id=user_id,
    toolkits=["raisely"]
)

mcp_url = session.mcp.url
```

```typescript
// Create Tool Router session for Raisely
const session = await composio.create(userId as string, {
  toolkits: ['raisely'],
});
const mcpUrl = session.mcp.url;
```

### 7. Configure the agent

No description provided.
```python
# Configure agent with MCP tool
agent = Agent(
    name="Assistant",
    model="gpt-5",
    instructions=(
        "You are a helpful assistant that can access Raisely. "
        "Help users perform Raisely operations through natural language."
    ),
    tools=[
        HostedMCPTool(
            tool_config={
                "type": "mcp",
                "server_label": "tool_router",
                "server_url": mcp_url,
                "headers": {"x-api-key": api_key},
                "require_approval": "never",
            }
        )
    ],
)
```

```typescript
// Configure agent with MCP tool
const agent = new Agent({
  name: 'Assistant',
  model: 'gpt-5',
  instructions:
    'You are a helpful assistant that can access Raisely. Help users perform Raisely operations through natural language.',
  tools: [
    hostedMcpTool({
      serverLabel: 'tool_router',
      serverUrl: mcpUrl,
      headers: { 'x-api-key': composioApiKey },
      requireApproval: 'never',
    }),
  ],
});
```

### 8. Start chat loop and handle conversation

No description provided.
```python
print("\nComposio Tool Router session created.")

chat_session = SQLiteSession("conversation_openai_toolrouter")

print("\nChat started. Type your requests below.")
print("Commands: 'exit', 'quit', or 'q' to end\n")

async def main():
    try:
        result = await Runner.run(
            agent,
            "What can you help me with?",
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")
    except Exception as e:
        print(f"Error: {e}\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "q"}:
            print("Goodbye!")
            break

        result = await Runner.run(
            agent,
            user_input,
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")

asyncio.run(main())
```

```typescript
// Keep conversation state across turns
const conversationSession = new OpenAIConversationsSession();

// Simple CLI
const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: 'You: ',
});

console.log('\nComposio Tool Router session created.');
console.log('\nChat started. Type your requests below.');
console.log("Commands: 'exit', 'quit', or 'q' to end\n");

try {
  const first = await run(agent, 'What can you help me with?', { session: conversationSession });
  console.log(`Assistant: ${first.finalOutput}\n`);
} catch (e) {
  console.error('Error:', e instanceof Error ? e.message : e, '\n');
}

rl.prompt();

rl.on('line', async (userInput) => {
  const text = userInput.trim();

  if (['exit', 'quit', 'q'].includes(text.toLowerCase())) {
    console.log('Goodbye!');
    rl.close();
    process.exit(0);
  }

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

  try {
    const result = await run(agent, text, { session: conversationSession });
    console.log(`\nAssistant: ${result.finalOutput}\n`);
  } catch (e) {
    console.error('Error:', e instanceof Error ? e.message : e, '\n');
  }

  rl.prompt();
});

rl.on('close', () => {
  console.log('\n👋 Session ended.');
  process.exit(0);
});
```

## Complete Code

```python
import asyncio
import os
from dotenv import load_dotenv

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner, HostedMCPTool, SQLiteSession

load_dotenv()

api_key = os.getenv("COMPOSIO_API_KEY")
user_id = os.getenv("USER_ID")

if not api_key:
    raise RuntimeError("COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key")

# Initialize Composio
composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())

# Create Tool Router session
session = composio.create(
    user_id=user_id,
    toolkits=["raisely"]
)
mcp_url = session.mcp.url

# Configure agent with MCP tool
agent = Agent(
    name="Assistant",
    model="gpt-5",
    instructions=(
        "You are a helpful assistant that can access Raisely. "
        "Help users perform Raisely operations through natural language."
    ),
    tools=[
        HostedMCPTool(
            tool_config={
                "type": "mcp",
                "server_label": "tool_router",
                "server_url": mcp_url,
                "headers": {"x-api-key": api_key},
                "require_approval": "never",
            }
        )
    ],
)

print("\nComposio Tool Router session created.")

chat_session = SQLiteSession("conversation_openai_toolrouter")

print("\nChat started. Type your requests below.")
print("Commands: 'exit', 'quit', or 'q' to end\n")

async def main():
    try:
        result = await Runner.run(
            agent,
            "What can you help me with?",
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")
    except Exception as e:
        print(f"Error: {e}\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "q"}:
            print("Goodbye!")
            break

        result = await Runner.run(
            agent,
            user_input,
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")

asyncio.run(main())
```

```typescript
import 'dotenv/config';
import { Composio } from '@composio/core';
import { OpenAIAgentsProvider } from '@composio/openai-agents';
import { Agent, hostedMcpTool, run, OpenAIConversationsSession } from '@openai/agents';
import * as readline from 'readline';

const composioApiKey = process.env.COMPOSIO_API_KEY;
const userId = process.env.USER_ID;

if (!composioApiKey) {
  throw new Error('COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key');
}
if (!userId) {
  throw new Error('USER_ID is not set');
}

// Initialize Composio
const composio = new Composio({
  apiKey: composioApiKey,
  provider: new OpenAIAgentsProvider(),
});

async function main() {
  // Create Tool Router session
  const session = await composio.create(userId as string, {
    toolkits: ['raisely'],
  });
  const mcpUrl = session.mcp.url;

  // Configure agent with MCP tool
  const agent = new Agent({
    name: 'Assistant',
    model: 'gpt-5',
    instructions:
      'You are a helpful assistant that can access Raisely. Help users perform Raisely operations through natural language.',
    tools: [
      hostedMcpTool({
        serverLabel: 'tool_router',
        serverUrl: mcpUrl,
        headers: { 'x-api-key': composioApiKey },
        requireApproval: 'never',
      }),
    ],
  });

  // Keep conversation state across turns
  const conversationSession = new OpenAIConversationsSession();

  // Simple CLI
  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: ',
  });

  console.log('\nComposio Tool Router session created.');
  console.log('\nChat started. Type your requests below.');
  console.log("Commands: 'exit', 'quit', or 'q' to end\n");

  try {
    const first = await run(agent, 'What can you help me with?', { session: conversationSession });
    console.log(`Assistant: ${first.finalOutput}\n`);
  } catch (e) {
    console.error('Error:', e instanceof Error ? e.message : e, '\n');
  }

  rl.prompt();

  rl.on('line', async (userInput) => {
    const text = userInput.trim();

    if (['exit', 'quit', 'q'].includes(text.toLowerCase())) {
      console.log('Goodbye!');
      rl.close();
      process.exit(0);
    }

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

    try {
      const result = await run(agent, text, { session: conversationSession });
      console.log(`\nAssistant: ${result.finalOutput}\n`);
    } catch (e) {
      console.error('Error:', e instanceof Error ? e.message : e, '\n');
    }

    rl.prompt();
  });

  rl.on('close', () => {
    console.log('\nSession ended.');
    process.exit(0);
  });
}

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

## Conclusion

This was a starter code for integrating Raisely MCP with OpenAI Agents SDK to build a functional AI agent that can interact with Raisely.
Key features:
- Hosted MCP tool integration through Composio's Tool Router
- SQLite session persistence for conversation history
- Simple async chat loop for interactive testing
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

- [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 OpenAI Agents SDK?

Yes, you can. OpenAI Agents 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)