landmine — Claude Code MCP server: what it does, how to install
landmine — an MCP server that tracks open bugs in exact npm and PyPI versions from your lockfile and stops the agent before it writes code that hits a known issue.
MIT ★ 10 updated 2026-10-24
claude mcp add --transport http landmine https://landmine.tech/mcpWhat landmine does
Two-stage workflow: landmine scan reads the lockfile, finds open GitHub issues filed against the pinned versions, picks useful workarounds from the comment threads, and writes an index to .landmine/index.json. The landmine install --rules command adds a pre-edit hook and writes known-bugs sections into AGENTS.md and CLAUDE.md.
The hook runs offline in a fraction of a second before each edit, and fires only if the file contains a symbol from the index and meets the issue's extra conditions — for example, it also uses the database driver mentioned in the bug report. The agent sees the issue link and a quoted workaround. If the agent retries the same edit, the hook lets it through.
For large projects with dozens of dependencies, the issue list in CLAUDE.md may not fit in context. In that case, keep just the hook or use the hosted MCP server at https://landmine.tech/mcp, which the agent queries on demand — no GitHub token required.
What it helps with
- stop the agent before an edit that uses an API with an open bug in the exact lockfile version
- extract a workaround from issue comments and hand it to the agent
- check whether an error has an open bug in the pinned library version
- add a known-bugs section to agent documentation
Example prompts for the agent
- Run
npx landmines scanand thennpx landmines install --rulesto add the hook and section toCLAUDE.md. - Check if there's an open bug in
drizzle-ormversion 0.36.0 for the$client.end()method. - Find workarounds for issues in
react-hook-formthat apply to the version inpackage-lock.json.
How to install landmine
1Platform CLI: remote server
claude mcp add --transport http landmine https://landmine.tech/mcp2Platform CLI
claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --transport stdio landmine -- npx -y landminesReplace <…> with your own values
1Platform CLI: remote server
codex mcp add landmine --url https://landmine.tech/mcp2Platform CLI
codex mcp add landmine --env GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y landminesReplace <…> with your own values
Config file
{
"mcpServers": {
"landmine": {
"url": "https://landmine.tech/mcp"
}
}
}{
"mcpServers": {
"landmine": {
"command": "npx",
"args": [
"-y",
"landmines"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"landmine": {
"type": "http",
"url": "https://landmine.tech/mcp"
}
}
}{
"servers": {
"landmine": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"landmines"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http landmine https://landmine.tech/mcp2Platform CLI
gemini mcp add -e GITHUB_TOKEN=<GITHUB_TOKEN> landmine npx -y landminesReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about landmine
How to install landmine in Claude Code?
For the hosted server, run claude mcp add --transport http landmine https://landmine.tech/mcp. For local setup, run claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --transport stdio landmine -- npx -y landmines.
What does landmine do?
Scans the lockfile, finds open bugs filed against the pinned versions, extracts workarounds from comment threads, and stops the agent before an edit that hits a known issue.
Does landmine need a GitHub token?
The hosted server at https://landmine.tech/mcp works without a token. The local npx landmines command requires the GITHUB_TOKEN environment variable for GitHub API access.