Report
reportRecord outcomes, feedback, events or experience in this installation. Use mode 'note' with note to contribute a reusable summary; mode 'note_result' with note_result to report trying an existing note. These two modes require share:true: the summary is readable by others with access to this server (public on the hosted server). A local stdio installation does not upload it. Share only with user authorization; omit secrets and personal information. Other report modes retain their existing local storage and separate sharing consent behavior. For outcome mode, provider_request_id makes the record traceable in the provider's own logs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | [feedback] Your feedback in detail. Write freely. | |
| mode | No | Explicit mode selection. Auto-detected from params if omitted: success → outcome, question_id → voice, event_type → event, subject+body → feedback. | |
| note | No | [note] Authorized summary to share in this server's field-note store. Use a fresh session UUID per execution and stable request UUID for retries. Optional read_note_ids: up to 5 ids of existing notes you read before solving. service_id may also be a tool id (git, powershell, node, npm, python, docker, curl, windows). | |
| title | No | [event] Short event title (e.g., 'freee API v3 deprecation'). | |
| context | No | [outcome] Additional context about the usage (PII will be auto-masked). | |
| note_id | No | [outcome] Field-note ID this report belongs to (format AWT-000). Stored as null if the format does not match. | |
| subject | No | [feedback] Short summary of your feedback (1 line). | |
| success | No | [outcome] Whether the operation succeeded. | |
| agent_id | No | Your agent identifier (optional, for follow-up). Used in feedback and voice modes. | |
| cost_usd | No | [outcome] Actual cost in USD (estimated from tokens if omitted). | |
| is_retry | No | [outcome] Whether this is a retry of a previously failed call. | |
| priority | No | [feedback] How important: low, normal, high, critical. Default: normal. | |
| recipe_id | No | [outcome] Recipe used for this attempt. | |
| task_type | No | [outcome] Operation performed (e.g., 'create_invoice', 'search_contacts'). | |
| agent_type | No | Agent platform type (claude, gpt, gemini, copilot, llama, deepseek, other). Used in outcome mode (auto-inferred from model_name if omitted) and voice mode. | |
| attempt_id | No | [outcome] attempt_id returned by lookup. | |
| confidence | No | [voice] How confident are you in this assessment? high, medium, low. | |
| error_type | No | [outcome] Error category if failed (e.g., 'auth_error', 'timeout', 'rate_limit', 'schema_mismatch'). | |
| event_date | No | [event] When the event occurred or takes effect (YYYY-MM-DD). | |
| event_type | No | [event] Category: api_change, api_deprecation, law_amendment, pricing_change, outage, security_incident, feature_launch, competitor_move, mcp_update, other. | |
| latency_ms | No | [outcome] Response time in milliseconds. | |
| model_name | No | [outcome] LLM model used (e.g., 'claude-sonnet-4', 'gpt-4o'). | |
| service_id | No | Service ID. Required for outcome and voice modes. Optional for feedback and event. | |
| session_id | No | [outcome] Optional. A UUID you generate once and reuse for every report during one task, so reports from the same task count as one agent (only a salted hash is stored, never this value). Anything that is not a UUID is ignored. | |
| workaround | No | [outcome] How you resolved the issue, if any. Helps future agents. | |
| description | No | [event] Details about the event and expected impact. | |
| failed_step | No | [outcome] Step identifier where execution stopped. | |
| note_result | No | [note_result] Actual result of trying a note. Includes note_id, service_id, outcome, conditions and evidence. | |
| question_id | No | [voice] Which question to answer: selection_criteria, would_recommend, biggest_frustration, best_feature, switching_likelihood, auth_experience, doc_quality, error_handling, compared_to_competitor, mcp_readiness, free_voice. | |
| input_tokens | No | [outcome] Input/prompt token count. | |
| feedback_type | No | [feedback] Type of feedback: suggestion, missing_data, correction, feature_request, workaround_tip, bug_report, praise, other. | |
| output_tokens | No | [outcome] Output/completion token count. | |
| response_text | No | [voice] Your honest answer in your own words. | |
| recipe_version | No | [outcome] Recipe version returned by lookup. | |
| estimated_users | No | [outcome] Approximate number of end-users your agent serves. | |
| impact_expected | No | [event] Expected impact: positive, negative, neutral, unknown. | |
| response_choice | No | [voice] Quick rating where applicable (e.g., 'strongly_yes', 'excellent', 'ready'). | |
| provider_error_code | No | [outcome] Provider's error code string (e.g. expired_access_token) or an RFC 9457 problem type URI (https://…, max 200 chars). Stored as null if the format does not match. | |
| provider_request_id | No | [outcome] Request or error ID the provider returned (e.g. from an x-request-id header). If present and well-formed, the record becomes traceable in the provider's own logs. Stored as null if the format does not match. | |
| provider_request_id_source | No | [outcome] Where the provider request ID came from: 'header:<name>' (e.g. header:x-request-id) or 'body:<field>' (e.g. body:id). |