How to Use GitHub MCP Server with Mastra AI using Vinkius
Give Mastra AI instant access to 12 tools to Create New Issue, Get File Contents, Get My Github Profile, and more using Vinkius.
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect GitHub through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The GitHub MCP Server for Mastra AI 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
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"github": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "GitHub Agent",
instructions:
"You help users interact with GitHub " +
"using 12 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with GitHub?"
);
console.log(result.text);
}
main();
* 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.
Mastra separates what most frameworks conflate: the intelligence layer from the infrastructure layer. Connect GitHub through Vinkius and 12 tools slot into Mastra's workflow engine with conditional branching, automatic retries, and parallel execution paths. The agent decides what to do. The workflow engine ensures it actually happens. One command deploys the entire pipeline to Vercel, Railway, Fly.io, or your own infrastructure. No Docker. No Kubernetes. No excuses.
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 Mastra AI in under two minutes. Fully managed, no infrastructure to provision, no vendor lock-in.
12 tools included
Explore every tool GitHub exposes to Mastra AI through Vinkius.
Connect GitHub to Mastra AI via MCP
Follow these steps to connect GitHub to Mastra AI. The setup takes under two minutes and requires no coding or server hosting.
Get your Vinkius Access Token
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the GitHub MCP Server
Mastra AI provides unique advantages when paired with GitHub through the Model Context Protocol.
GitHub tools from Vinkius slot into Mastra's workflow engine with conditional branching, automatic retries, and parallel execution. Not just agent logic. Real orchestration
TypeScript-native: full type inference for every GitHub tool response through Vinkius. IDE autocomplete and compile-time error checking across the entire pipeline
One command deploys your GitHub workflows from Vinkius to Vercel, Railway, Fly.io, or your own infrastructure. No Docker. No Kubernetes. No ops overhead
Clean separation: Mastra handles workflow orchestration, Vinkius handles GitHub connection infrastructure, your code handles business logic. Each layer does one thing well
GitHub + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the GitHub MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query GitHub, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed GitHub as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query GitHub on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using GitHub tools alongside other MCP servers
Example Prompts for GitHub in Mastra AI
Ready-to-use prompts you can give your Mastra AI 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 Mastra AI
Common issues when connecting GitHub to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpGitHub + Mastra AI FAQ
Common questions about integrating GitHub MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.
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.
Connect GitHub with your favorite client
Also available for these clients and frameworks:
Connect GitHub to Mastra AI
One click to install, 12 tools ready instantly. Fully managed, no API key setup required.