Skip to main content

Google ADK Integration

How to integrate Google ADK with Aluvia's MCP server for enhanced AI agent capabilities.

Setup Guide​

1

Get your Aluvia Token

  1. Go to the Aluvia Dashboard
  2. Navigate to the Credentials page
  3. Copy your Aluvia Token (it looks like: 2dceb1aa0***************************)
2

Install required packages

pip install google-adk
3

Configure your MCP server

from google.adk.agents import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset

ALUVIA_TOKEN = "YOUR_ALUVIA_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="aluvia_connectivity_agent",
    instruction="""You help users manage their Aluvia connectivity credentials.
    You can list, create, test, update, and delete credentials,
    and also retrieve usage information when needed.""",
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPServerParams(
                url="https://mcp.aluvia.io",
                headers={
                    "Authorization": f"Bearer {ALUVIA_TOKEN}"
                }
            ),
        )
    ],
)
4

Set up environment variables (optional)

Store your token securely:

import os
ALUVIA_TOKEN = os.getenv("ALUVIA_TOKEN")

Create a .env file:

ALUVIA_TOKEN=your_aluvia_token_here
5

Test it works

  1. Replace YOUR_ALUVIA_TOKEN with your actual Aluvia Token
  2. Run your Google ADK script
  3. You should see the agent accessing connectivity credential tools and returning results