Skip to main content
Glama

Tanatasa Beauty

checkout_session

Shortcut from product feed items to a checkout: send feed item ids (tanatasa-variant-) and quantities. Guests call create_cart first and pass its guest_token. Item names and prices you send are ignored; Tanatasa's catalogue is authoritative. Returns a checkout and review link; continue with set_checkout_details and 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": {
      "checkout_session": "<checkout_session>"
    },
    "name": "checkout_session"
  }
}

Input Schema

NameRequiredDescriptionDefault
guest_tokenNoPrivate guest session token from create_cart. Retain for cart, checkout and purchase-status calls; no account login needed.
idempotency_keyNoA new random key per purchase; retry with the same key.
checkout_sessionYesThe items to buy: up to 20 feed items with quantities.

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. Changed3 schema fields changed
    • addedInput schema / properties / checkout_session / description
      Added value: +"The items to buy: up to 20 feed items with quantities."
    • addedInput schema / properties / checkout_session / properties / items / items / properties / id / description
      Added value: +"The product feed item id, tanatasa-variant-<variant_id>."
    • addedInput schema / properties / idempotency_key / description
      Added value: +"A new random key per purchase; retry with the same key."
  4. 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"
      +}
  5. 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"
      -}
  6. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Beyond the annotations, the description discloses important behavior: submitted names and prices are ignored, the Tanatasa catalogue is authoritative, and the call returns a checkout and review link. It does not add much about idempotency or permissions, but annotations already cover safety and idempotency hints.

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?

The description is four efficient sentences, front-loads the purpose, then gives prerequisites, input behavior, and next steps. Every sentence adds useful information without repetition.

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 nested checkout-creation tool with no output schema, the description covers what the tool does, the guest prerequisite, the authoritative catalogue behavior, the return value, and the continuation workflow. Remaining details such as item limits are already supplied by the schema.

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?

With 100% schema description coverage, the schema already documents parameters well. The description adds meaningful semantics by explaining that item names and prices are ignored and that the catalogue is authoritative, though it does not clarify the role of all optional nested item fields.

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

Purpose4/5

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

The description clearly states a specific action and input source: creating a checkout from product feed items by sending item ids and quantities. It implies a distinct shortcut path, but does not explicitly compare itself with the sibling create_checkout, so sibling differentiation is implicit rather than explicit.

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

Usage Guidelines4/5

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

It gives clear usage context, including the guest prerequisite to call create_cart first and pass guest_token, and names the follow-up tools set_checkout_details and prepare_payment. It lacks an explicit statement of when to use this instead of create_checkout or other alternatives, so guidance is strong but not complete.

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