How to Use GitHub MCP Server with Google ADK using Vinkius

Give Google ADK instant access to 12 tools to Create New Issue, Get File Contents, Get My Github Profile, and more using Vinkius.

GDPR Free for Subscribers

Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add GitHub as an MCP tool provider through Vinkius and your ADK agents can call every tool with full schema introspection.

Ask AI about this MCP Server for Google ADK

ChatGPT Claude Perplexity

The GitHub MCP Server for Google ADK is a standout in the Industry Titans category, giving your AI agent 12 tools to work with, ready to go from day one.

Vinkius delivers Streamable HTTP and SSE to any MCP client

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

python

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
    StreamableHTTPConnectionParams,
)

# Your Vinkius token. get it at cloud.vinkius.com
mcp_tools = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    )
)

agent = Agent(
    model="gemini-2.5-pro",
    name="github_agent",
    instruction=(
        "You help users interact with GitHub "
        "using 12 available tools."
    ),
    tools=[mcp_tools],
)

Fully ManagedNo server setup

Plug & PlayNo coding needed

SecurePrivacy protected

PrivateYour data is safe

Cost ControlBudget limits

Control1-click disconnect

Auto-UpdatesMaintenance free

High SpeedOptimized for AI

Reliable99.9% uptime

Your credentials and connection tokens are fully encrypted

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure

About GitHub MCP Server

Connect your GitHub account to any AI agent to automate your software development lifecycle and code management through the Model Context Protocol (MCP). GitHub is the world's leading AI-powered developer platform. This MCP server enables you to retrieve repository metadata, manage issues, track pull requests, and search for code directly through natural conversation.

Google ADK treats GitHub as a first-class tool provider in the Gemini ecosystem. Declare a single URL and the framework handles discovery, schema validation, and execution lifecycle automatically. What makes this combination distinct is Gemini's long-context reasoning: the model can hold 12 tool schemas, previous call results, and your instructions in a single context window, enabling multi-step analytical workflows that would overwhelm smaller models. Production session management and evaluation come built in.

Key Features

Repository Oversight. List all repositories for any user or organization, and fetch detailed configuration metadata for specific projects.
Issue & PR Management. List issues and pull requests, track their lifecycle status, and programmatically open new issues from your chat interface.
Code Content Discovery. Retrieve the contents of files or directories within any repository to understand codebase structures.
Advanced Code Search. Execute powerful searches across GitHub's massive database to isolate specific code snippets or repositories.
Collaboration Tracking. Monitor forks and contributors to understand project community engagement.
Identity Oversight. Access detailed profile information for the authenticated GitHub user to verify permissions and account context.
Real-time Synchronization. Keep your source control and development data accessible to your AI assistant without leaving your primary workspace.

The GitHub MCP Server exposes 12 tools through Vinkius. Connect it to Google ADK in under two minutes. Fully managed, no infrastructure to provision, no vendor lock-in.

12 tools included

Explore every tool GitHub exposes to Google ADK through Vinkius.

View all 12 tools

Connect GitHub to Google ADK via MCP

Follow these steps to connect GitHub to Google ADK. The setup takes under two minutes and requires no coding or server hosting.

Get your Vinkius Access Token

Go to cloud.vinkius.com to log in or create a free account, and retrieve your personal access token from the dashboard. This token is required to authenticate your connection to the hosted GitHub MCP server.

Install Google ADK

Run pip install google-adk

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Create the agent

Save the code above and integrate into your ADK workflow

Explore tools

The agent will discover 12 tools from GitHub via MCP

Why Use Google ADK with the GitHub MCP Server

Google ADK provides unique advantages when paired with GitHub through the Model Context Protocol.

Gemini's long-context window holds all 12 tool schemas from GitHub, previous responses, and intermediate reasoning in a single pass. Complex multi-tool queries resolve without context loss

ADK manages the full lifecycle of GitHub connections through Vinkius: discovery, schema validation, execution, session persistence, and evaluation. Production infrastructure, not prototyping tools

Built-in evaluation framework lets you benchmark GitHub tool call accuracy, latency, and cost through Vinkius before deploying to production

Google Cloud integration connects GitHub data from Vinkius to BigQuery, Vertex AI, and Cloud Functions. Enterprise infrastructure for enterprise operations

GitHub + Google ADK Use Cases

Practical scenarios where Google ADK combined with the GitHub MCP Server delivers measurable value.

Enterprise data agents: ADK agents query GitHub and cross-reference results with internal databases for comprehensive analysis

Multi-modal workflows: combine GitHub tool responses with Gemini's vision and language capabilities in a single agent

Automated compliance checks: schedule ADK agents to query GitHub regularly and flag policy violations or configuration drift

Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including GitHub

Example Prompts for GitHub in Google ADK

Ready-to-use prompts you can give your Google ADK agent to start working with GitHub immediately.

"List the last 5 open issues in the 'facebook/react' repository."

"Find all repositories for the organization 'vinkius'."

"Read the content of the 'README.md' file in 'vinkius/vurb-docs'."

Troubleshooting GitHub MCP Server with Google ADK

Common issues when connecting GitHub to Google ADK through Vinkius, and how to resolve them.

McpToolset not found

Update: pip install --upgrade google-adk

GitHub + Google ADK FAQ

Common questions about integrating GitHub MCP Server with Google ADK.

How does Google ADK connect to MCP servers?

Import the MCP toolset class and pass the server URL. ADK discovers and registers all tools automatically, making them available to your agent's tool-use loop.

Can ADK agents use multiple MCP servers?

Yes. Declare multiple MCP tool providers in your agent configuration. ADK merges all tool schemas and the agent can call tools from any server in a single turn.

Which Gemini models work best with MCP tools?

Gemini 2.0 Flash and Pro models both support function calling required for MCP tools. Flash is recommended for latency-sensitive use cases, Pro for complex reasoning.

01 / Catalog

Over 4,000 integrations ready for AI agents

Explore a vast library of pre-built integrations, optimized and ready to deploy.

02 / Credentials

Connect securely in under 30 seconds

Generate tokens to authenticate and link external services in a single step.

03 / Guardian

Complete visibility into every agent action

Audit live requests, latency, success rates, and active security compliance policies.

04 / FinOps

Optimize spending and track token ROI

Analyze real-time token consumption and cost metrics detailed by connection.

Over 4,000 integrations ready for AI agents

Complete visibility into every agent action

Explore our live AI Agents Analytics dashboard to see it all working

This dashboard is included when you connect GitHub using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.

Explore Analytics