How do I create a GitHub Personal Access Token?

Go to [**Settings > Developer settings > Personal access tokens**](https://github.com/settings/tokens), click **Generate new token (classic)**, give it a descriptive name, select the scopes you need (recommended: repo, workflow, read:org) and click **Generate token**. Copy the token immediately — it starts with `ghp_` and won't be shown again.

Can I create issues with labels via the agent?

Yes! Use the `create_issue` tool with the owner, repo and title parameters. Optionally provide a Markdown body and comma-separated labels (e.g. "bug,high-priority"). The agent will create the issue and return its number, title and URL.

How do I search for repositories with specific criteria?

Use the `search_repos` tool with GitHub's query syntax. Examples: "machine learning in:name language:python stars:>1000" finds Python ML repos with 1k+ stars; "org:microsoft pushed:>2024-01-01" finds Microsoft repos updated in 2024. The query supports qualifiers for language, stars, forks, org, topic, size and more.

Does this tool support GitHub Actions workflow monitoring?

Yes! Use `list_workflow_runs` to see recent CI/CD executions for a repository. You can filter by branch and see each run's status (queued, in_progress, completed) and conclusion (success, failure, cancelled). This is useful for checking if recent deployments or builds passed without opening the Actions tab.

GitHub Alternative MCP Server for Google ADK 14 tools — connect in under 2 minutes

Name: GitHub Alternative
Availability: InStock
Author: Vinkius

google.github.io/adk-docs/tools/mcp-tools

Built by Vinkius GDPR 14 Tools SDK

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

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

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_alternative_agent",
    instruction=(
        "You help users interact with GitHub Alternative "
        "using 14 available tools."
    ),
    tools=[mcp_tools],
)

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About GitHub Alternative MCP Server

Connect your GitHub account to any AI agent and take full control of your development workflows through natural conversation.

Google ADK natively supports GitHub Alternative as an MCP tool provider — declare the Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 14 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.

What you can do

User & Repository Discovery — View your profile and list all repositories with visibility, language and star counts
Issue Management — List, inspect and create issues with labels and Markdown descriptions
Pull Request Tracking — Browse and review pull requests with merge status, draft state and review info
Commit History — Review commit logs across branches with author, message and timestamp
Release Management — List releases and fetch specific release details by git tag
CI/CD Monitoring — Check recent GitHub Actions workflow runs with status and conclusion
Advanced Search — Search repositories using GitHub's powerful query syntax with language, stars and org qualifiers

The GitHub Alternative MCP Server exposes 14 tools through the Vinkius. Connect it to Google ADK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect GitHub Alternative to Google ADK via MCP

Follow these steps to integrate the GitHub Alternative MCP Server with Google ADK.

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 14 tools from GitHub Alternative via MCP

Why Use Google ADK with the GitHub Alternative MCP Server

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

Google ADK natively supports MCP tool servers — declare a tool provider and the framework handles discovery, validation, and execution

Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with GitHub Alternative

Production-ready features like session management, evaluation, and deployment come built-in — not bolted on

Seamless integration with Google Cloud services means you can combine GitHub Alternative tools with BigQuery, Vertex AI, and Cloud Functions

GitHub Alternative + Google ADK Use Cases

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

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

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

Automated compliance checks: schedule ADK agents to query GitHub Alternative 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 Alternative

GitHub Alternative MCP Tools for Google ADK (14)

These 14 tools become available when you connect GitHub Alternative to Google ADK via MCP:

create_issue

Requires the owner, repo and title. Optionally set the issue body (Markdown text) and labels (comma-separated). Returns the created issue with its number, title and URL. Create a new GitHub issue

get_issue

Provide the owner, repo and issue number. Get details for a specific GitHub issue

get_pull_request

Provide the owner, repo and PR number. Get details for a specific GitHub pull request

get_release_by_tag

Returns the release name, tag name, body (Markdown), draft/prerelease status, publish date and attached assets. Provide the owner, repo and tag name. Get a GitHub release by its tag name

get_repo

Provide the owner (org or user) and repo name. Get details for a specific GitHub repository

get_user

Returns login, name, email, avatar URL, company, bio, public repos count, followers and following counts. Use this to verify your token is working correctly. Get the authenticated GitHub user

list_branches

Each branch includes its name, commit SHA and whether it is the default (protected) branch. List branches in a GitHub repository

list_commits

Optionally filter by branch (sha parameter) and set the number of results. Each commit includes the SHA, author, commit message and date. Results are ordered newest first. List commits on a GitHub repository branch

list_issues

Optionally filter by state (open, closed, all). Note: GitHub's issues endpoint includes pull requests — use list_pull_requests for PRs only. Returns issue number, title, state, labels, assignee and creation date. List issues in a GitHub repository

list_pull_requests

Optionally filter by state (open, closed, all). Returns PR number, title, state, author, draft status, creation date and merge status. Use get_pull_request for full details on a specific PR. List pull requests in a GitHub repository

list_releases

Each release includes its tag name, name, draft/prerelease status, author, publish date and asset downloads info. Returns the most recent releases first. List releases for a GitHub repository

list_repos

Optionally filter by type (all, owner, public, private, member) and set the number of results per page. Returns repo name, full_name, description, visibility, language, stars, forks and creation date. List repositories for the authenticated user

list_workflow_runs

Optionally filter by branch and set the number of results. Each run includes its ID, workflow name, event trigger, status (queued, in_progress, completed), conclusion (success, failure), branch and creation date. List GitHub Actions workflow runs for a repository

search_repos

The query supports qualifiers like "language:typescript", "stars:>1000", "org:microsoft", "pushed:>2024-01-01" and free-text search. Results include repo name, description, stars, forks, language and creation date. Search GitHub repositories

Example Prompts for GitHub Alternative in Google ADK

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

"Show me all open issues in my backend-api repo."

"What's the status of recent workflow runs on main branch?"

"Search for popular Python machine learning repos with over 1000 stars."

Troubleshooting GitHub Alternative MCP Server with Google ADK

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

McpToolset not found

Update: pip install --upgrade google-adk

GitHub Alternative + Google ADK FAQ

Common questions about integrating GitHub Alternative 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.