Skip to content
MCP server

landmine

Known open GitHub bugs in your exact npm and PyPI versions, with workarounds

Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally or Remotely
Version
0.2.2
Listing updated
3 days ago

About landmine

landmine is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://landmine.tech/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "landmine": {
      "url": "https://landmine.tech/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • GITHUB_TOKENGitHub token for landmine_lookup (no scopes needed). Without it, the GitHub CLI's login is used.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licence; hosted endpoint needs no sign-in

Prices change. Check landmine.tech before you buy.

landmine 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 to landmine

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools