Factorial MCP Server for Google ADKGive Google ADK instant access to 8 tools to Get Employee Details, List Attendance Shifts, List Company Teams, and more
Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add Factorial as an MCP tool provider through Vinkius and your ADK agents can call every tool with full schema introspection.
Ask AI about this App Connector for Google ADK
The Factorial app connector for Google ADK is a standout in the Industry Titans category — giving your AI agent 8 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
StreamableHTTPConnectionParams,
)
# Your Vinkius token. get it at cloud.vinkius.com
mcp_tools = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
)
)
agent = Agent(
model="gemini-2.5-pro",
name="factorial_alternative_agent",
instruction=(
"You help users interact with Factorial "
"using 8 available tools."
),
tools=[mcp_tools],
)
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Factorial MCP Server
Connect your Factorial HR organizational account to any AI agent and take full control of your human resource management workflows through natural conversation.
Google ADK natively supports Factorial as an MCP tool provider. declare Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 8 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.
What you can do
- Employee Directory — List all active employees and fetch detailed profile information directly from the Factorial cloud
- Time Off & Leaves — Query all recorded leave requests (both pending and approved) to monitor staff availability
- Attendance Tracking — Inspect chronological shift records and clock-in/out data to understand team working patterns
- Document Management — List and navigate company HR documents and folder structures programmatically
- Team Hierarchy — Retrieve the organizational structure, teams, and departments defined in your company
The Factorial MCP Server exposes 8 tools through the Vinkius. Connect it to Google ADK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 8 Factorial tools available for Google ADK
When Google ADK connects to Factorial through Vinkius, your AI agent gets direct access to every tool listed below — spanning employee-directory, time-off-management, payroll-processing, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.
Essential for reviewing detailed profile information and roles. Get details for a specific employee
Essential for tracking employee working hours and productivity patterns. List all attendance shifts
Useful for understanding the organizational hierarchy. List all organizational teams
Use this to navigate the document library. List HR document folders
Essential for auditing and compliance reviews. List all employment contracts
Includes full names, email addresses, and basic profile metadata. Use this to identify staff IDs and contact information. List all active employees
Includes document metadata and identification IDs. List all company HR documents
Useful for monitoring attendance and staff availability. List employee leave requests
Connect Factorial to Google ADK via MCP
Follow these steps to wire Factorial into Google ADK. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.
Install Google ADK
pip install google-adkReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenCreate the agent
Explore tools
Why Use Google ADK with the Factorial MCP Server
Google ADK provides unique advantages when paired with Factorial through the Model Context Protocol.
Google ADK natively supports MCP tool servers. declare a tool provider and the framework handles discovery, validation, and execution
Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with Factorial
Production-ready features like session management, evaluation, and deployment come built-in. not bolted on
Seamless integration with Google Cloud services means you can combine Factorial tools with BigQuery, Vertex AI, and Cloud Functions
Factorial + Google ADK Use Cases
Practical scenarios where Google ADK combined with the Factorial MCP Server delivers measurable value.
Enterprise data agents: ADK agents query Factorial and cross-reference results with internal databases for comprehensive analysis
Multi-modal workflows: combine Factorial tool responses with Gemini's vision and language capabilities in a single agent
Automated compliance checks: schedule ADK agents to query Factorial regularly and flag policy violations or configuration drift
Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including Factorial
Example Prompts for Factorial in Google ADK
Ready-to-use prompts you can give your Google ADK agent to start working with Factorial immediately.
"List all active employees in Factorial."
"Show me recent leave requests."
"List all employee contracts."
Troubleshooting Factorial MCP Server with Google ADK
Common issues when connecting Factorial to Google ADK through the Vinkius, and how to resolve them.
McpToolset not found
pip install --upgrade google-adkFactorial + Google ADK FAQ
Common questions about integrating Factorial MCP Server with Google ADK.