How to Use the IPRoyal (Proxy Services) MCP in Google ADK

Q: How do I add the IPRoyal (Proxy Services) MCP Server to Google ADK?

Install the library with pip install google-adk and define your McpToolset with the HTTP URL from Vinkius. Pass the toolset object in the tools list when initializing your LlmAgent. The Gemini model will automatically detect and call the proxy management tools.

Q: Can I restrict which proxy tools are exposed to Google ADK from IPRoyal (Proxy Services)?

Yes, you can use the toolnames filter in the ADK toolset configuration to expose only specific tools. For example, you can limit the agent to gettraffic and listorders while blocking credential modification tools. This minimizes the risk of unauthorized configuration changes.

Q: How does Google ADK handle proxy rotation using IPRoyal (Proxy Services)?

The agent can monitor bandwidth usage with gettraffic and trigger a rotation when a threshold is met. It calls changecredentials to update the proxy password and then generates a new connection string. This automation keeps your scraping pipelines active without manual intervention.

Q: Does the agent need raw credentials to generate proxy strings?

No, the agent uses generateproxystring which handles formatting on the server side. This prevents raw passwords from appearing in your agent's reasoning logs or system prompts. It keeps your proxy environment secure while maintaining full flexibility.

Feed live proxy data into Gemini enterprise agents using Google ADK to scale scraping tasks directly from BigQuery.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IPRoyal (Proxy Services) MCP to Google ADK

Create your Vinkius account to connect IPRoyal (Proxy Services) 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 IPRoyal (Proxy Services) with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Enterprise Proxy Management via Google ADK

The `google-adk` connects your Gemini models to the IPRoyal MCP Server using the `McpToolset` class. This allows enterprise agents to query proxy availability across different regions directly before launching massive data ingestion pipelines. Your agent can run `get_availability` and immediately structure the results for downstream BigQuery ingestion. You can configure the transport layer to use Stdio or HTTP depending on your Google Cloud architecture. By passing the toolset to `LlmAgent`, your model gains the ability to check account balances with `get_profile` before starting expensive scraping runs.

Dynamic IP Whitelisting for Vertex Pipelines

Automate pipeline access by allowing Gemini to manage scraper IPs dynamically. Your agent runs `add_whitelist_ip` to authorize Google Cloud run instances on the fly, eliminating hardcoded credentials. It tracks active authorisations via `list_whitelisted_ips` to maintain a clean security posture. When a Vertex AI pipeline job completes, the agent calls `remove_whitelist_ip` to revoke access. This process ensures that temporary compute instances do not leave open access vectors to your residential proxy pool.

High-Volume Geo-Targeting with Gemini Long-Context

Gemini's 1M+ token context window allows it to process massive country lists returned by `list_countries` in a single pass. The agent identifies the best target nodes and uses `generate_proxy_string` to build precise connection strings. It can manage thousands of concurrent scraping sessions without losing track of regional configurations. If a session encounters high latency, the agent calls `list_orders` to find alternative proxy packages. It then swaps the credentials using `change_credentials` to keep the data pipeline running smoothly.

Setup guide

Set up IPRoyal (Proxy Services) 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 IPRoyal (Proxy Services) 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="IPRoyal (Proxy Services)_agent",
    model="gemini-2.0-flash",
    instruction="You have access to IPRoyal (Proxy Services) 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 IPRoyal. 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 IPRoyal (Proxy Services) 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 IPRoyal (Proxy Services) MCP in Google ADK

Install the library with `pip install google-adk` and define your `McpToolset` with the HTTP URL from Vinkius. Pass the toolset object in the `tools` list when initializing your `LlmAgent`. The Gemini model will automatically detect and call the proxy management tools.

Yes, you can use the `tool_names` filter in the ADK toolset configuration to expose only specific tools. For example, you can limit the agent to `get_traffic` and `list_orders` while blocking credential modification tools. This minimizes the risk of unauthorized configuration changes.

The agent can monitor bandwidth usage with `get_traffic` and trigger a rotation when a threshold is met. It calls `change_credentials` to update the proxy password and then generates a new connection string. This automation keeps your scraping pipelines active without manual intervention.

No, the agent uses `generate_proxy_string` which handles formatting on the server side. This prevents raw passwords from appearing in your agent's reasoning logs or system prompts. It keeps your proxy environment secure while maintaining full flexibility.

All proxy credentials and IP whitelists are stored securely within the MCP environment and never exposed to the LLM context. The Google ADK client only receives the final connection strings or status confirmations. This architecture prevents prompt injection attacks from leaking your proxy access keys.

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