How to Use the Evolio MCP in CrewAI

Q: How do I give a CrewAI agent access to Evolio?

Pass the server URL directly into the mcps array when defining your agent. The framework handles the tool discovery and binding automatically.

Q: Can I restrict which Evolio tools a specific CrewAI agent uses?

Use MCPServerHTTP from crewai.mcp and apply a toolfilter. You can give the admin agent createcase while restricting the researcher to getcase and listcasefiles.

Q: Does the MCP server support hierarchical execution?

Yes. A manager agent can evaluate the output of listtasksbycase and delegate follow-up actions to worker agents based on the specific task status.

Q: What happens to coaching session notes processed by CrewAI?

Private session files fetched via listclientfiles are processed entirely in memory within the secure sandbox. The ephemeral instance terminates after the crew finishes its run, preventing unauthorized data persistence.

Deploy autonomous agent teams to manage your coaching administration and client tracking with CrewAI and the Evolio MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Evolio MCP to CrewAI

Create your Vinkius account to connect Evolio to CrewAI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Evolio with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Agent Client Tracking

The `list_clients` and `get_client` tools allow your researcher agent to pull detailed profiles before a coaching session. It hands that context off to an analyst agent that reviews historical data. You build specialized teams instead of one massive prompt. The analyst reads through `list_case_files` and outputs a prep brief, while a separate administrative agent stands by to log the session.

Delegated Evolio MCP Server Actions

When a session concludes, your moderator agent triggers `update_case` and fires off multiple `create_task` commands based on the transcript. It operates entirely in the background. The crew shares memory. If the admin agent creates a task, the notification agent already knows the task ID and can immediately query `get_task` to verify the assignment details.

Sequential Case Audits

Schedule a nightly crew execution that runs `list_cases_by_status` to find stalled coaching clients. The system pulls the data and flags dormant accounts automatically. Before the heavy lifting starts, a diagnostic agent runs `check_evolio_status`. You get autonomous operations that audit your entire coaching practice without manual intervention.

Setup guide

Set up Evolio MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Evolio tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Evolio Analyst",
    goal="Access and analyze Evolio data via MCP.",
    backstory="Expert analyst with direct Evolio access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Evolio transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Evolio Analyst",
        goal="Access and analyze Evolio data via MCP.",
        backstory="Expert analyst with direct Evolio access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Evolio transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Evolio. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Evolio now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Evolio MCP in CrewAI

Pass the server URL directly into the `mcps` array when defining your agent. The framework handles the tool discovery and binding automatically.

Use `MCPServerHTTP` from `crewai.mcp` and apply a `tool_filter`. You can give the admin agent `create_case` while restricting the researcher to `get_case` and `list_case_files`.

CrewAI maintains shared memory across the execution. When Agent A calls `get_client`, Agent B can reference that client's details in the next sequential step.

Yes. A manager agent can evaluate the output of `list_tasks_by_case` and delegate follow-up actions to worker agents based on the specific task status.

Private session files fetched via `list_client_files` are processed entirely in memory within the secure sandbox. The ephemeral instance terminates after the crew finishes its run, preventing unauthorized data persistence.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript