## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.SIGN UP
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.LOG IN
Connect CrewAI to Humanitix MCP. List all upcoming events this month, get details for event by id, and more using natural language, with authentication handled for you.
Humanitix is a not-for-profit ticketing platform that donates 100% of profits to charity. It empowers event organizers to make social impact with every ticket sold.
This guide walks you through connecting Humanitix to CrewAI using the Composio tool router. By the end, you'll have a working Humanitix agent that can list your events, fetch event details, and browse event tags through natural language commands.
This guide will help you understand how to give your CrewAI agent real control over a Humanitix account through Composio's Humanitix MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.
CrewAI is a powerful framework for building multi-agent AI systems. It provides primitives for defining agents with specific roles, creating tasks, and orchestrating workflows through crews.
Key features include:
The Humanitix MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Humanitix account. It provides structured and secure access to your event data, so your agent can retrieve event details, list your events, and manage tags—all without manual lookups or jumping between dashboards.
Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK
The tool router generates a secure MCP URL that your agents can access to perform actions.
The Composio SDK follows a three-phase workflow:
pip install composio crewai crewai-tools[mcp] python-dotenvcomposio connects your agent to Humanitix via MCPcrewai provides Agent, Task, Crew, and LLM primitivescrewai-tools[mcp] includes MCP helperspython-dotenv loads environment variables from .envCOMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_hereCreate a .env file in your project root.
What's happening:
COMPOSIO_API_KEY authenticates with ComposioUSER_ID scopes the session to your accountOPENAI_API_KEY lets CrewAI use your chosen OpenAI modelimport os
from composio import Composio
from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
import dotenv
dotenv.load_dotenv()
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")
if not COMPOSIO_API_KEY:
raise ValueError("COMPOSIO_API_KEY is not set")
if not COMPOSIO_USER_ID:
raise ValueError("COMPOSIO_USER_ID is not set")MCPServerHTTP connects the agent to an MCP endpointComposio will give you a short lived Humanitix MCP URLcomposio_client = Composio(api_key=COMPOSIO_API_KEY)
session = composio_client.create(user_id=COMPOSIO_USER_ID, toolkits=["humanitix"])
url = session.mcp.urlserver_params = {
"url": url,
"transport": "streamable-http",
"headers": {"x-api-key": COMPOSIO_API_KEY},
}
with MCPServerAdapter(server_params) as tools:
agent = Agent(
role="Search Assistant",
goal="Help users search the internet effectively",
backstory="You are a helpful assistant with access to search tools.",
tools=tools,
verbose=False,
max_iter=10,
)MCPServerAdapter acts as a context manager that converts Composio MCP tools into a CrewAI-compatible format.print("Chat started! Type 'exit' or 'quit' to end.\n")
conversation_context = ""
while True:
user_input = input("You: ").strip()
if user_input.lower() in ["exit", "quit", "bye"]:
print("\nGoodbye!")
break
if not user_input:
continue
conversation_context += f"\nUser: {user_input}\n"
print("\nAgent is thinking...\n")
task = Task(
description=(
f"Conversation history:\n{conversation_context}\n\n"
f"Current request: {user_input}"
),
expected_output="A helpful response addressing the user's request",
agent=agent,
)
crew = Crew(agents=[agent], tasks=[task], verbose=False)
result = crew.kickoff()
response = str(result)
conversation_context += f"Agent: {response}\n"
print(f"Agent: {response}\n")Here's the complete code to get you started with Humanitix and CrewAI:
from crewai import Agent, Task, Crew, LLM
from crewai_tools import MCPServerAdapter
from composio import Composio
from dotenv import load_dotenv
import os
load_dotenv()
GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")
if not GOOGLE_API_KEY:
raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
raise ValueError("COMPOSIO_USER_ID is not set in the environment.")
# Initialize Composio and create a session
composio = Composio(api_key=COMPOSIO_API_KEY)
session = composio.create(
user_id=COMPOSIO_USER_ID,
toolkits=["humanitix"],
)
url = session.mcp.url
# Configure LLM
llm = LLM(
model="gpt-5",
api_key=os.getenv("OPENAI_API_KEY"),
)
server_params = {
"url": url,
"transport": "streamable-http",
"headers": {"x-api-key": COMPOSIO_API_KEY},
}
with MCPServerAdapter(server_params) as tools:
agent = Agent(
role="Search Assistant",
goal="Help users with internet searches",
backstory="You are an expert assistant with access to Composio Search tools.",
tools=tools,
llm=llm,
verbose=False,
max_iter=10,
)
print("Chat started! Type 'exit' or 'quit' to end.\n")
conversation_context = ""
while True:
user_input = input("You: ").strip()
if user_input.lower() in ["exit", "quit", "bye"]:
print("\nGoodbye!")
break
if not user_input:
continue
conversation_context += f"\nUser: {user_input}\n"
print("\nAgent is thinking...\n")
task = Task(
description=(
f"Conversation history:\n{conversation_context}\n\n"
f"Current request: {user_input}"
),
expected_output="A helpful response addressing the user's request",
agent=agent,
)
crew = Crew(agents=[agent], tasks=[task], verbose=False)
result = crew.kickoff()
response = str(result)
conversation_context += f"Agent: {response}\n"
print(f"Agent: {response}\n")You now have a CrewAI agent connected to Humanitix through Composio's Tool Router. The agent can perform Humanitix operations through natural language commands.
Next steps:
Every Humanitix action and event your agent gets out of the box.
Use Humanitix MCP with Claude Code
Use Humanitix MCP with Claude Cowork
Use Humanitix MCP with OpenAI Agents SDK
Use Humanitix MCP with Claude Agent SDK
Use Humanitix MCP with Grok Bot
Use Humanitix MCP with Codex
Use Humanitix MCP with OpenClaw
Use Humanitix MCP with Hermes
Use Humanitix MCP with Atomic Agent
Use Humanitix MCP with Google ADK
Use Humanitix MCP with LangChain
Use Humanitix MCP with Vercel AI SDK
Use Humanitix MCP with Mastra AI
Use Humanitix MCP with LlamaIndex
Use Humanitix MCP with Pydantic AI
Use Humanitix MCP with AutoGen
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.
Apaleo is a cloud-based property management platform for hospitality businesses. It centralizes reservations, billing, and daily operations for smoother hotel management.
Appointo is an appointment booking platform for Shopify stores. It lets businesses add online scheduling to their websites with zero coding.
Bart is the Bay Area Rapid Transit system, providing fast public transportation across the San Francisco Bay Area. It helps commuters and travelers get real-time schedule info, plan routes, and stay updated on service changes.
Managed auth, hosted MCP servers, and every Humanitix tool your agent needs.Free to start.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.Start building