Altcheck
Finds open-source alternatives to a tool and rates each as viable, risky or avoid
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 4 days ago
Similar MCP servers
About Altcheck
Altcheck is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add altcheck --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y altcheckAdd to claude_desktop_config.json
{
"mcpServers": {
"altcheck": {
"command": "npx",
"args": [
"-y",
"altcheck"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"altcheck": {
"command": "npx",
"args": [
"-y",
"altcheck"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"altcheck": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"altcheck"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"altcheck": {
"command": "npx",
"args": [
"-y",
"altcheck"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"altcheck": {
"command": "npx",
"args": [
"-y",
"altcheck"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GITHUB_TOKENOptional GitHub token. Without one GitHub allows ~60 requests/hour (about 2 lookups).
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
MIT licence
Altcheck 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.


