Report how it went
report_outcomeAfter you have acted for your user (booked, ordered, called, got a quote): say what happened, with the search_id and the business's truvon_id. If something was arranged you get the questions to ask your user later and, for a job, a job id. Test traffic (x-truvon-test) is refused: dry-run at https://sandbox.truvon.ai/mcp.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| via | No | How you acted: a Truvon door, the business's own agent endpoint, a platform (a booking or ordering service), its link, its phone, its email | |
| kind | No | With business_closed: closed for good, or temporarily (renovation, vacation, season) | |
| field | No | With wrong_information: which fact is wrong | |
| model | No | Optional: the model you run on (for example claude-sonnet-5-5 or gpt-5.5), kept with this report's provenance so what each model reports can be weighed over time. Leave it out if you do not know. | |
| action | Yes | What you did for your user | |
| source | No | With business_closed: the link where you saw it (a news story, its own post, a listing marked closed). It is checked and archived, and if it says so the business is closed for every agent. | |
| correct | No | With wrong_information: the right value, as you found it | |
| failure | No | When failed. business_closed: the business has closed (say what you saw in detail: a closed sign, a disconnected phone, a recording) | |
| outcome | Yes | confirmed: the business confirmed; pending: submitted, awaiting the business; handed_off: you gave your user the link or number and they finish it (never counts against the business; the follow-up asks whether it happened); failed: give failure | |
| reopens | No | With a temporary closure: the reopening date it states, YYYY-MM-DD | |
| business | Yes | The truvon_id from a result (biz_…) or the business's website domain. Never a name. A business Truvon does not list cannot be reported | |
| assertion | No | Platforms only: your Truvon agent assertion (identity protocol §4, a JWS binding this report to your user's pairwise sub). Accepted only when this MCP request carries an OAuth DPoP access token; see /.well-known/truvon-agent-auth. | |
| search_id | No | The search_id from find_local_businesses, so the outcome teaches similar future needs | |
| connection | No | The connection code connect_truvon gave you, once your user approved its link. Not needed when your app signed in to Truvon itself. | |
| expected_at | No | ISO time when the outcome will be knowable: delivery ETA or appointment time |