request_price_match
Request a price-match review of a competitor's WRITTEN quote from a comparable licensed notary — it never sets our price automatically. Use when the customer found a cheaper offer. Requires: competitor_name, competitor_price_usd, service (e.g. office, mobile, apostille), name, and an email or phone. Returns a logged reference and, where computable, our comparable quote; the notary decides within one business day. Fails if the name or a valid contact is missing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"service": "<service>",
"competitor_name": "<competitor_name>",
"competitor_price_usd": "<competitor_price_usd>"
},
"name": "request_price_match"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The customer's name. | |
| No | Email — provide an email OR a phone so we can reach them. | ||
| notes | No | Anything else the notary should know. | |
| phone | No | Phone — provide an email OR a phone so we can reach them. | |
| service | Yes | Service: office | mobile | apostille | apostille_mail | loan. | |
| competitor_url | No | Link to the competitor's quote/page, if any (stored for the operator, never fetched). | |
| document_count | No | Number of documents, for our comparison quote. Default 1. | |
| competitor_name | Yes | The competitor's business name. | |
| competitor_price_usd | Yes | The competitor's quoted price, in US dollars. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| status | No | Account tools: the booking's status after this call (Pending after book_appointment). | |
| message | Yes | Customer-facing outcome; relay it as written — bookings are requests until the notary confirms. | |
| manageUrl | No | Guest requests: the emailed confirm/cancel link, when one was minted (null otherwise). | |
| onAccount | No | True when the request was filed on the signed-in customer's own account — they can then list it with my_bookings and change it with reschedule_booking / cancel_booking. Absent or false means a guest request, managed through the emailed link. | |
| reference | No | Request / order reference for check_request_status (guest tools) or my_bookings (account tools). | |
| appendedToExisting | No | True when existing_reference was given and the request was extended, not duplicated. | |
| ourComparableQuoteCents | No | request_price_match only, when computable. |