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

Name: GitHub Alternative
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 14 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect GitHub Alternative through the Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails — no manual schema definitions required.

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 agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token — get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="GitHub Alternative Assistant",
            instructions=(
                "You help users interact with GitHub Alternative. "
                "You have access to 14 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from GitHub Alternative"
        )
        print(result.final_output)

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.

The OpenAI Agents SDK auto-discovers all 14 tools from GitHub Alternative through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns — chain multiple agents where one queries GitHub Alternative, another analyzes results, and a third generates reports, all orchestrated through the Vinkius.

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 OpenAI Agents SDK 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 OpenAI Agents SDK via MCP

Follow these steps to integrate the GitHub Alternative MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 14 tools from GitHub Alternative

Why Use OpenAI Agents SDK with the GitHub Alternative MCP Server

OpenAI Agents SDK provides unique advantages when paired with GitHub Alternative through the Model Context Protocol.

Native MCP integration via `MCPServerSse` — pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

GitHub Alternative + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the GitHub Alternative MCP Server delivers measurable value.

Automated workflows: build agents that query GitHub Alternative, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents — one queries GitHub Alternative, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through GitHub Alternative tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query GitHub Alternative to resolve tickets, look up records, and update statuses without human intervention

GitHub Alternative MCP Tools for OpenAI Agents SDK (14)

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

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

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

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

GitHub Alternative + OpenAI Agents SDK FAQ

Common questions about integrating GitHub Alternative MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.