# gitgoblin

> gitgoblin is an open-source MCP server for developer tools. Find open-source projects worth contributing to and the work they need. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://anandkaranubc.github.io/gitgoblin/
- **Repository:** https://github.com/anandkaranubc/gitgoblin/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.anandkaranubc/gitgoblin
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

The server is the read-only part of a larger project that helps people contribute to other people's software. It ranks public repositories against a goal you choose (contribute, learn, adopt, revive or explore) and shows the reasons for each rank, so a quiet library can outrank a crowded one. The pull-request step in the main project is still experimental, and nothing is published without a person approving it.

Four tools cover the flow: discover repositories, explain a score with its eleven signals, analyse a repository's profile and ranked opportunities, and fetch one opportunity with clone steps, commands and conventions. Analysis supports GitHub, GitLab and Codeberg; discovery reads GitHub.

The README treats repository text as hostile. It only reads repositories confirmed public, runs analysis in a child process with an empty home directory, stops after five minutes, allows two at once and strips control characters from output. A GitHub token is optional and lifts the rate limit from 60 to 5000 requests an hour.

## Features

- **Goal-based ranking:** Rank repositories for contributing, learning, adopting, reviving or exploring.
- **Score explanations:** See each signal's value, weight and evidence.
- **Opportunity finding:** Surface issues, stale pull requests and other checkable work.
- **Contribution briefing:** Get clone, commands, conventions and etiquette for one task.
- **Hardened analysis:** Runs repository analysis in an isolated child process with a timeout.
- **Opt-out respect:** Projects whose maintainers opted out are left out.

## Good for

- Find a small project to contribute a first pull request to
- Check whether a dependency's maintainers welcome outside contributors
- Pick a revival candidate among quiet repositories
- Brief an agent on one issue before it starts work

## Install

### Claude Code (Terminal)

```sh
claude mcp add gitgoblin --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @gitgoblin/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gitgoblin": {
      "command": "npx",
      "args": [
        "-y",
        "@gitgoblin/mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gitgoblin": {
      "command": "npx",
      "args": [
        "-y",
        "@gitgoblin/mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "gitgoblin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gitgoblin/mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gitgoblin": {
      "command": "npx",
      "args": [
        "-y",
        "@gitgoblin/mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gitgoblin": {
      "command": "npx",
      "args": [
        "-y",
        "@gitgoblin/mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

## Tools

- `discover_repositories`: Rank public repositories for a goal with reasons for and against.
- `explain_repository`: Show all eleven discovery signals with value, weight and evidence.
- `analyze_repository`: Profile a repository and rank its opportunities with evidence.
- `get_opportunity`: Full detail on one opportunity plus how to work on the project.

## FAQ

### Does it open pull requests?

No. The four tools are read-only, and the server instructions say it never opens issues, pull requests or comments unless asked.

### Do I need a GitHub token?

Optional. It raises limits from 60 to 5000 requests an hour and unlocks starter-issue data.

### Which hosts can it analyse?

analyze_repository and get_opportunity accept GitHub, GitLab and Codeberg; other hosts are refused.

### How do I install it?

Run claude mcp add gitgoblin -- npx -y @gitgoblin/mcp, or use the .mcpb bundle for Claude Desktop.

### Is gitgoblin free?

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

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

Run this command in your terminal: claude mcp add gitgoblin --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @gitgoblin/mcp

### What are the best alternatives to gitgoblin?

The closest alternatives to gitgoblin 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/gitgoblin
