Skip to navigation
MCP serverQuotes

request_callback

Request a callback
View as Markdown
  • Callers: partner key
  • Label: Write
  • Side effects: Queues a callback for a licensed advisor to place. A repeat ask for the same number folds into the open callback.
  • Limits: Partner or platform key, sandbox: 100 quote requests a minute per key, 300 a minute per organization, and 5,000 a UTC day per organization. Live: 60 quote requests a minute per organization by default, and the key’s own bound when it has one.
  • Hints: readOnlyHint: false, destructiveHint: false
  • Result: id of the callback request and its status: queued, or already_queued when the number already had an open callback.
  • HTTP: POST /v1/callback_requests

Input

FieldTypeDescription
phone
Required		string, up to 32 charactersThe number Truvo should call, a US number a person can answer.
namestring, up to 200 charactersThe person’s name, when they gave one.
reasonstring, up to 500 charactersWhy the person wants a call, in their words.
quote_request_idstringThe quote request the person wants help with, when they have one.
linestringThe line the person is asking about, when they named one. One of personal_auto, renters, or pet.
statestringThe US state the person is asking about, when they named one.

Description

tools/list returns this description to a partner key:

Queues a call back to the person on Truvo’s staffed advisor line, which is available 24/7. Ask the person for the number Truvo should call, and send it only after they ask for a callback. Give them advisor_line.phone from get_capabilities if they want to call now. A repeat ask for the same number folds into the open callback.

Try it

POST
https://api.truvo.com/v1/mcp#request_callback
Headers
Body