Footgun — Claude Code MCP server: API checks and setup
Footgun gives coding agents a registry of verified API breakages and scans a project for known traps in the package versions it uses.
claude mcp add --transport http footgun https://getfootgun.com/api/mcpWhat Footgun 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.
What it helps with
- 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 for the agent
- Run
/footgun:scanto 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.
How to install Footgun
Platform CLI: remote server
claude mcp add --transport http footgun https://getfootgun.com/api/mcpPlatform CLI: remote server
codex mcp add footgun --url https://getfootgun.com/api/mcpConfig file
{
"mcpServers": {
"footgun": {
"url": "https://getfootgun.com/api/mcp"
}
}
}Config file
{
"servers": {
"footgun": {
"type": "http",
"url": "https://getfootgun.com/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http footgun https://getfootgun.com/api/mcpStep 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 Footgun
How do I install Footgun in Claude Code?
Run claude mcp add --transport http footgun https://getfootgun.com/api/mcp. To submit and confirm traps, add the Authorization: Bearer <your key> header.
What does Footgun do?
It gives an agent access to a registry of verified API problems and scans a project for known traps based on its package versions.
Does Footgun need an API key?
Searching and submitting traps for review work without an account. Confirming traps requires an API key.
