# landmine

> landmine is an open-source MCP server for developer tools. Known open GitHub bugs in your exact npm and PyPI versions, with workarounds. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://landmine.tech
- **Repository:** https://github.com/devanshranjan10/landmines
- **MCP Registry name:** tech.landmine/landmine
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Coding agents are trained before the bug you are about to hit was filed. Landmine reads your lockfile, resolves each exact version, finds open GitHub issues that name it, ties each to the code symbols involved, and picks the most useful workaround from the thread. The hosted MCP server answers the same question on demand for any npm or PyPI version, with nothing to install.

The larger project also writes a known-bugs section into AGENTS.md and CLAUDE.md and installs a pre-edit hook that pauses an edit once when it touches an affected API, quotes the workaround, then lets the retry through. The README reports a benchmark of 21 post-cutoff bug traps: Claude Sonnet 5.5 passed 86 percent unaided and 99 percent with the rules section, while the hook alone did not significantly beat no help.

Issue text is framed as untrusted third-party content. The stdio package asks for a GitHub token with no scopes, or falls back to the GitHub CLI login.

## Features

- **Lockfile scan:** Finds open issues that name the versions you actually pin.
- **Known-bugs section:** Writes ranked issues into AGENTS.md and CLAUDE.md.
- **Pre-edit hook:** Pauses an edit once, quotes the workaround, then allows the retry.
- **Hosted MCP lookup:** Query any exact npm or PyPI version without installing.
- **Broad agent support:** Installs for 20 coding agents, including Claude Code, Codex and Cursor.
- **Open source:** MIT-licensed.

## Good for

- Warn an agent before it calls a broken API in your pinned library
- Check whether an error is a known upstream bug
- Review a dependency before adding it
- Seed CLAUDE.md with version-specific pitfalls

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http landmine https://landmine.tech/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://landmine.tech/mcp
```

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

```json
{
  "mcpServers": {
    "landmine": {
      "url": "https://landmine.tech/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "landmine": {
      "type": "http",
      "url": "https://landmine.tech/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "landmine": {
      "serverUrl": "https://landmine.tech/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "landmine": {
      "type": "http",
      "url": "https://landmine.tech/mcp"
    }
  }
}
```

## Tools

- `landmine_lookup`: Looks up known open GitHub issues for an exact package version

## FAQ

### Does it need a GitHub token?

The stdio package uses a GITHUB_TOKEN with no scopes, or the GitHub CLI login if none is set.

### Does it replace Context7 or web search?

The README says Context7 serves docs, not bug reports, and that agents in its tests never searched on their own.

### How fast is the hook?

About 0.11 seconds per call offline on the authors' test machine.

### What runtime is needed?

Node 22.12 or later for the CLI.

### Is landmine free?

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

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

Run this command in your terminal: claude mcp add --transport http landmine https://landmine.tech/mcp

### What are the best alternatives to landmine?

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