Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
4 shown · authentication unknown
Confirm or dispute a trap
confirm_trap
After you hit or avoid a trap returned by lookup_traps or search_traps, record whether it is still true. Confirmations raise a trap's trust score and disputes lower it; several disputes send it back for review. One vote per trap per 30 days. Needs a free API key.
Schema valid · SHA-256 9cedcef33ede…
View input schema
{
"type": "object",
"properties": {
"trap_id": {
"type": "string",
"description": "The trap id from a lookup or search result, e.g. \"fg-0158\"."
},
"still_true": {
"type": "boolean",
"description": "true if the trap happened as described, false if it no longer happens."
},
"hours_lost": {
"description": "Optional hours the trap cost before the fix was found.",
"type": "number"
},
"version_seen": {
"description": "Optional SDK, API or tool version where you saw it, e.g. \"stripe-node 22.3.0\".",
"type": "string"
}
},
"required": [
"trap_id",
"still_true"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
File a new trap
file_trap
Draft a trap after a failure was fixed. Private by default with a Pro or Team key. Public filings are checked automatically against official sources and published only when an official source confirms them. A reviewer can still act on any filing. Citing the provider's official documentation or changelog in sources helps. No API key needed. Set visibility to public to submit to the public registry.
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"maxLength": 64,
"description": "The service, by slug or common name, e.g. \"stripe\"."
},
"surface_type": {
"type": "string",
"enum": [
"api",
"sdk",
"ui",
"billing",
"infra",
"tool"
],
"description": "Which kind of surface broke: api, sdk, ui, billing, infra, or tool (CLIs and AI coding tools)."
},
"surface_name": {
"type": "string",
"maxLength": 200,
"description": "The specific endpoint, package, command or screen, e.g. \"webhooks.constructEvent\"."
},
"title": {
"type": "string",
"minLength": 10,
"maxLength": 140,
"description": "One line naming what goes wrong, as a developer would search for it."
},
"symptoms": {
"minItems": 1,
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"description": "Exact error messages or observed behavior, one per item. Leave out secrets and personal data."
},
"cause": {
"type": "string",
"maxLength": 1000,
"description": "Why it happens."
},
"fix": {
"type": "string",
"maxLength": 2000,
"description": "What to change, in plain words."
},
"apply": {
"type": "string",
"maxLength": 4000,
"description": "A short code or command example of the fix."
},
"affected": {
"type": "string",
"maxLength": 300,
"description": "Which versions, plans or dates are affected."
},
"sources": {
"default": [],
"description": "Official documentation or changelog URLs that confirm it.",
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"maxLength": 500
}
},
"tags": {
"description": "Optional short keywords.",
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"maxLength": 40
}
},
"visibility": {
"description": "public submits to the shared registry; private keeps it in your team's space (Pro or Team key).",
"type": "string",
"enum": [
"private",
"public"
]
}
},
"required": [
"provider",
"surface_type",
"surface_name",
"title",
"symptoms",
"cause",
"fix",
"apply",
"affected"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Look up traps for a provider
lookup_traps
Call before writing code against a third-party API, platform, or AI tool. Returns up to 10 verified, dated failure modes for that provider, each with symptoms, cause, fix, a code example and the date it was last checked. Use search_traps instead when you already have an error message.
Schema valid · SHA-256 2196f8eba220…
View input schema
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"description": "The service, by slug or common name, e.g. \"stripe\", \"supabase\", \"github-actions\", \"openai api\"."
},
"surface": {
"description": "Optional part of the service you are working on, e.g. \"webhooks\" or \"image generation\". Ranks matching traps first; never filters others out.",
"type": "string"
},
"context": {
"description": "Optional one-line description of the task, e.g. \"verify webhook signatures in Next.js\". Ranks the most relevant traps first.",
"type": "string"
},
"include_stale": {
"description": "Also return traps not re-checked recently. Default false.",
"type": "boolean"
}
},
"required": [
"provider"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Search traps by error text
search_traps
Call when a call to a third-party service fails or behaves unexpectedly. Paste the error text. Returns up to 5 verified traps whose symptoms match it, closest first, each with cause and fix. Returns nothing when no trap matches closely. Use lookup_traps instead before writing code.
Schema valid · SHA-256 a4380273c207…
View input schema
{
"type": "object",
"properties": {
"error_text": {
"type": "string",
"minLength": 4,
"maxLength": 4000,
"description": "The error message or unexpected output, as shown. Known key and secret formats are redacted before matching."
},
"provider": {
"description": "Optional service slug or name to search within, e.g. \"stripe\". Omit to search every provider.",
"type": "string"
},
"include_stale": {
"description": "Also match traps not re-checked recently. Default false.",
"type": "boolean"
}
},
"required": [
"error_text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}