How to Use the Humaans MCP in CrewAI

Q: How do I expose Humaans tools to a CrewAI agent?

Add your Vinkius server URL directly to the mcps parameter when defining your CrewAI agent. This automatically registers the Humaans MCP tools without manual function mapping.

Q: Can I limit which Humaans tools a CrewAI agent can use?

Yes, use MCPServerHTTP from the CrewAI MCP module to apply a tool filter. This prevents a specific agent from running administrative tools like listdocuments while allowing access to listemployees.

Q: What happens if an agent needs details on a specific employee?

The agent invokes getemployee with the target ID. The server retrieves the full profile, allowing the crew to make decisions based on the employee's current role and team assignments.

Q: How is Humaans document and employee data secured in CrewAI?

All requests to listdocuments and getemployee pass through encrypted token handshakes. Vinkius runs the connector in zero-trust, ephemeral V8 sandboxes, meaning your HR records and personnel details are never written to disk or exposed to external LLM logging.

Coordinate autonomous HR assistant crews to manage Humaans directory and leave data using CrewAI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Humaans MCP to CrewAI

Create your Vinkius account to connect Humaans 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 Humaans with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Agent Staff Onboarding Crews

The `list_employees`, `list_roles`, and `list_offices` tools let your CrewAI agents coordinate complex onboarding checklists using Humaans data. A researcher agent drafts the welcome plan, while an operations agent matches the new hire's role to the correct Humaans office location. By passing your Vinkius URL directly to the `mcps` array in your CrewAI agent definition, the entire crew gains access to Humaans. Shared context allows the operations agent to use the exact Humaans department schema pulled by the researcher.

Autonomous Holiday and Leave Tracking via CrewAI

The `list_leaves` and `list_public_holidays` tools allow specialized CrewAI agents to handle scheduling conflicts using Humaans calendar data. A monitoring agent tracks upcoming time off in Humaans, while a coordination agent flags when holiday overlaps might leave a team understaffed. This MCP Server enables hierarchical execution where a manager agent reviews the Humaans leave logs before passing the final schedule to a writer agent. No developer intervention is needed; the CrewAI agents query the Humaans API and resolve scheduling gaps on their own.

Company Document Compliance Audits

The `list_documents` tool gives your CrewAI compliance crew the ability to verify company policies stored in Humaans. An auditor agent scans Humaans employee document folders to find outdated signatures or missing policy agreements. You can use CrewAI's MCP module to filter tools, ensuring your compliance crew only accesses Humaans documents while leaving employee salary endpoints untouched. This limits the blast radius and keeps your sensitive Humaans organizational data protected during autonomous CrewAI runs.

Setup guide

Set up Humaans 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 Humaans tools as needed.

crew.py

from crewai import Agent, Task, Crew

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

task = Task(
    description="List recent Humaans 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="Humaans Analyst",
        goal="Access and analyze Humaans data via MCP.",
        backstory="Expert analyst with direct Humaans access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Humaans 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 Humaans. 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 Humaans 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 Humaans MCP in CrewAI

Add your Vinkius server URL directly to the `mcps` parameter when defining your CrewAI agent. This automatically registers the Humaans MCP tools without manual function mapping.

Yes, use `MCPServerHTTP` from the CrewAI MCP module to apply a tool filter. This prevents a specific agent from running administrative tools like `list_documents` while allowing access to `list_employees`.

CrewAI agents use shared memory to pass context. When the first agent calls `list_departments`, the resulting org structure is cached and made available to subsequent agents in the crew.

The agent invokes `get_employee` with the target ID. The server retrieves the full profile, allowing the crew to make decisions based on the employee's current role and team assignments.

All requests to `list_documents` and `get_employee` pass through encrypted token handshakes. Vinkius runs the connector in zero-trust, ephemeral V8 sandboxes, meaning your HR records and personnel details are never written to disk or exposed to external LLM logging.

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