JuliusBrussee/caveman · error · Error

unknown tool: ${name}

Error message

unknown tool: ${name}

What it means

Error "unknown tool: ${name}" thrown in JuliusBrussee/caveman.

Source

Thrown at packages/cli/src/agent-mcp.ts:601

          client.request(`/api/v1/traces/${traceId}/spans${projectQuery}`),
        ]);
        value = { trace: metadataOnlyTrace(trace), spans: metadataOnlySpans(spans) };
        break;
      }
      case "caveman_experiment_get": {
        const action = stringArg(args, "action");
        if (!["list", "get", "results"].includes(action)) throw new Error(`unknown experiment read action: ${action}`);
        if (action === "list") {
          value = await client.request(await withProjectQuery(client, "/api/v1/experiments"));
          break;
        }
        const experimentId = encodeURIComponent(stringArg(args, "experiment_id"));
        const query = new URLSearchParams({ project_id: await client.projectId() });
        value = await client.request(`/api/v1/experiments/${experimentId}${action === "results" ? "/results" : ""}?${query}`);
        break;
      }
      default:
        throw new Error(`unknown tool: ${name}`);
    }
    return result(value);
  } catch (error) {
    outcome = "error";
    return errorResult(error);
  } finally {
    client.recordToolCall?.({ tool: name, result: outcome, durationMs: Date.now() - started });
  }
}

function rpcError(id: JSONValue | undefined, code: number, message: string): JSONObject {
  return { jsonrpc: "2.0", id: id ?? null, error: { code, message } };
}

async function handleMessage(
  client: AgentMcpClient,
  message: unknown,
  session: McpSessionState,

View on GitHub (pinned to 27d5a3981a)

Solutions

1. Call a tool that exists on this MCP server; check the tool list for valid names.

When it happens

Trigger: Thrown at packages/cli/src/agent-mcp.ts:601 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of JuliusBrussee/caveman@27d5a3981a (2026-08-15). Data as JSON: /api/errors/e2b9b38a117cf77b. Report an issue: GitHub.