Google ADK + Civic MCP Hub — Reference Implementations

Connect Google Agent Development Kit (ADK) agents to Civic's MCP Hub for access to 85+ MCP servers with built-in guardrails, audit trails, and instant revocation.

Implementations

Language	LLM	API Key Required
Python	Claude	ANTHROPIC_API_KEY
TypeScript	Gemini	GOOGLE_GENAI_API_KEY
Go	Gemini	GOOGLE_API_KEY

All implementations connect to Civic via MCP Streamable HTTP transport.

Architecture

User Message
    |
    v
  Runner  -->  LlmAgent  -->  LLM (Claude / Gemini)
    |              |
    |              v
    |         MCPToolset  --(StreamableHTTP)-->  Civic MCP Hub
    |              |                                  |
    v              v                                  v
  Session     Tool Discovery              Guardrails / Audit / Revocation
              + Invocation

Core components:

Component	Purpose
LlmAgent	Wraps an LLM with instructions and tools
MCPToolset	Connects to Civic's MCP Hub, discovers and invokes tools
Runner	Orchestrates agent execution and streams response events
SessionService	Manages conversation state (in-memory for these demos)

Quick Start

Python

cd python
cp .env.example .env   # fill in CIVIC_TOKEN, ANTHROPIC_API_KEY
uv run adk web         # opens ADK console at http://localhost:8000

See python/README.md for the FastAPI chat server option.

TypeScript

cd typescript
npm install
cp .env.example .env   # fill in CIVIC_TOKEN, GOOGLE_GENAI_API_KEY
npm start

See typescript/README.md for details.

Go

cd go
cp .env.example .env   # fill in CIVIC_TOKEN, GOOGLE_API_KEY
go run main.go

See go/README.md for details.

Civic MCP Hub

All tool calls route through Civic's MCP Hub. You get guardrails, audit logs, and kill-switch revocation without changing agent code.

Set profile= in your CIVIC_URL to select which toolkit your agent connects to:

CIVIC_URL=https://app.civic.com/hub/mcp?profile=your-skill

Learn More

• Civic docs
• Google ADK integration recipe
• Google ADK docs