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 LlamaIndex 14 tools — connect in under 2 minutes

Name: GitHub Alternative
Availability: InStock
Author: Vinkius

docs.llamaindex.ai/en/stable/module_guides/tools/mcp

Built by Vinkius GDPR 14 Tools Framework

LlamaIndex specializes in data-aware AI agents that connect LLMs to structured and unstructured sources. Add GitHub Alternative as an MCP tool provider through the Vinkius and your agents can query, analyze, and act on live data alongside your existing indexes.

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

import asyncio
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

async def main():
    # Your Vinkius token — get it at cloud.vinkius.com
    mcp_client = BasicMCPClient("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
    mcp_tool_spec = McpToolSpec(client=mcp_client)
    tools = await mcp_tool_spec.to_tool_list_async()

    agent = FunctionAgent(
        tools=tools,
        llm=OpenAI(model="gpt-4o"),
        system_prompt=(
            "You are an assistant with access to GitHub Alternative. "
            "You have 14 tools available."
        ),
    )

    response = await agent.run(
        "What tools are available in GitHub Alternative?"
    )
    print(response)

asyncio.run(main())

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.

LlamaIndex agents combine GitHub Alternative tool responses with indexed documents for comprehensive, grounded answers. Connect 14 tools through the Vinkius and query live data alongside vector stores and SQL databases in a single turn — ideal for hybrid search, data enrichment, and analytical workflows.

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 LlamaIndex 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 LlamaIndex via MCP

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

Install dependencies

Run pip install llama-index-tools-mcp llama-index-llms-openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.py and run: python agent.py

Explore tools

The agent discovers 14 tools from GitHub Alternative

Why Use LlamaIndex with the GitHub Alternative MCP Server

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

Data-first architecture: LlamaIndex agents combine GitHub Alternative tool responses with indexed documents for comprehensive, grounded answers

Query pipeline framework lets you chain GitHub Alternative tool calls with transformations, filters, and re-rankers in a typed pipeline

Multi-source reasoning: agents can query GitHub Alternative, a vector store, and a SQL database in a single turn and synthesize results

Observability integrations show exactly what GitHub Alternative tools were called, what data was returned, and how it influenced the final answer

GitHub Alternative + LlamaIndex Use Cases

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

Hybrid search: combine GitHub Alternative real-time data with embedded document indexes for answers that are both current and comprehensive

Data enrichment: query GitHub Alternative to augment indexed data with live information before generating user-facing responses

Knowledge base agents: build agents that maintain and update knowledge bases by periodically querying GitHub Alternative for fresh data

Analytical workflows: chain GitHub Alternative queries with LlamaIndex's data connectors to build multi-source analytical reports

GitHub Alternative MCP Tools for LlamaIndex (14)

These 14 tools become available when you connect GitHub Alternative to LlamaIndex 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 LlamaIndex

Ready-to-use prompts you can give your LlamaIndex 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 LlamaIndex

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

BasicMCPClient not found

Install: pip install llama-index-tools-mcp

GitHub Alternative + LlamaIndex FAQ

Common questions about integrating GitHub Alternative MCP Server with LlamaIndex.

How does LlamaIndex connect to MCP servers?

Use the MCP client adapter to create a connection. LlamaIndex discovers all tools and wraps them as query engine tools compatible with any LlamaIndex agent.

Can I combine MCP tools with vector stores?

Yes. LlamaIndex agents can query GitHub Alternative tools and vector store indexes in the same turn, combining real-time and embedded data for grounded responses.