set_shipping_address
ActiveTool of Kifly — Agentic Commerce & Payments
declared in 1.0.0
Requires `checkout:write` scope. Persist a shipping address on the cart and confirm whether the seller can deliver to it. **Call BEFORE `checkout`.** Returns `delivery_eligible: true/false`. When false, `delivery_coverage: { states, cities }` tells you exactly which US states and cities the seller covers — tell the buyer where coverage is available. When true, returns `cart_total_with_delivery_cents` so you can quote the full price (item subtotal + flat delivery fee) before sending the buyer to pay.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cart_id",
"shipping_address"
],
"properties": {
"cart_id": {
"type": "string",
"description": "Cart ID from create_cart"
},
"shipping_address": {
"type": "object",
"required": [
"name",
"line1",
"city",
"region",
"postal_code"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 150,
"minLength": 1,
"description": "Buyer's full name"
},
"line1": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Street address line 1"
},
"line2": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"description": "Street address line 2 (apt, suite)"
},
"phone": {
"anyOf": [
{
"type": "string",
"maxLength": 30
},
{
"type": "null"
}
],
"description": "Optional contact phone for delivery"
},
"region": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "US state code (e.g. 'CA', 'NE') — matched against seller's delivery_coverage.states"
},
"country": {
"type": "string",
"default": "US",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 country code"
},
"postal_code": {
"type": "string",
"maxLength": 20,
"minLength": 3,
"description": "Postal/ZIP code"
}
},
"description": "Structured shipping address collected conversationally from the buyer",
"additionalProperties": false
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Kifly — Agentic Commerce & Payments
1/7 registries