events

Purchase Ticket Order

purchase_ticket_order

Destructive

Use this only when the user has confirmed a quote in writing (the confirmation must say buy or purchase and repeat the quantity and max total; the server rejects it otherwise). Without an integrated purchase provider this buys nothing: it hands off to checkout, returning status requires_external_checkout and the checkout_url where the user pays on the provider's site. Never claim a purchase unless status is purchased. Each quote_token can be submitted once: a repeat returns status quote_already_used and must never be retried.

Input Schema

Name	Required	Description
`quote_token`	Yes	The signed quote_token from quote_ticket_order, unchanged.
`delivery_email`	No
`add_to_calendar`	No
`confirmation_text`	Yes	The user's own words confirming the purchase, including buy/purchase, the quantity and the max total.
`user_payment_profile_id`	No	Provider-specific saved payment profile id, when an integrated provider supports autonomous purchase.

Schema Changelog

Changes observed during successful MCP inspections.

Changed9 schema fields changedOct 14, 2026
- addedInput schema / properties / add_to_calendar
```
Added value: +{
+  "type": "boolean"
+}
```
- addedInput schema / properties / confirmation_text / description
```
Added value: +"The user's own words confirming the purchase, including buy/purchase, the quantity and the max total."
```
- addedInput schema / properties / confirmation_text / maxLength
```
Added value: +400
```
- addedInput schema / properties / delivery_email
```
Added value: +{
+  "maxLength": 200,
+  "type": "string"
+}
```
- removedInput schema / properties / idempotency_key
```
Removed value: -{
-  "type": "string"
-}
```
- addedInput schema / properties / quote_token / description
```
Added value: +"The signed quote_token from quote_ticket_order, unchanged."
```
- addedInput schema / properties / quote_token / maxLength
```
Added value: +8192
```
- addedInput schema / properties / user_payment_profile_id / description
```
Added value: +"Provider-specific saved payment profile id, when an integrated provider supports autonomous purchase."
```
- addedInput schema / properties / user_payment_profile_id / maxLength
```
Added value: +200
```

Changed5 schema fields changedAug 30, 2026

removedInput schema / properties / confirmation_text / description

Removed value: -"User's explicit written confirmation, including buy/purchase, quantity, and max_total when present."

removedInput schema / properties / idempotency_key / description

Removed value: -"Optional idempotency key for integrated purchase providers."

removedInput schema / properties / quote_token / description

Removed value: -"Opaque quote token returned by quote_ticket_order."

removedInput schema / properties / user_payment_profile_id / description

Removed value: -"Provider-specific saved payment profile id, when an integrated provider supports autonomous purchase."

changedOutput schema / (root)

Previous value: -{
-  "anyOf": [
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "calendar_event": {
-          "properties": {
-            "city": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ends_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "event_url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ics_content": {
-              "type": "string"
-            },
-            "ics_filename": {
-              "type": "string"
-            },
-            "starts_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "status": {
-              "type": "string"
-            },
-            "ticket_url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "title": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "uid": {
-              "type": "string"
-            },
-            "venue": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "uid",
-            "ics_filename",
-            "ics_content"
-          ],
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "checkout_url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "confirmation_prompt": {
-          "type": "string"
-        },
-        "delivery_email": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "error": {
-          "type": "string"
-        },
-        "order_id": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "provider_response": {
-          "additionalProperties": true,
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "purchased": {
-          "type": "boolean"
-        },
-        "quote": {
-          "properties": {
-            "autonomous_purchase_supported": {
-              "type": "boolean"
-            },
-            "availability_status": {
-              "type": "string"
-            },
-            "checkout_url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "estimated_price": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "event": {
-              "properties": {
-                "attendance_count": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "calendar_url": {
-                  "description": "Prefilled Google Calendar link. Offer as 'Add to calendar'.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "city": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "description": {
-                  "description": "Short one-line event description for display.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "directions_url": {
-                  "description": "Google Maps directions link. Offer as 'Get directions'.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "ends_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "event_types": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "event_url": {
-                  "type": "string"
-                },
-                "genres": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "id": {
-                  "type": "string"
-                },
-                "lineup": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "price": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "source": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "starts_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "ticket_url": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "title": {
-                  "type": "string"
-                },
-                "venue": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "vibe": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                }
-              },
-              "required": [
-                "id",
-                "title",
-                "event_url"
-              ],
-              "type": "object"
-            },
-            "expires_at": {
-              "type": "string"
-            },
-            "fees_included": {
-              "type": "boolean"
-            },
-            "max_total": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "offer_id": {
-              "type": "string"
-            },
-            "price_guaranteed": {
-              "type": "boolean"
-            },
-            "provider": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "purchase_mode": {
-              "type": "string"
-            },
-            "quantity": {
-              "type": "number"
-            },
-            "quote_id": {
-              "type": "string"
-            },
-            "refund_terms": {
-              "type": "string"
-            },
-            "stop_conditions": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "ticket_type": {
-              "type": "string"
-            }
-          },
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "receipt_url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "status": {
-          "type": "string"
-        },
-        "ticket_delivery_status": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "purchased",
-        "status"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "cause": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "classification": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "code": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "error": {
-          "type": "string"
-        },
-        "hostname": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "retryable": {
-          "type": "boolean"
-        },
-        "status": {
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "type": {
-          "type": "string"
-        },
-        "url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "error"
-      ],
-      "type": "object"
-    }
-  ],
-  "type": "object"
-}New value: +null

Changed5 schema fields changedAug 24, 2026

addedInput schema / properties / confirmation_text / description

Added value: +"User's explicit written confirmation, including buy/purchase, quantity, and max_total when present."

addedInput schema / properties / idempotency_key / description

Added value: +"Optional idempotency key for integrated purchase providers."

addedInput schema / properties / quote_token / description

Added value: +"Opaque quote token returned by quote_ticket_order."

addedInput schema / properties / user_payment_profile_id / description

Added value: +"Provider-specific saved payment profile id, when an integrated provider supports autonomous purchase."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "assistant_instruction": {
+          "type": "string"
+        },
+        "calendar_event": {
+          "properties": {
+            "city": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ends_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "event_url": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ics_content": {
+              "type": "string"
+            },
+            "ics_filename": {
+              "type": "string"
+            },
+            "starts_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "status": {
+              "type": "string"
+            },
+            "ticket_url": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "title": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "uid": {
+              "type": "string"
+            },
+            "venue": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "uid",
+            "ics_filename",
+            "ics_content"
+          ],
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "checkout_url": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "confirmation_prompt": {
+          "type": "string"
+        },
+        "delivery_email": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "error": {
+          "type": "string"
+        },
+        "order_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "provider_response": {
+          "additionalProperties": true,
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "purchased": {
+          "type": "boolean"
+        },
+        "quote": {
+          "properties": {
+            "autonomous_purchase_supported": {
+              "type": "boolean"
+            },
+            "availability_status": {
+              "type": "string"
+            },
+            "checkout_url": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "estimated_price": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "event": {
+              "properties": {
+                "attendance_count": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "calendar_url": {
+                  "description": "Prefilled Google Calendar link. Offer as 'Add to calendar'.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "city": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "description": {
+                  "description": "Short one-line event description for display.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "directions_url": {
+                  "description": "Google Maps directions link. Offer as 'Get directions'.",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "ends_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "event_types": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "event_url": {
+                  "type": "string"
+                },
+                "genres": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "lineup": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "price": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "source": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "starts_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "ticket_url": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "title": {
+                  "type": "string"
+                },
+                "venue": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "vibe": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              },
+              "required": [
+                "id",
+                "title",
+                "event_url"
+              ],
+              "type": "object"
+            },
+            "expires_at": {
+              "type": "string"
+            },
+            "fees_included": {
+              "type": "boolean"
+            },
+            "max_total": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "offer_id": {
+              "type": "string"
+            },
+            "price_guaranteed": {
+              "type": "boolean"
+            },
+            "provider": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "purchase_mode": {
+              "type": "string"
+            },
+            "quantity": {
+              "type": "number"
+            },
+            "quote_id": {
+              "type": "string"
+            },
+            "refund_terms": {
+              "type": "string"
+            },
+            "stop_conditions": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "ticket_type": {
+              "type": "string"
+            }
+          },
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "receipt_url": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "status": {
+          "type": "string"
+        },
+        "ticket_delivery_status": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "purchased",
+        "status"
+      ],
+      "type": "object"
+    },
+    {
+      "properties": {
+        "assistant_instruction": {
+          "type": "string"
+        },
+        "cause": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "classification": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "code": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "error": {
+          "type": "string"
+        },
+        "hostname": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "status": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "type": {
+          "type": "string"
+        },
+        "url": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "error"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}

Changed5 schema fields changedAug 24, 2026

removedInput schema / properties / confirmation_text / description

Removed value: -"User's explicit written confirmation, including buy/purchase, quantity, and max_total when present."

removedInput schema / properties / idempotency_key / description

Removed value: -"Optional idempotency key for integrated purchase providers."

removedInput schema / properties / quote_token / description

Removed value: -"Opaque quote token returned by quote_ticket_order."

removedInput schema / properties / user_payment_profile_id / description

Removed value: -"Provider-specific saved payment profile id, when an integrated provider supports autonomous purchase."

changedOutput schema / (root)

Previous value: -{
-  "anyOf": [
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "calendar_event": {
-          "properties": {
-            "city": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ends_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "event_url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ics_content": {
-              "type": "string"
-            },
-            "ics_filename": {
-              "type": "string"
-            },
-            "starts_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "status": {
-              "type": "string"
-            },
-            "ticket_url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "title": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "uid": {
-              "type": "string"
-            },
-            "venue": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "uid",
-            "ics_filename",
-            "ics_content"
-          ],
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "checkout_url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "confirmation_prompt": {
-          "type": "string"
-        },
-        "delivery_email": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "error": {
-          "type": "string"
-        },
-        "order_id": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "provider_response": {
-          "additionalProperties": true,
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "purchased": {
-          "type": "boolean"
-        },
-        "quote": {
-          "properties": {
-            "autonomous_purchase_supported": {
-              "type": "boolean"
-            },
-            "availability_status": {
-              "type": "string"
-            },
-            "checkout_url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "estimated_price": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "event": {
-              "properties": {
-                "attendance_count": {
-                  "type": [
-                    "number",
-                    "null"
-                  ]
-                },
-                "calendar_url": {
-                  "description": "Prefilled Google Calendar link. Offer as 'Add to calendar'.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "city": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "description": {
-                  "description": "Short one-line event description for display.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "directions_url": {
-                  "description": "Google Maps directions link. Offer as 'Get directions'.",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "ends_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "event_types": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "event_url": {
-                  "type": "string"
-                },
-                "genres": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "id": {
-                  "type": "string"
-                },
-                "lineup": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "price": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "source": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "starts_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "ticket_url": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "title": {
-                  "type": "string"
-                },
-                "venue": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "vibe": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                }
-              },
-              "required": [
-                "id",
-                "title",
-                "event_url"
-              ],
-              "type": "object"
-            },
-            "expires_at": {
-              "type": "string"
-            },
-            "fees_included": {
-              "type": "boolean"
-            },
-            "max_total": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "offer_id": {
-              "type": "string"
-            },
-            "price_guaranteed": {
-              "type": "boolean"
-            },
-            "provider": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "purchase_mode": {
-              "type": "string"
-            },
-            "quantity": {
-              "type": "number"
-            },
-            "quote_id": {
-              "type": "string"
-            },
-            "refund_terms": {
-              "type": "string"
-            },
-            "stop_conditions": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "ticket_type": {
-              "type": "string"
-            }
-          },
-          "type": [
-            "object",
-            "null"
-          ]
-        },
-        "receipt_url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "status": {
-          "type": "string"
-        },
-        "ticket_delivery_status": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "purchased",
-        "status"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "cause": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "classification": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "code": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "error": {
-          "type": "string"
-        },
-        "hostname": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "retryable": {
-          "type": "boolean"
-        },
-        "status": {
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "type": {
-          "type": "string"
-        },
-        "url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "error"
-      ],
-      "type": "object"
-    }
-  ],
-  "type": "object"
-}New value: +null

First observedJul 30, 2026

TDQS

A4.5/5.0

Behavior5/5

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

Excellent disclosure beyond annotations: it names the requires_external_checkout status and checkout_url handoff, the terminal 'purchased' status the agent must wait for before claiming success, and the single-use nature of quote_token producing quote_already_used with no retry. This is exactly the non-idempotent, destructive, open-world behavior the annotations hint at, made concrete.

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

Conciseness4/5

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

Four tight sentences that each carry load, front-loaded with the gating condition. Dense but not padded; a minor readability cost from packing the status contract into the first paragraph.

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

Completeness4/5

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

For a destructive, non-idempotent purchase tool with no output schema, the description supplies the status contract, the retry prohibition, and the confirmation requirement — the critical missing structured data. Leftover gap is the undocumented delivery_email and add_to_calendar parameters.

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 60%, and the description compensates by explaining that confirmation_text must contain buy/purchase plus quantity and max total, and that quote_token comes unchanged from quote_ticket_order. The two undescribed params (delivery_email, add_to_calendar) get no help here, but the semantically risky ones are covered.

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?

Specific verb+resource ('purchase ticket order') with clear scope: it consumes a signed quote_token, not raw selection. It distinguishes itself from quote_ticket_order, which it explicitly references as the source of the token, so an agent can tell the two apart without opening schemas.

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 states the exact precondition for calling ('only when the user has confirmed a quote in writing', with the required wording) and the behavioral fork when no integrated provider exists. It does not explicitly say 'call quote_ticket_order first to get a token', but that step is strongly implied by the parameter origin.

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

All events tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?