# GitHub MCP for AI Agents AI Agent Connect > GitHub MCP. Manage your repositories, issues, pull requests, and workflows directly through your AI agent. Search code, audit commits, and track CI/CD status without leaving your current environment. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Fs6ARdeOUjEtquZ4puq0S9YBTJZm5AW6KCA3rW32/ai-agent-connect - **Tags:** source-control, repository-management, pull-requests, issue-tracking, ci-cd, version-control, code-collaboration ## Description Imagine you're in the middle of a deep coding session and need to know if that critical bug fix pull request actually merged or if the latest automated build failed. Instead of switching tabs to your browser, searching through your history, and digging through a complex web of menus, you just ask your agent. This Connector gives your AI the eyes it needs to see your entire development lifecycle. You can have it summarize recent commits, find specific issues in a massive repository, or list all your active pull requests in one go. It turns your AI into a dedicated engineering lead that knows your project's history. Because Vinkius hosts this Connector, you get a reliable way to bridge your local workflow with your remote repositories. You stop hunting for information and start getting answers. You can manage the meta of your code, including the bugs, the status updates, and the release notes, without ever losing your place in your editor. It's about moving from manual checking to active oversight. Instead of being a passive observer of your repo's health, you become a proactive manager. You can triage a backlog of tasks, verify the status of a deployment, or audit the history of a specific feature with a single sentence. It's about staying in the zone while keeping your eyes on the big picture of your project's progress. ## Tools ### create_new_issue Open GitHub issue ### get_file_content Read file from repo ### get_my_profile Get account info ### get_repository_details Get repo info ### list_repo_branches Check repo branches ### list_my_gists List code snippets ### list_repository_issues List repo issues ### list_recent_notifications Check GitHub inbox ### list_my_organizations List user orgs ### list_my_repositories List your GitHub repos ### search_repositories Find GitHub projects ### list_pull_requests Browse your pull requests to see their status and merge info. This keeps your review queue organized. ## Prompt Examples **Prompt:** ``` Show me all open issues in my backend-api repo. ``` **Response:** ``` I found 7 open issues in backend-api. The most critical is **#142 'Database connection timeout on high load'** (bug, high-priority, assigned to @alice). Other notable issues include: * #138 'Add rate limiting middleware' * #135 'Refactor auth middleware to support OAuth2' ``` **Prompt:** ``` What's the status of recent workflow runs on main branch? ``` **Response:** ``` **Recent Workflow Runs on Main:** | Workflow | Status | Conclusion | Time Ago | | :--- | :--- | :--- | :--- | | CI Pipeline | ✅ Success | 12m ago | | Deploy to Staging | ✅ Success | 10m ago | | Security Scan | ✅ Success | 8m ago | | Release Build | ❌ Failure | 2h ago | | Integration Tests | ✅ Success | 3h ago | ``` **Prompt:** ``` Search for popular Python machine learning repos with over 1000 stars. ``` **Response:** ``` I found several highly-starred Python ML repos: * **huggingface/transformers** (119k stars) * **scikit-learn/scikit-learn** (58k stars) * **tensorflow/tensorflow** (185k stars) * **pytorch/pytorch** (79k stars) * **microsoft/ML-For-Beginners** (27k stars) Would you like more details on any of these? ``` ## Capabilities ### Audit commit history View who changed what and when across any branch. ### Manage issues Create, list, and inspect issues with labels and Markdown. ### Track pull requests Browse PR statuses, draft states, and review info. ### Monitor CI/CD Check the status and conclusion of recent GitHub Actions runs. ### Search repositories Find specific repos using GitHub's query syntax. ### List releases Fetch release details and assets by git tag. ### Browse branches See all branches in a repo including their commit SHAs. ## Use Cases ### Triage a backlog A maintainer asks the agent to list all open issues with the bug label and summarize them using list_issues. ### Check CI status A developer asks if the latest deploy to production succeeded after pushing a change by checking list_workflow_runs. ### Audit a repo A new hire asks the agent to show the last 10 commits on the main branch to see recent progress using list_commits. ### Find projects A manager asks the agent to find all repositories in the org that use TypeScript using search_repos. ## Benefits - Stop tab-switching by getting PR status and issue details directly in your chat using list_pull_requests. - Faster issue triaging using list_issues to see what is open, assigned, or requires attention. - Better visibility into CI/CD health by using list_workflow_runs to check for failures instantly. - Easier repo discovery with search_repos to find specific projects using complex queries. - Complete history audits by using list_commits to see exactly how a feature evolved over time. - Streamlined release management by fetching specific release details with get_release_by_tag. ## How It Works The bottom line is you get a hands-free way to manage your entire GitHub presence from your preferred AI client. 1. Subscribe to the GitHub MCP on the Vinkius Marketplace. 2. Enter your GitHub Personal Access Token to authenticate. 3. Start managing your repos from Claude, Cursor, or any MCP-compatible client. ## Frequently Asked Questions **Can the GitHub MCP create issues for me?** Yes, you can ask your agent to create a new issue with a specific title, description, and labels. It will handle the submission to GitHub for you automatically. **How does the GitHub MCP help with CI/CD?** It allows your agent to check the status and conclusion of your recent GitHub Actions runs. You can quickly see if your latest deployment or build succeeded or failed. **Can I use the GitHub MCP to search for public repos?** Yes, you can use the search functionality to find repositories based on language, star counts, or other specific qualifiers using natural language. **Does the GitHub MCP work with my private repositories?** It works with any repository your Personal Access Token has permission to access, including private ones belonging to your organization or personal account. **How do I check my PR status using the GitHub MCP?** You can simply ask your agent to list your pull requests. It will return the status, author, and draft state for your active reviews. **Can the GitHub MCP see my release notes?** Yes, you can fetch specific release details and assets by providing the git tag name to your agent. **Can I use the GitHub MCP to audit my commit history?** You can ask your agent to list the latest commits on any branch. This helps you see exactly what changes were made and by whom. **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. **Can I read private repositories?** Yes, provided your Personal Access Token (PAT) has the 'repo' scope or appropriate fine-grained permissions for those repositories. **How do I find a repository owner and name?** In a GitHub URL like `github.com/vinkius/mcp-server`, the owner is `vinkius` and the repository name is `mcp-server`. **Does it support creating pull requests?** This version supports listing pull requests and issues. PR creation is currently handled through the web interface or other specialized tools.