How to Use the ReliefWeb MCP in Google ADK

Q: How does Google ADK handle large payloads from ReliefWeb search queries?

Google ADK processes the JSON output from getreports and loads it directly into Gemini's context window. The framework handles the data stream efficiently, ensuring no truncation occurs during large transfers.

Q: Can I limit which ReliefWeb MCP tools are exposed to my Google ADK agent?

Yes, you can use the toolnames filter in the McpToolset configuration. This lets you expose only specific tools like getdisasters while hiding job or organization tools.

Q: How do I combine ReliefWeb data with my existing Google Cloud databases using Google ADK?

Your Google ADK agent can call getcountries to fetch ISO codes, then write that data directly to BigQuery. This allows you to join real-time humanitarian updates with your own internal tracking tables.

Q: How do I retrieve specific thematic reports using this setup?

The agent queries getthemes to obtain the correct category ID for topics like food security. It then passes that ID to getreports to return targeted humanitarian updates.

Q: Is the disaster and organizational data from this server secure inside Google Cloud?

Yes, all data retrieved via getdisasters and getorganizations is processed through Vinkius's zero-trust sandbox. The Google ADK client communicates over a single secure endpoint, keeping your cloud infrastructure isolated.

Connect Gemini's million-token context to live humanitarian feeds using Google ADK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ReliefWeb MCP to Google ADK

Create your Vinkius account to connect ReliefWeb to Google ADK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup ReliefWeb with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Feed massive crisis logs directly into Gemini

Your Google ADK agent calls `get_reports` to pull months of humanitarian data and dumps it straight into Gemini's long-context window. Since the model handles a million tokens easily, you don't have to waste time chunking files or writing complex map-reduce code. The agent filters these large datasets using `get_formats` to focus solely on maps or situation reports. This lets you build deep historical timelines of active emergencies directly inside Vertex AI.

Query this MCP Server alongside BigQuery tables

The Google ADK framework lets you cross-reference active field data from `get_disasters` on this MCP server with your internal logistics tables in BigQuery. Your agent queries the live disaster status and maps it to your physical inventory lists in real time. It then uses `get_countries` to verify geographic coordinates before updating your enterprise database. This keeps your supply chain data accurate during fast-moving global events.

Map global aid organization networks

Your agent invokes `get_organizations` to map which NGOs are active in specific crisis zones. Google ADK routes this structured JSON payload directly into your Vertex AI pipelines for relationship mapping. By using `get_sources`, the agent verifies the credibility of each incoming report. You get a clean, mapped network of trusted humanitarian actors without manual data entry.

Setup guide

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

Google ADK processes the JSON output from `get_reports` and loads it directly into Gemini's context window. The framework handles the data stream efficiently, ensuring no truncation occurs during large transfers.

Yes, you can use the tool_names filter in the McpToolset configuration. This lets you expose only specific tools like `get_disasters` while hiding job or organization tools.

Your Google ADK agent can call `get_countries` to fetch ISO codes, then write that data directly to BigQuery. This allows you to join real-time humanitarian updates with your own internal tracking tables.

The agent queries `get_themes` to obtain the correct category ID for topics like food security. It then passes that ID to `get_reports` to return targeted humanitarian updates.

Yes, all data retrieved via `get_disasters` and `get_organizations` is processed through Vinkius's zero-trust sandbox. The Google ADK client communicates over a single secure endpoint, keeping your cloud infrastructure isolated.

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