Skip to main content
Build a Google ADK agent that can search tweets, hand off IDs and cursors, post tweets, replay stored monitor events, and run extraction jobs - powered by Xquik’s MCP server and Gemini.

Prerequisites

  • Python 3.10+
  • Xquik API key (xq_...)
  • A Google AI API key (for Gemini models)

Install

Full Example

The MCP runtime returns normalized snake_case fields through xquik.request(), so keep ADK prompts aligned with tweet_id, has_more, next_cursor, and returned job IDs.

Handoff Checklist

Tweet search rows

Store tweet_id, text, author_username, created_at, has_more, next_cursor, and the original q.

User profile rows

Store source id as user_id, plus username, name, followers, verified, profile_picture, has_more, next_cursor, and the source lookup or search query.

Trend rows

Store each trend name, rank, query, and description. Keep response count, woeid, and the requested region with the run checkpoint.

Monitor and webhook setup

Store the returned monitor id as monitor_id, event_types, next_billing_at, the returned webhook id as webhook_id, url, and the one-time secret in a secret manager. On production deliveries, store delivery_id for receiver retry de-dupe and stream_event_id when one monitor event should process once across endpoint changes.

Stored event replay

Store event_id, type, monitor_id, monitor_type, occurred_at, has_more, next_cursor, and the after query for the next page.

Extraction jobs

Store extraction_id, status, poll, and export_after_complete; poll before loading CSV, JSON, or XLSX rows.

Writes

Store tweet_id or write_action_id, reply_to_tweet_id, status, charged_credits, and poll; do not resend pending writes.

Media attachments

For tweets or replies, pass public URLs in media and store tweet_id or write_action_id. For DMs, upload first, pass one media_id in media_ids, store message_id, and leave reply_to_message_id unset.

Multi-Agent Setup

ADK supports hierarchical agents. Use a root agent that delegates to specialized sub-agents:

Dynamic Headers

Use header_provider for per-request headers (e.g., multi-tenant apps with per-user API keys):

Discovery-Only Tool Filtering

Expose endpoint discovery without allowing API execution:
This configuration exposes only explore. It can inspect endpoint schemas but cannot run API operations. The xquik meta-tool executes API operations. MCP tool-name filtering cannot make it read-only.

Environment Variables

.env
Use McpToolset (lowercase ā€˜c’), not MCPToolset. The uppercase version is deprecated and emits a warning.

Verified Package Versions

Last modified on July 16, 2026