Get SITEBORNE quote
siteborne_get_quoteBuild a canonical x402 payment quote for one SITEBORNE service and exact request input. Use when: an agent needs the governed price, payee, network, asset, resource, expiry, and payment requirement before deciding whether to invoke a paid service. Do not use when: evidence work is required now (use the matching siteborne_build_company_evidence_graph, siteborne_retrieve_verified_web_context, siteborne_extract_document_evidence_json, or siteborne_verify_agent_output tool), or only availability is needed (use siteborne_get_service_health). Parameters: scheme must be the one scheme the service is offered under (company_evidence_graph.v2 exact, web_context_verified.v2 exact, document_evidence_json.v2 upto, verify_agent_output.v2 exact, company_evidence_graph.v3 exact, web_context_verified.v3 exact, document_evidence_json.v3 upto, verify_agent_output.v3 exact); any other scheme is rejected with scheme_not_offered. input is hashed, so the quote binds only that exact request. Behavior: quote-only and read-only; it hashes the proposed input, and does not execute the underlying paid service, verify payment, call a provider, create a Workflow, or settle. Economics: free of charge. The returned amount is the exact price, or for upto an authorized maximum whose actual_amount is null because the real charge is measured at settlement and never exceeds it. Failure: a mode that has a governed price but is unavailable returns retrieval_mode_unavailable or verification_mode_unavailable and no quote; a quote expires at expires_at. Returns: an expiring input-bound quote with its x402 payment requirement and the canonical economics block.
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": {
"service_id": "<service_id>",
"scheme": "<scheme>",
"input": "<input>"
},
"name": "siteborne_get_quote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | Complete proposed input for the selected service; its canonical hash binds the quote and later payment requirement to this exact request content. | |
| scheme | Yes | Pricing mode: exact fixes the required amount, while upto authorizes a maximum whose eventual charge cannot exceed the returned amount. | |
| service_id | Yes | Canonical SITEBORNE service and major version to price; selects that service’s governed pricing key, contract release, and production resource URL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset | Yes | Token contract address on the network that the amount is denominated in. | |
| payee | Yes | Public payTo address that receives the payment. | |
| amount | Yes | Amount in the asset atomic units (6 decimals for USDC): the exact price when amount_kind is exact, or the authorized maximum when it is authorized_maximum. | |
| scheme | Yes | x402 scheme: exact requires the amount; upto authorizes it as a maximum. | |
| network | Yes | CAIP-2 network the payment must be made on (for example eip155:8453). | |
| quote_id | Yes | Deterministic identifier of this quote. | |
| economics | Yes | The canonical economic contract for the quoted service (pricing model, tiers, authorization maximum, settlement model, modes and their availability, limits, production state, pricing_source_version, and network/asset/pay_to); identical on every SITEBORNE discovery surface. | |
| issued_at | Yes | UTC time the quote was issued. | |
| expires_at | Yes | UTC time after which the quote is no longer valid. | |
| input_hash | Yes | Canonical hash of the exact request input this quote binds. | |
| service_id | Yes | Canonical service id and major version that was quoted. | |
| amount_kind | Yes | exact: the charge equals amount. authorized_maximum: the charge is measured at settlement and never exceeds amount. | |
| pricing_key | Yes | Governed pricing key the amount was resolved from (governance pricing authority). | |
| resource_id | Yes | Canonical URL of the paid resource this quote is bound to. | |
| binding_hash | Yes | Hash binding the quote to the exact service, input hash, price, scheme, network, asset, and payee; a payment for a different binding is not accepted. | |
| actual_amount | Yes | Always null in a quote: the actual charge exists only after measured settlement. | |
| requirement_id | Yes | Identifier of the x402 payment requirement embedded in payment_requirements. | |
| service_version | Yes | Service contract major version. | |
| contract_release | Yes | Contract release the quoted service belongs to. | |
| payment_required | Yes | Always true: executing the quoted service requires payment. | |
| production_enabled | Yes | Quote-level flag, always false: a quote never authorizes execution. The service runtime state is economics.production_enabled. | |
| payment_requirements | Yes | The x402 payment requirement to satisfy, including payTo, network, asset and amount. | |
| pricing_source_version | Yes | Version of the governed pricing document that produced the amount; a repricing changes this value. |