# Gitworthy MCP server

> Helps coding agents scout, rank, and preflight software tasks to avoid redundant or blocked open-source contributions.

- Repository: https://github.com/trippyogi/gitworthy
- Page: https://hostedmcp.org/servers/trippyogi/gitworthy
- Transport: stdio
- Stars: 2
- License: MIT
- Latest version: 0.3.6

## Install

### Claude Code

```sh
claude mcp add --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' gitworthy -- npx -y gitworthy
```

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

```json
{
  "mcpServers": {
    "gitworthy": {
      "command": "npx",
      "args": [
        "-y",
        "gitworthy"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "gitworthy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gitworthy"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"gitworthy","type":"stdio","command":"npx","args":["-y","gitworthy"],"env":{"GITHUB_TOKEN":"<YOUR_GITHUB_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "gitworthy": {
      "command": "npx",
      "args": [
        "-y",
        "gitworthy"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add gitworthy --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' -- npx -y gitworthy
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.gitworthy]
command = "npx"
args = ["-y", "gitworthy"]

[mcp_servers.gitworthy.env]
GITHUB_TOKEN = "<YOUR_GITHUB_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' gitworthy npx -- -y gitworthy
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "gitworthy": {
      "command": "npx",
      "args": [
        "-y",
        "gitworthy"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GITHUB_TOKEN` | no | yes | GitHub personal access token (fine-grained, read-only public repos). Optional; raises API rate limit from 60 to 5000 requests/hour. |
| `GITWORTHY_MCP_TOKEN` | no | no |  |

## Tools (8)

- `branch_scan`
- `issue_vs_main`
- `release_gap`
- `dupe_cluster`
- `linked_work`
- `contrib_policy`
- `worth_check`
- `scan`

## FAQ

### What does an ACT verdict mean?

An ACT verdict means the task is worth considering, but it is not a command to start coding blindly; the agent should still recheck the state before implementing.

### Does Gitworthy require specific GitHub permissions?

The token only needs read access to public repositories, though using a token with Issues: Read access provides more accurate linked-work detection.

### What checks does Gitworthy perform to protect against wasteful work?

It performs several checks including linked work detection, branch scans, checking if fixes landed on main, release gap analysis, and contribution policy verification.
