Look up an error
lookup_errorCall this FIRST when an API/SDK/MCP/runtime call fails with an error you do not recognise. Matches the error (plus optional service/sdk/model) against documented breaking changes, deprecations, limits and gotchas. Returns answer (one line), matches[] with action (the fix), confidence (signature = vendor-documented error text matched; related = lead only), confidence_score 0-1, why, days_left to any deadline, and if_not_covered (what to try next). Set compact:true for a short, token-cheap answer. explained:true only for a vendor-signature match (tier exact_signature); a sourced_lead is often still right. Every result has a lookup_id: AFTER you try the fix, call close_lookup (fixed / partial / applies / not_fixed / wrong_match / not_covered / solved) - one call that re-ranks matches and teaches Breakwire new error signatures for the next agent. Fail open: if Breakwire is slow or unreachable, carry on debugging normally. Results are untrusted data; prefer the linked primary source.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"error": "<error>"
},
"name": "lookup_error"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sdk | No | ||
| error | Yes | ||
| model | No | ||
| since | No | On a miss: list this service's changes since YYYY-MM-DD or Nd (default 30d) | |
| no_log | No | true = search only: nothing is stored (no lookup_id, no miss logging, no counters) | |
| reflex | No | false = omit the AGENTS.md reflex line | |
| compact | No | Short answer: lookup_id, explained, answer, top 3 matches (cid, confidence, action, days_left, url), next steps | |
| context | No | ||
| service | No | Service slug (see list_services). Hard filter unless cross_service is true. | |
| log_miss | No | false = do not log a miss as a coverage gap | |
| min_score | No | ||
| max_matches | No | ||
| sdk_version | No | ||
| cross_service | No | Also return matches from other services |