How to Use GitHub MCP Server with OpenAI Agents SDK using Vinkius

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

GDPR Free for Subscribers

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

Ask AI about this MCP Server for OpenAI Agents SDK

ChatGPT Claude Perplexity

The GitHub MCP Server for OpenAI Agents SDK 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

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 Assistant",
            instructions=(
                "You help users interact with GitHub. "
                "You have access to 12 tools."
            ),
            mcp_servers=[mcp_server],
        )

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

asyncio.run(main())

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.

The OpenAI Agents SDK does not just connect to GitHub. It enforces structure around every interaction. Built-in guardrails validate inputs before they reach a tool. Tracing captures every call, every response, every token spent. Handoff patterns let you chain multiple specialized agents where one queries GitHub, another validates the output, and a third acts on the result. 12 tools are auto-discovered through native MCP integration. No manual schema definitions. No brittle adapters.

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 OpenAI Agents SDK in under two minutes. Fully managed, no infrastructure to provision, no vendor lock-in.

12 tools included

Explore every tool GitHub exposes to OpenAI Agents SDK through Vinkius.

View all 12 tools

Connect GitHub to OpenAI Agents SDK via MCP

Follow these steps to connect GitHub to OpenAI Agents SDK. 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 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 12 tools from GitHub

Why Use OpenAI Agents SDK with the GitHub MCP Server

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

The SDK auto-discovers all 12 tools from GitHub through Vinkius via native MCP. No manual schema definitions. No adapter code. Pass the URL and agents see every tool immediately

Built-in guardrails validate inputs before they reach GitHub through Vinkius. Tracing captures every tool call, every response, every token spent in production

Chain specialized agents: one queries GitHub data through Vinkius, another validates the output, a third generates reports. Each with its own guardrails and permissions

First-party OpenAI integration means GPT models interact with GitHub tools through optimized function calling. Vinkius provides the connection. OpenAI provides the reasoning

GitHub + OpenAI Agents SDK Use Cases

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

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

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

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

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

Example Prompts for GitHub in OpenAI Agents SDK

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

Common issues when connecting GitHub to OpenAI Agents SDK through 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 + OpenAI Agents SDK FAQ

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

Can I use multiple MCP servers in one agent?

Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.

Does the SDK support streaming responses?

Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.

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