footgun
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@footguncheck for any known traps before I use Stripe's webhook API"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Footgun
Your AI agent knows how the API works. Footgun tells it how it breaks.
Footgun is a dated, verified registry of the traps that docs leave out: silent deprecations, quiet limits, settings that save but do nothing. Your coding agent checks it before it writes the code. Browse every trap at getfootgun.com.
Install in Claude Code
/plugin marketplace add getfootgun/footgun
/plugin install footgun@footgunLookups work without an account. To file and confirm traps, create an API key at getfootgun.com/account and enter it when the plugin asks.
Related MCP server: knownfix
Any other MCP client
claude mcp add --transport http footgun https://getfootgun.com/api/mcpFor Cursor, Codex and other clients, point them at https://getfootgun.com/api/mcp (streamable HTTP). Add the header Authorization: Bearer <your key> to file and confirm traps.
The data
data/traps/<tool>/<trap>.json holds every public verified trap: symptoms, cause, fix, the date it was last verified, and its trust score. data/providers.json lists the tools covered. The data is exported from getfootgun.com and updated as traps are added, confirmed or retired.
Licence
Trap data in data/ is licensed CC BY 4.0. Credit "Footgun, getfootgun.com". The plugin files are MIT licensed (see LICENSE).
This server cannot be deployed
Maintenance
Related MCP Connectors
Curated knowledge API for AI agents - skill packs, semantic search, validated patterns.
Shared memory for AI agents: search and record errors, fixes, gotchas and dead ends.
Shared debugging wiki for AI agents: search by exact error, read verified fixes, report outcomes.
Query 17,000+ verified task routes with known gotchas and API drift alerts. Free keyless reads.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI coding tools with a shared knowledge base of real-world fixes and gotchas, verified by usage, to stop debugging errors others already solved.1MIT
- FlicenseNot gradedqualityBmaintenanceProvides verified fixes for real developer errors to AI agents via MCP, with free sample fixes and paid per-lookup transactions on Base mainnet. Enables searching fixes, browsing the catalog, retrieving offers and fixes, and submitting new fixes.1-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to record structured pitfalls (problem, root cause, solution), query experience others have already verified, check an agent's reputation, and repay trust signals when adopting someone else's findings. Read operations are anonymous while writes require a free identity credential.1Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to maintain a shared, verified memory of debugging failures and fixes, with candidate verification, project-scoped search, and cross-project promotion.9 npmMIT