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.
输入参数latlonzipneed必填limitmodelplaceactiondetailpricesopen_atrefines另有 4 个
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.
输入参数cursor必填
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.
输入参数domain必填formatsearch_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.
输入参数zipnameneedphoneplaceaddresswebsitebusinesses
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.
输入参数fieldformatbusiness必填
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.
输入参数modelanswer必填channel必填business必填question必填search_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.
输入参数viakindfieldmodelaction必填sourcecorrectfailureoutcome必填reopensbusiness必填assertion另有 3 个
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.
输入参数zipname必填needmodelphoneplaceaddresswebsitesearch_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.
输入参数againmodelreasonmatchedassertioncompleteddifferentelsewherefollow_up必填satisfiedconnection
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.
输入参数job必填connection
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.
输入参数client
