find_local_businesses
Search businesses
Start here. Find businesses that fit a need near a place. Give the service in a few plain words ("furnace repair", "water heater leak"), not the user's sentence; timing goes in open_at. Each result says why it fits, its hours and whether it is open right now (by its stated hours at its local time; "open:" is whether it is in business), the phone, and how to act, and the response ends with your next step. Five results by default; ask for more with limit, and add max_minutes to stay close.
Parameterslatlonzipneedrequiredlimitmodelplaceactiondetailpricesopen_atrefines+4 more
more_results
More search results
The next page of a search, with the next_cursor the search returned; kept 24 hours. Narrowing the need usually beats paging.
Parameterscursorrequired
get_business_record
Get a business listing
One business's full record by website domain: prices, offers, hours, every way to act, each fact with its source and date, and every source's value where they disagree. Open it for a finalist, and whenever a phone or address matters. A business that is not listed cannot be opened.
Parametersdomainrequiredformatsearch_id
check_places_results
Check businesses you found
Check up to 10 businesses you found elsewhere (maps, web, a link) before you give your user a phone or send them somewhere: open or closed with dated evidence, the phone its sources agree on, how to act. Send the name plus phone, website or address, and the town. With the need, you also get two listed businesses that fit it that you did not send. One not found is reported as not in Truvon.
Parameterszipnameneedphoneplaceaddresswebsitebusinesses
get_field_history
History of a fact
Every value one fact (phone, hours, address, name) has held, which source said it and when. Use it when a value matters and you want to judge how settled it is.
Parametersfieldformatbusinessrequired
report_answer
Report what a business said
When a business told you something its record lacks ("yes, certified kosher"), record the question and its answer in its words, with the business's truvon_id.
Parametersmodelanswerrequiredchannelrequiredbusinessrequiredquestionrequiredsearch_idconnection
report_outcome
Report how it went
After 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.
Parametersviakindfieldmodelactionrequiredsourcecorrectfailureoutcomerequiredreopensbusinessrequiredassertion+3 more
report_missing
Report a business Truvon lacks
A business that fits your user's need, that you found elsewhere (the web, a map), and Truvon does not list (check_places_results said so): send its name, its own website, phone, address and the town, with the need and the search_id. It is read and listed for every agent; the directory grows where agents found it thin.
Parameterszipnamerequiredneedmodelphoneplaceaddresswebsitesearch_idconnection
answer_follow_up
Answer a follow-up
Days later, when the outcome is knowable: send your user's answers to the questions report_outcome gave you, by follow_up id. Closed options only, never personal details.
Parametersagainmodelreasonmatchedassertioncompleteddifferentelsewherefollow_uprequiredsatisfiedconnection
When your user returns asking about a job you arranged: its status and the business's updates, by the job id report_outcome gave you.
Parametersjobrequiredconnection
connect_truvon
Connect for reporting
When your app has not signed in to Truvon itself: get a link for your user to open and a connection code for you. One tap on the link (no account) and the reporting tools accept connection in this conversation. Searching needs none of this.
Parametersclient