Skip to main content
Glama

Tanatasa Beauty

create_checkout

Idempotent

Lock the quoted cart for purchase. Send the quote's version, its total as expected_total, a new idempotency_key and details (the buyer's name, email, phone and Singapore address; collect them first). coupon_code applies a code. Returns checkout_id, details_version, buyer_summary and a review link, valid 24 hours. Does not charge anything. Next: show the buyer buyer_summary, then prepare_payment.

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": {
      "cart_id": "<cart_id>",
      "version": "<version>",
      "expected_total": "<expected_total>",
      "idempotency_key": "<idempotency_key>"
    },
    "name": "create_checkout"
  }
}

Input Schema

NameRequiredDescriptionDefault
cart_idYescart_id from create_cart.
detailsNoOptional: the buyer's contact and Singapore delivery details, saved with the checkout (details_version 1) instead of a separate set_checkout_details call. The buyer still confirms them and the total before prepare_payment.
versionYesThe version from the quote_cart result you are checking out.
use_creditNoUse the signed-in customer's cashback credit (default true).
coupon_codeNoA coupon code or a friend's referral code to apply; null removes both. quote_cart previews it; create_checkout applies it.
guest_tokenNoPrivate guest session token from create_cart. Retain for cart, checkout and purchase-status calls; no account login needed.
account_tokenNoPrivate account token from sign_in, after the customer gave you the code from their email. Lets quotes and checkout use their cashback credit, and opens their orders.
expected_totalYesThe total from that quote, in SGD cents. Checkout refuses if the total changed.
idempotency_keyYesA new random key per purchase. Retry with the same key and exact input; never reuse it for a different purchase.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "anyOf": [
      -    {
      -      "$schema": "http://json-schema.org/draft-07/schema#",
      -      "additionalProperties": true,
      -      "properties": {
      -        "buyer_details": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": true,
      -              "properties": {
      -                "contact": {
      -                  "additionalProperties": true,
      -                  "properties": {
      -                    "email": {
      -                      "type": "string"
      -                    },
      -                    "name": {
      -                      "type": "string"
      -                    },
      -                    "phone": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "name",
      -                    "email",
      -                    "phone"
      -                  ],
      -                  "type": "object"
      -                },
      -                "delivery": {
      -                  "additionalProperties": true,
      -                  "properties": {
      -                    "address_line1": {
      -                      "type": "string"
      -                    },
      -                    "postal_code": {
      -                      "type": "string"
      -                    },
      -                    "unit_number": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "address_line1",
      -                    "postal_code"
      -                  ],
      -                  "type": "object"
      -                }
      -              },
      -              "required": [
      -                "contact",
      -                "delivery"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "buyer_summary": {
      -          "type": "string"
      -        },
      -        "cart_url": {
      -          "anyOf": [
      -            {
      -              "format": "uri",
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "checkout_id": {
      -          "type": "string"
      -        },
      -        "checkout_status": {
      -          "enum": [
      -            "cancelled",
      -            "confirmed",
      -            "cart_changed",
      -            "payment_pending",
      -            "ready_for_payment",
      -            "details_required"
      -          ],
      -          "type": "string"
      -        },
      -        "checkout_url": {
      -          "anyOf": [
      -            {
      -              "format": "uri",
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "confirmation_url": {
      -          "anyOf": [
      -            {
      -              "format": "uri",
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "currency": {
      -          "const": "SGD",
      -          "type": "string"
      -        },
      -        "details_version": {
      -          "type": "integer"
      -        },
      -        "expires_at": {
      -          "format": "date-time",
      -          "type": "string"
      -        },
      -        "handoff_options": {
      -          "items": {
      -            "additionalProperties": true,
      -            "properties": {
      -              "available": {
      -                "type": "boolean"
      -              },
      -              "buyer_action": {
      -                "type": "string"
      -              },
      -              "path": {
      -                "type": "string"
      -              },
      -              "reason": {
      -                "type": "string"
      -              },
      -              "url": {
      -                "anyOf": [
      -                  {
      -                    "format": "uri",
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              }
      -            },
      -            "required": [
      -              "path",
      -              "available"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "money_unit": {
      -          "const": "cents",
      -          "type": "string"
      -        },
      -        "next_action": {
      -          "type": "string"
      -        },
      -        "order_id": {
      -          "type": "string"
      -        },
      -        "payment_confirmed": {
      -          "type": "boolean"
      -        },
      -        "payment_status": {
      -          "type": "string"
      -        },
      -        "payment_url": {
      -          "anyOf": [
      -            {
      -              "format": "uri",
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "payment_url_expires_at": {
      -          "anyOf": [
      -            {
      -              "format": "date-time",
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "total": {
      -          "description": "Integer SGD cents; 1690 means S$16.90.",
      -          "minimum": 0,
      -          "type": "integer"
      -        }
      -      },
      -      "required": [
      -        "currency",
      -        "money_unit",
      -        "checkout_id",
      -        "order_id",
      -        "checkout_url",
      -        "cart_url",
      -        "details_version",
      -        "checkout_status",
      -        "payment_url",
      -        "payment_url_expires_at",
      -        "payment_confirmed",
      -        "confirmation_url",
      -        "expires_at",
      -        "total",
      -        "payment_status",
      -        "buyer_summary",
      -        "next_action",
      -        "buyer_details",
      -        "handoff_options"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": true,
      -      "properties": {
      -        "error": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "code": {
      -              "type": "string"
      -            },
      -            "message": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "message"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "error"
      -      ],
      -      "type": "object"
      -    }
      -  ],
      -  "type": "object"
      -}New value: +null
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "$schema": "http://json-schema.org/draft-07/schema#",
      +      "additionalProperties": true,
      +      "properties": {
      +        "buyer_details": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": true,
      +              "properties": {
      +                "contact": {
      +                  "additionalProperties": true,
      +                  "properties": {
      +                    "email": {
      +                      "type": "string"
      +                    },
      +                    "name": {
      +                      "type": "string"
      +                    },
      +                    "phone": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "name",
      +                    "email",
      +                    "phone"
      +                  ],
      +                  "type": "object"
      +                },
      +                "delivery": {
      +                  "additionalProperties": true,
      +                  "properties": {
      +                    "address_line1": {
      +                      "type": "string"
      +                    },
      +                    "postal_code": {
      +                      "type": "string"
      +                    },
      +                    "unit_number": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "address_line1",
      +                    "postal_code"
      +                  ],
      +                  "type": "object"
      +                }
      +              },
      +              "required": [
      +                "contact",
      +                "delivery"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "buyer_summary": {
      +          "type": "string"
      +        },
      +        "cart_url": {
      +          "anyOf": [
      +            {
      +              "format": "uri",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "checkout_id": {
      +          "type": "string"
      +        },
      +        "checkout_status": {
      +          "enum": [
      +            "cancelled",
      +            "confirmed",
      +            "cart_changed",
      +            "payment_pending",
      +            "ready_for_payment",
      +            "details_required"
      +          ],
      +          "type": "string"
      +        },
      +        "checkout_url": {
      +          "anyOf": [
      +            {
      +              "format": "uri",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "confirmation_url": {
      +          "anyOf": [
      +            {
      +              "format": "uri",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "currency": {
      +          "const": "SGD",
      +          "type": "string"
      +        },
      +        "details_version": {
      +          "type": "integer"
      +        },
      +        "expires_at": {
      +          "format": "date-time",
      +          "type": "string"
      +        },
      +        "handoff_options": {
      +          "items": {
      +            "additionalProperties": true,
      +            "properties": {
      +              "available": {
      +                "type": "boolean"
      +              },
      +              "buyer_action": {
      +                "type": "string"
      +              },
      +              "path": {
      +                "type": "string"
      +              },
      +              "reason": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "anyOf": [
      +                  {
      +                    "format": "uri",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              }
      +            },
      +            "required": [
      +              "path",
      +              "available"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "money_unit": {
      +          "const": "cents",
      +          "type": "string"
      +        },
      +        "next_action": {
      +          "type": "string"
      +        },
      +        "order_id": {
      +          "type": "string"
      +        },
      +        "payment_confirmed": {
      +          "type": "boolean"
      +        },
      +        "payment_status": {
      +          "type": "string"
      +        },
      +        "payment_url": {
      +          "anyOf": [
      +            {
      +              "format": "uri",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "payment_url_expires_at": {
      +          "anyOf": [
      +            {
      +              "format": "date-time",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "total": {
      +          "description": "Integer SGD cents; 1690 means S$16.90.",
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "currency",
      +        "money_unit",
      +        "checkout_id",
      +        "order_id",
      +        "checkout_url",
      +        "cart_url",
      +        "details_version",
      +        "checkout_status",
      +        "payment_url",
      +        "payment_url_expires_at",
      +        "payment_confirmed",
      +        "confirmation_url",
      +        "expires_at",
      +        "total",
      +        "payment_status",
      +        "buyer_summary",
      +        "next_action",
      +        "buyer_details",
      +        "handoff_options"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": true,
      +      "properties": {
      +        "error": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "code": {
      +              "type": "string"
      +            },
      +            "message": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "code",
      +            "message"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  3. Changed9 schema fields changed
    • addedInput schema / properties / details / properties / contact / description
      Added value: +"The buyer's name, email and phone."
    • addedInput schema / properties / details / properties / delivery / properties / address_line1 / description
      Added value: +"Block/house number and street, e.g. \"123 Tampines Street 11\"."
    • addedInput schema / properties / details / properties / delivery / properties / address_line2 / description
      Added value: +"Optional building or estate name."
    • addedInput schema / properties / details / properties / delivery / properties / city / description
      Added value: +"Defaults to Singapore."
    • addedInput schema / properties / details / properties / delivery / properties / country / description
      Added value: +"Defaults to SG; Singapore delivery only."
    • changedInput schema / properties / details / properties / delivery / properties / no_unit_number / description
      Previous value: -"true for a landed house or other address with no unit number."New value: +"Set true only for a landed house or other address with no unit number."
    • addedInput schema / properties / details / properties / delivery / properties / recipient_name / description
      Added value: +"Defaults to contact.name."
    • addedInput schema / properties / details / properties / delivery / properties / recipient_phone / description
      Added value: +"Defaults to contact.phone."
    • changedInput schema / properties / details / properties / delivery / required
      Previous value: -[
      -  "recipient_name",
      -  "recipient_phone",
      -  "address_line1",
      -  "no_unit_number",
      -  "postal_code",
      -  "country"
      -]New value: +[
      +  "address_line1",
      +  "postal_code"
      +]
  4. Changed1 schema field changed
    • addedInput schema / properties / details
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Optional: the buyer's contact and Singapore delivery details, saved with the checkout (details_version 1) instead of a separate set_checkout_details call. The buyer still confirms them and the total before prepare_payment.",
      +  "properties": {
      +    "contact": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "email": {
      +          "maxLength": 254,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "name": {
      +          "maxLength": 100,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "phone": {
      +          "maxLength": 32,
      +          "minLength": 1,
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "email",
      +        "phone"
      +      ],
      +      "type": "object"
      +    },
      +    "delivery": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "address_line1": {
      +          "maxLength": 200,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "address_line2": {
      +          "maxLength": 200,
      +          "type": "string"
      +        },
      +        "city": {
      +          "maxLength": 100,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "country": {
      +          "const": "SG",
      +          "type": "string"
      +        },
      +        "no_unit_number": {
      +          "description": "true for a landed house or other address with no unit number.",
      +          "type": "boolean"
      +        },
      +        "postal_code": {
      +          "description": "The 6-digit Singapore postal code.",
      +          "maxLength": 6,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "recipient_name": {
      +          "maxLength": 100,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "recipient_phone": {
      +          "maxLength": 32,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "unit_number": {
      +          "description": "e.g. #12-34. Required unless no_unit_number is true.",
      +          "maxLength": 30,
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "recipient_name",
      +        "recipient_phone",
      +        "address_line1",
      +        "no_unit_number",
      +        "postal_code",
      +        "country"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "contact",
      +    "delivery"
      +  ],
      +  "type": "object"
      +}
  5. Changed5 schema fields changed
    • changedInput schema / properties / account_token / description
      Previous value: -"Private account token from sign_in, after the customer gave you the code from their email. Lets quotes and checkout use their cashback credit."New value: +"Private account token from sign_in, after the customer gave you the code from their email. Lets quotes and checkout use their cashback credit, and opens their orders."
    • addedInput schema / properties / cart_id / description
      Added value: +"cart_id from create_cart."
    • addedInput schema / properties / expected_total / description
      Added value: +"The total from that quote, in SGD cents. Checkout refuses if the total changed."
    • addedInput schema / properties / idempotency_key / description
      Added value: +"A new random key per purchase. Retry with the same key and exact input; never reuse it for a different purchase."
    • addedInput schema / properties / version / description
      Added value: +"The version from the quote_cart result you are checking out."
  6. Changed2 schema fields changed
    • changedInput schema / properties / account_token / description
      Previous value: -"Private account token from verify_login_code, after the customer gave you the code from their email. Lets quotes and checkout use their cashback credit."New value: +"Private account token from sign_in, after the customer gave you the code from their email. Lets quotes and checkout use their cashback credit."
    • addedInput schema / properties / coupon_code
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 64,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "A coupon code or a friend's referral code to apply; null removes both. quote_cart previews it; create_checkout applies it."
      +}
  7. Changed2 schema fields changed
    • addedInput schema / properties / account_token
      Added value: +{
      +  "description": "Private account token from verify_login_code, after the customer gave you the code from their email. Lets quotes and checkout use their cashback credit.",
      +  "pattern": "^tak_[a-f0-9]{64}$",
      +  "type": "string"
      +}
    • addedInput schema / properties / use_credit
      Added value: +{
      +  "description": "Use the signed-in customer's cashback credit (default true).",
      +  "type": "boolean"
      +}
  8. Changed1 schema field changed
    • addedInput schema / properties / guest_token
      Added value: +{
      +  "description": "Private guest session token from create_cart. Retain for cart, checkout and purchase-status calls; no account login needed.",
      +  "pattern": "^[a-f0-9]{64}$",
      +  "type": "string"
      +}
  9. Changed1 schema field changed
    • removedInput schema / properties / guest_token
      Removed value: -{
      -  "description": "Private guest session token from create_cart. Retain for cart, checkout and purchase-status calls; no account login needed.",
      -  "pattern": "^[a-f0-9]{64}$",
      -  "type": "string"
      -}
  10. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations (which only declare non-readOnly, idempotent, non-destructive, open-world): it discloses that checkout refuses if the total changed, that the review link is valid 24 hours, that nothing is charged, and that the idempotency key must be reused only on retry of the same purchase. These are exactly the operational facts an agent needs and none are in the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the action, then requirements, then return values, then the explicit next step. The telegraphic style is dense but every clause carries a distinct operational fact; nothing is restated from the schema gratuitously.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter mutation with nested objects and no output schema, the description compensates by naming the return fields (checkout_id, details_version, buyer_summary, review link) and their 24-hour validity. Combined with full schema coverage, an agent has everything needed to call this correctly and hand off to prepare_payment.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, so the baseline is 3; the description adds real signal by pinning expected_total to "that quote's total" and framing coupon_code as apply-here/preview-in-quote_cart and details as a substitute for a separate set_checkout_details call. It does not explain use_credit or the token choice (guest_token vs account_token), which remain schema-only.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Lock the quoted cart for purchase") and immediately positions it against the siblings that surround it: quote_cart computes the total, create_checkout locks it, prepare_payment comes after. An agent can distinguish it from start_checkout/quote_cart without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Names the prerequisite ("Send the quote's version, its total as expected_total... collect them first") and the explicit successor workflow ("Next: show the buyer buyer_summary, then prepare_payment"). It also carves out the negative case: "Does not charge anything," so the agent knows this is not the payment step.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources