# Footgun

Footgun gives coding agents a registry of verified API breakages and scans a project for known traps in the package versions it uses.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: GetFootgun
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/GetFootgun/footgun
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/footgun

## What it does

Footgun provides an MCP registry of verified API pitfalls, including quiet deprecations, hidden limits, and settings that appear to save without taking effect. An agent can consult these findings while writing code. Each public entry includes symptoms, a cause, a fix, and the date it was last checked.

The Claude Code plugin adds `/footgun:scan`, which checks the project locally against known issues for its exact package versions. Your code stays on your machine; the service receives rule downloads and an anonymous findings count. The `auto_context` setting adds a brief note at the start of a session and is on by default.

Searching and submitting traps for review do not require an account. Confirming a trap does require an API key, so findings cannot be confirmed without one.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://getfootgun.com/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http footgun https://getfootgun.com/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add footgun --url https://getfootgun.com/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "footgun": {
            "url": "https://getfootgun.com/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "footgun": {
            "type": "http",
            "url": "https://getfootgun.com/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http footgun https://getfootgun.com/api/mcp
```

## When to use it
- scan a project for known API breakages
- match known issues to the package versions in use
- submit a newly found trap for review
- add known API pitfalls to session context

## Example prompts
- Run `/footgun:scan` to check this project for known API pitfalls.
- Check this code against issues affecting its current package versions.
- Add a short note about verified API traps to the start of the session.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md