# Altcheck

> Altcheck is an open-source MCP server for developer tools. Finds open-source alternatives to a tool and rates each as viable, risky or avoid. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/aziizbg/altcheck
- **MCP Registry name:** io.github.AziizBg/altcheck
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-14

## About

Altcheck is aimed at the question directories skip: which alternatives are still safe to bet on. Starting from a proprietary tool you want to replace, it gathers candidates from a seed list of 213 projects mapped to 134 proprietary tools and from live GitHub repos with 100 or more stars that describe themselves as an alternative. Each candidate gets a verdict computed live from public GitHub data, with the reason printed beside it.

The checks look for archived or long-idle repos, a lack of recent commits, source-available licences such as BUSL, SSPL or FSL, missing or unrecognised licences, recent licence changes, very young repos and bus factor. The README notes that stable finished software can be flagged as stale and that bus factor is a rough signal, so the reason matters more than the label.

Without a GitHub token the API allows about 60 requests an hour, which is roughly two lookups, since each repo costs about five requests. With a token it checks ten candidates by default. Projects not hosted on GitHub are invisible to it.

## Features

- **Alternative discovery:** Finds alternatives to a named tool from a seed list and live GitHub search.
- **Three-level verdicts:** Rates each candidate VIABLE, RISKY or AVOID with reasons.
- **Licence reading:** Detects source-available licences from the licence text when GitHub reports NOASSERTION.
- **Single repo vetting:** vet_repo checks any one repository on its own.
- **Command line and JSON:** Runs with npx altcheck, with --json and --limit options for scripts.
- **Rate-limit awareness:** Uses GITHUB_TOKEN, GH_TOKEN or gh auth and says when the limit resets.

## Good for

- Check whether an open-source Notion alternative is actually maintained before adopting it
- Vet a single repository such as a Terraform fork
- Spot BUSL or SSPL licences presented as open source
- Give an agent a quick buy-versus-adopt shortlist for a SaaS tool

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `find_alternatives`: Finds open-source alternatives to a named tool and vets each.
- `vet_repo`: Vets a single repository and returns a verdict with reasons.

## FAQ

### Is each verdict a hand-written opinion?

No. The README says every verdict is computed live from public data with no sponsored ranking.

### Do I need a GitHub token?

It is optional. Without one GitHub allows about 60 requests an hour, around two lookups; with a token it allows 5,000 an hour.

### How do I run it as an MCP server?

Run claude mcp add altcheck -- npx -y altcheck --mcp. It needs Node 18 or newer.

### How accurate is it?

On two blind benchmarks the README reports status right in 59 of 60 repos and no case of VIABLE for a non-open-source or abandoned repo.

### Is Altcheck free?

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

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

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

### What are the best alternatives to Altcheck?

The closest alternatives to Altcheck are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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