How to Use the HashiCorp Nomad MCP in Google ADK

Q: How do I connect Google ADK to my HashiCorp Nomad cluster?

Configure the McpToolset with your Nomad agent's URL. The server then registers all 10 tools, making your cluster state available as native functions for your agent.

Q: Can I restrict which HashiCorp Nomad tools Google ADK uses?

Use the toolnames filter during initialization to limit the agent to specific operations like listjobs or getnode. This controls exactly what your agent can modify in the cluster.

Q: How are HashiCorp Nomad deployment failures handled in Google ADK?

Your agent can call faildeployment if it detects that a rollout is exceeding error thresholds. This allows you to programmatically abort bad deployments before they impact your users.

Manage your infrastructure with Google ADK by connecting your Gemini-powered agents to HashiCorp Nomad.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HashiCorp Nomad MCP to Google ADK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Direct job management in Google ADK

Query your entire workload history using `list_jobs` to feed context into your Gemini agent. It allows your code to reason about deployment patterns across the cluster. Use `get_job` to pull specific configurations when your agent needs to compare live settings against your source of truth. This reduces the time spent manually checking job definitions.

Real-time node diagnostics for Google ADK

Expose `list_nodes` to your agent to map out resource availability across your data center. Your agent identifies underutilized nodes and reports them back to your monitoring dashboard. Fetching `get_node` details gives your agent the granular data needed to debug scheduling failures. You gain insight into why specific tasks fail to place on certain hardware.

Allocation visibility with Google ADK

Track task placement by calling `list_allocations` to see exactly where your services are running. Your agent filters this list to highlight unhealthy allocations that require immediate attention. Retrieving `get_allocation` data provides the necessary logs and state transitions for your agent to diagnose silent failures. It turns complex cluster state into actionable information.

Setup guide

Set up HashiCorp Nomad 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 HashiCorp Nomad 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="HashiCorp Nomad_agent",
    model="gemini-2.0-flash",
    instruction="You have access to HashiCorp Nomad 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 Nomad. 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 HashiCorp Nomad 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 HashiCorp Nomad MCP in Google ADK

Configure the `McpToolset` with your Nomad agent's URL. The server then registers all 10 tools, making your cluster state available as native functions for your agent.

Use the tool_names filter during initialization to limit the agent to specific operations like `list_jobs` or `get_node`. This controls exactly what your agent can modify in the cluster.

Yes, as long as the server has network access to your Nomad agent endpoint. Ensure your environment variables are set correctly so the server can communicate with your private cluster.

Your agent can call `fail_deployment` if it detects that a rollout is exceeding error thresholds. This allows you to programmatically abort bad deployments before they impact your users.

The server provides metadata and status about your jobs and allocations, but it does not transmit raw log file content. Your data stays internal to your infrastructure, ensuring only status indicators are processed by the agent.

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