# gitpro

> gitpro is an open-source MCP server for developer tools. Read-only MCP server that shows which git name, email and SSH key a repo will use. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, vscode
- **Website:** https://gitpro.dev
- **Repository:** https://github.com/yantrakar/gitpro
- **MCP Registry name:** io.github.Yantrakar/gitpro
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

The MCP server is the agent-facing half of gitpro, a tool that picks a Git identity from a repository's remote URL rather than from the folder it was cloned into. The server only answers questions: which identity a repository uses, why, and whether a commit would be blocked. Tools named on the site include why, setup, scan, audit, env and report, and fix commands wait for your approval.

It matters because coding agents run `git commit`, `git push` and `gh pr create` on their own. gitpro also ships a Claude Code PreToolUse hook that denies a call made under the wrong identity and never grants anything, and `gitpro audit` can find commits made as the wrong identity, fixing unpushed ones with `--fix`.

Gitpro writes ordinary git and SSH config with no daemon, previews every change and backs up hand-written files. It requires Linux or macOS, Git 2.36 or newer and Python 3.9 or newer, and is MIT-licensed. Hosts tested include GitHub, GitLab, Bitbucket, Azure DevOps, Codeberg and Gitea.

## Features

- **Identity by remote URL:** Matches name, email and SSH key to the repository's remote.
- **Explains mismatches:** The why check shows the expected identity and what overrides it.
- **Commit guard:** Optional hooks refuse commits or pushes made as the wrong identity.
- **Agent hook:** A Claude Code hook that only denies, never grants.
- **History audit:** Finds commits made as the wrong identity or by an agent.
- **Plain config:** Writes ordinary git and SSH files with previews and backups.

## Good for

- Check which identity a repo would commit as before an agent pushes
- Keep work and personal GitHub accounts separate
- Find commits that went out under the wrong email
- Block an AI agent from committing as the wrong person

## Install

### Claude Code (Terminal)

```sh
claude mcp add gitpro -- uvx gitpro
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gitpro": {
      "command": "uvx",
      "args": [
        "gitpro"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gitpro": {
      "command": "uvx",
      "args": [
        "gitpro"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gitpro": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gitpro"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gitpro": {
      "command": "uvx",
      "args": [
        "gitpro"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gitpro": {
      "command": "uvx",
      "args": [
        "gitpro"
      ]
    }
  }
}
```

## Tools

- `why`: Explain which identity a repository uses and what overrides it
- `setup`: Show what setup would change
- `scan`: Find repositories that need a fix
- `audit`: Find commits made as the wrong identity
- `env`: Show the environment
- `report`: Draft an issue report

## FAQ

### Does the MCP server change anything?

No. It is read-only, and fix commands wait for your approval.

### What platforms does it need?

Linux or macOS, Git 2.36 or newer, Python 3.9 or newer and OpenSSH.

### How do I start it?

Run `gitpro mcp` or `uvx gitpro mcp` after installing with pipx.

### Does it run in the background?

No. It generates plain git and SSH configuration and needs no background service.

### Is gitpro free?

Yes. gitpro is open source, so you can use and self-host it for free.

### How do I add gitpro to Claude Code?

Run this command in your terminal: claude mcp add gitpro -- uvx gitpro

### What are the best alternatives to gitpro?

The closest alternatives to gitpro are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/gitpro
