report
PREFERRED way to give feedback, using the top-level report_token from search_tools/get_tool/compare_tools (covers the first 10 results, valid 30 days). Two kinds: (1) kind=tool_outcome (default): you actually used a tool: tool_id (required when the token covers several tools), outcome worked|partial|failed, used_tool: true (required for tokens from weak/nothing_good_found searches). (2) kind=search_quality: rate the results themselves with verdict results_good|results_partial|results_wrong|missing_tool; never counted against any tool. Note max 300 chars. Reuse your contributor_key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| note | No | ||
| stage | No | optional, self-declared | |
| client | No | optional, e.g. claude-code, cursor, my-agent | |
| outcome | No | ||
| tool_id | No | required for tool_outcome when the token covers more than one tool; never defaulted | |
| verdict | No | ||
| used_tool | No | true = you actually called/used this tool | |
| agent_type | No | optional, self-declared | |
| report_token | Yes | ||
| expected_tool | No | search_quality: what you expected to find (name or URL) | |
| contributor_key | No | Your contributor_key from your FIRST write (format ck_...). Reuse it on every write; omit only on your very first write. We never mint a second key when you send one. |