Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "footgun": {
      "type": "http",
      "url": "https://getfootgun.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FOOTGUN_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http footgun https://getfootgun.com/api/mcp --header "Authorization: Bearer ${FOOTGUN_TOKEN}"

[mcp_servers.footgun]
url = "https://getfootgun.com/api/mcp"
bearer_token_env_var = "FOOTGUN_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "footgun": {
      "type": "remote",
      "url": "https://getfootgun.com/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:FOOTGUN_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "footgun": {
      "type": "http",
      "url": "https://getfootgun.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FOOTGUN_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=footgun&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZ2V0Zm9vdGd1bi5jb20vYXBpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0ZPT1RHVU5fVE9LRU59In19"
}

{
  "servers": {
    "footgun": {
      "type": "http",
      "url": "https://getfootgun.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FOOTGUN_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "footgun": {
      "httpUrl": "https://getfootgun.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FOOTGUN_TOKEN}"
      }
    }
  }
}

extensions:
  "footgun":
    enabled: true
    name: "footgun"
    type: streamable_http
    uri: "https://getfootgun.com/api/mcp"
    headers:
      "Authorization": "Bearer ${FOOTGUN_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${FOOTGUN_TOKEN}. The registry never accepts secret values.

Quality 87 / 100new

protocol88 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
warn
protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations4 of 4 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: file_trap (idempotentHint, openWorldHint); lookup_traps (destructiveHint); search_traps (destructiveHint); …
pass
tools.token_costabout 684 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool history recorded for 0 of the 7 days needed

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

4 tools, about 684 tokens to load them all · tool set a9192ae53358 · tools last changed 2026-10-20 · checked 2026-10-20 16:30 UTC

Tool changes

2026-10-20file_trapchangeddescription, input schema
before
Draft a trap after a failure was fixed. A person reviews every filed trap before it is published; citing the provider's official documentation or changelog in sources helps. Needs an API key.
after · 57% of words in common
Draft a trap after a failure was fixed. Private by default with a Pro or Team key; public filings enter the review queue. A public trap is reviewed by a person before it is published; citing the provider's official documentation or changelog in sources helps. Needs an API key. Set visibility to public to submit to the public registry.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 100 / 100

provenance100

liveness100

freshness100

hygiene100

+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-100% +updated-1d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://getfootgun.com/api/mcp` streamable-http	none	yes	100%	276 ms	2026-07-28	2026-10-20

Tools (4)

`confirm_trap`	Record that a trap is still true (or not), with optional hours lost and version seen. Needs an API key.
`file_trap`	Draft a trap after a failure was fixed. Private by default with a Pro or Team key; public filings enter the review queue. A public trap is reviewed by a person before it is published; citing the provider's official documentation or changelog in sources helps. Needs an API key. Set visibility to public to submit to the public registry.
`lookup_traps`read-only	Call before writing code against a third-party API, platform, or AI tool. Returns verified, dated failure modes with fixes.
`search_traps`read-only	Call when a call to a third-party service fails. Paste the error text. Returns the closest verified traps with fixes.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "com.getfootgun/footgun",
  "title": "Footgun",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://getfootgun.com/api/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional. Bearer API key, only needed to file or confirm traps."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/GetFootgun/footgun",
    "source": "github"
  },
  "websiteUrl": "https://getfootgun.com",
  "description": "Dated, verified fixes for how APIs and AI coding tools break, served to your agent before it codes."
}