# GitHub MCP for AI Agents AI Agent Connect > GitHub lets you manage your entire development workflow through your AI client. You can browse repositories, track issues, read file contents, and monitor pull requests without switching tabs. It handles the heavy lifting of navigating your source control, making it easier to stay on top of project status and team activity. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_AI5HxyZx099tgXdpr8GRZXGxF9M4ju1Zd4fQUt7k/ai-agent-connect - **Tags:** source-control, repository-management, pull-requests, issue-tracking, ci-cd, version-control, code-collaboration ## Description This GitHub MCP connects your account to your AI agent so you can manage source control without leaving your chat window. Think about the friction of having twenty browser tabs open just to keep track of a project. You're jumping between issue trackers, looking for that one specific logic block in a repo, and checking if a teammate actually merged that PR yet. This setup removes that context switching. Instead of manually hunting for information, you just ask your agent to find it. You can have it pull the contents of a file for a quick review, list out all the open bugs in a specific project, or check your notifications to see what's actually urgent. It turns your AI into a high-level engineering coordinator that knows your codebase inside and out. Because Vinkius hosts this, you can plug it into your existing setup and start using it immediately. It's about moving from 'where is that file?' to 'show me the logic for the auth flow' in one go. ## Tools ### create_new_issue Open a new issue on a repository to track a bug or feature request. ### get_file_content Read the raw content of a specific file from a repository for analysis. ### get_my_profile Fetch your personal account information and public profile details. ### get_repository_details Retrieve metadata and specific information about a single repository. ### list_repo_branches See all the different branches available within a specific repository. ### list_my_gists View your saved code snippets and Gists in one list. ### list_repository_issues Get a list of all issues associated with a specific repository. ### list_recent_notifications Check your GitHub inbox for the latest alerts and mentions. ### list_my_organizations See all the organizations you are currently a member of. ### list_pull_requests View all the open and closed pull requests for a repository. ### list_my_repositories Get a full list of all repositories owned by your account. ### search_repositories Search for specific projects across the entire GitHub platform. ## Prompt Examples **Prompt:** ``` Show me the README for the auth-service repo. ``` **Response:** ``` I've retrieved the README.md for the auth-service repository. It outlines the OAuth2 flow and lists the required environment variables. Would you like me to summarize the setup steps? ``` **Prompt:** ``` Are there any open issues for the frontend project? ``` **Response:** ``` I found 4 open issues for the frontend project: - **Bug #102**: Login button unresponsiveness - **Task #105**: Update logo assets - **Bug #108**: CSS overflow on mobile - **Task #110**: Refactor header component Would you like more details on any of these? ``` **Prompt:** ``` What organizations am I in? ``` **Response:** ``` You are currently a member of the following organizations: - **Vinkius** - **OpenSource_Devs** - **Cloud_Native_Group** Do you want me to look up any specific repository details for these? ``` ## Capabilities ### Find specific files in repositories Locate the exact code you need across your entire project history. ### Create new issues for bug tracking Log new bugs or feature requests directly through your chat interface. ### List all your GitHub repositories Get a full overview of every project you own in one command. ### Check recent notifications for updates See what your team is doing without checking your inbox. ### Retrieve contents of specific files Pull raw file data into your conversation for instant analysis. ### List pull requests for a project Monitor the status of code reviews and merge requests. ### Get information on your user profile Access your account details and organization memberships. ## Use Cases ### Finding a needle in a haystack An engineer needs to find where a specific API call is handled across five different repos. They ask the agent to search and pull the file content. ### Triage day A lead wants to know what's broken. They ask the agent to list all open issues and summarize the most recent ones. ### Onboarding A new hire wants to see what projects the team owns. The agent lists all repositories and their star counts. ### Quick updates A dev wants to know if their PR was reviewed. The agent checks the pull requests and tells them the status. ## Benefits - Stop switching tabs by using list_my_repositories to see your whole portfolio in one place. This lets you quickly jump between different projects without losing your flow in the browser. - Speed up debugging by using get_file_content to pull code directly into your chat. You can have your agent analyze specific logic blocks without having to copy and paste massive chunks of text. - Keep projects moving by using create_new_issue to log bugs the moment you find them. You can report a problem via natural language and have the agent handle the tedious work of opening the ticket. - Stay in the loop by using list_recent_notifications to see what your team is doing. You can get a quick summary of mentions and alerts so you don't have to check your inbox every five minutes. - Simplify repo discovery by using search_repositories to find the right codebases quickly. This is great for finding specific projects across the platform when you're not sure exactly where the code lives. ## How It Works The bottom line is you get a direct line of communication between your AI and your entire source control history. 1. Get your Personal Access Token (PAT) from your GitHub developer settings. 2. Provide the token to your Connector client to establish a secure connection. 3. Ask your agent to perform actions like searching repos or listing issues. ## Frequently Asked Questions **Can the GitHub MCP help me find specific code in my private repos?** Yes, if your token has the right permissions, your agent can search through your private repositories and pull specific file contents for you. **How do I use the GitHub MCP to track my team's progress?** You can ask your agent to list pull requests or check recent notifications to see what your teammates are merging and discussing. **Can I use the GitHub MCP to create issues automatically?** Yes, you can tell your agent to create a new issue directly, which saves you from having to leave your current workspace to go to the web UI. **Will the GitHub MCP work with my existing AI client?** It works with any MCP-compatible client like Claude, Cursor, or Windsurf. **Does the GitHub MCP support searching for public projects too?** Yes, it can search for repositories across the entire platform, not just your own. **Can the GitHub MCP help me manage my Gists?** It can list your saved Gists so you can quickly find and reference snippets you've saved in the past. **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.