How to Use the Humaans MCP in Google ADK

Q: How do I restrict Humaans tool access in Google ADK?

Use the toolnames parameter in the McpToolset configuration. This prevents the agent from seeing or executing tools you don't want it to access.

Integrate Humaans with Google ADK for enterprise agents that reason over your HRIS data using Gemini's long-context capabilities.

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 Google ADK

Create your Vinkius account to connect Humaans to Google ADK 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 Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Connect Humaans to your Google ADK infrastructure

Bridge your HR data into your Google Cloud agent workflows seamlessly. The setup allows your agents to query `list_roles` or `list_teams` alongside your BigQuery datasets. By adding the server as a toolset, you let Gemini reason about your organizational structure. It's built for enterprise-scale data access.

Query Humaans data with Gemini's long-context power

Feed massive employee datasets into the context window for complex analysis. Your agent can process `list_employees` and `list_offices` results to map your global footprint. This approach lets you ask the agent questions about your organization that span thousands of records. It handles the volume without breaking a sweat.

Filter tools for your Google ADK agent

Control exactly which capabilities your agent can perform by using the tool_names filter. You can expose `get_me` while hiding sensitive documents. This granular control keeps your agent focused on its specific task. It ensures the Humaans server only provides the data you explicitly want to use.

Setup guide

Set up Humaans MCP in Google ADK

Prerequisites

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

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Humaans tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Humaans_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Humaans tools via MCP.",
    tools=mcp_tools,
)

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 Google ADK

It uses a dedicated toolset class that communicates with the server endpoint. You define the server parameters, and the framework handles the rest of the connection.

Yes, your agent can call Humaans tools to get HR context and join that with your BigQuery data. The agent orchestrates both sources within a single workflow.

The framework supports both transports. You can choose the one that matches your deployment architecture for the best performance.

Use the tool_names parameter in the McpToolset configuration. This prevents the agent from seeing or executing tools you don't want it to access.

All employee contact info is transmitted via one-time tokens in a sandboxed environment. We don't log or cache these records, keeping your HRIS data strictly ephemeral.

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