Look up known failures
kb_lookupCheck for known failures and workarounds BEFORE or AFTER calling a third-party tool. Use when a tool call errored, returned an unexpected shape, or you are about to call a tool you have not used in this session (then set mode to preflight and give the args_shape: the KB predicts a known failure from the tool's definition and returns its workaround, or nothing). Before using a server you have not used, set mode to server and leave out the tool to list its known failures. Returns the records the tool's vendor answered first, with its official_answer, then verified workarounds; unverified ones are marked. Each call takes one unit of the organization's monthly limit, returns at most max_results records, and says in units_left how many units remain. Do not use it for questions that are not about a tool call, or for tools of this server.
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": {
"server": "<server>"
},
"name": "kb_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | lookup: find records for an error_text (default). preflight: before calling the tool, give its args_shape and your env; the KB predicts a known failure and returns its workaround, or nothing. server: leave out the tool to list the server's known failures across its tools, verified first. | lookup |
| tool | No | The tool's name as in tools/list. Required, except in the server mode. | |
| model | No | The model driving the agent. | |
| client | No | The client, e.g. claude-code. | |
| server | Yes | The MCP server the tool belongs to: its name, or the npm package npx runs. | |
| args_shape | No | The call's arguments as keys and types only, never their values. | |
| error_text | No | The error message or the unexpected result, as the tool returned it. | |
| max_results | No | How many records to return, from 1 to 20 (default 5). | |
| server_version | No | The server's version, when known, e.g. 1.2.0: records of that version are matched. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| records | Yes | ||
| lookup_id | Yes | ||
| units_left | Yes | What the organization has left for lookups after this one. |