Skip to main content
Glama

Patch MCP

preview_subscription_change

Create a 15-minute quote for starting a subscription, changing its plan, canceling renewal at period end, or undoing cancellation/a scheduled downgrade. Returns immediate charges, monthly list price, effective time and allowances. May read Stripe and save a local quote; does not charge or change a subscription. Show the complete quote to the user and obtain explicit approval before execute_subscription_change. Each preview creates a new quote.

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": {
      "action": "<action>"
    },
    "name": "preview_subscription_change"
  }
}

Input Schema

NameRequiredDescriptionDefault
planNo
trialNo
actionYes
promotion_codeNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "action": {
      -        "enum": [
      -          "subscribe",
      -          "change",
      -          "cancel",
      -          "resume"
      -        ],
      -        "type": "string"
      -      },
      -      "amount_due": {
      -        "description": "Amount due now in the currency's minor units.",
      -        "maximum": 9007199254740991,
      -        "minimum": -9007199254740991,
      -        "type": "integer"
      -      },
      -      "amount_is_estimate": {
      -        "type": "boolean"
      -      },
      -      "currency": {
      -        "type": "string"
      -      },
      -      "effective_at": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "expires_in_seconds": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "next_action": {
      -        "const": "execute_subscription_change",
      -        "type": "string"
      -      },
      -      "number_limit": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "operation_id": {
      -        "type": "string"
      -      },
      -      "plan": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "starter",
      -              "pro",
      -              "pro_starter",
      -              "pro_plus",
      -              "pro_max"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "promotion_code": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "proration_date": {
      -        "maximum": 9007199254740991,
      -        "minimum": -9007199254740991,
      -        "type": "integer"
      -      },
      -      "quote_id": {
      -        "maxLength": 200,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "recurring_amount": {
      -        "anyOf": [
      -          {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Monthly list price in minor units, before discounts and tax."
      -      },
      -      "recurring_amount_basis": {
      -        "const": "monthly_list_price_before_discounts_and_tax",
      -        "type": "string"
      -      },
      -      "requires_user_authorization": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "trial_days": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "voice_limit": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "quote_id",
      -      "action",
      -      "plan",
      -      "amount_due",
      -      "currency",
      -      "amount_is_estimate",
      -      "trial_days",
      -      "promotion_code",
      -      "recurring_amount",
      -      "recurring_amount_basis",
      -      "effective_at",
      -      "number_limit",
      -      "voice_limit",
      -      "proration_date",
      -      "requires_user_authorization",
      -      "expires_in_seconds",
      -      "next_action"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "type": "string"
      -      },
      -      "message": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "message": {
      -        "type": "string"
      -      },
      -      "next_action": {
      -        "type": "string"
      -      },
      -      "operation_id": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "operation_id",
      -      "status"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "action": {
      +        "enum": [
      +          "subscribe",
      +          "change",
      +          "cancel",
      +          "resume"
      +        ],
      +        "type": "string"
      +      },
      +      "amount_due": {
      +        "description": "Amount due now in the currency's minor units.",
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "amount_is_estimate": {
      +        "type": "boolean"
      +      },
      +      "currency": {
      +        "type": "string"
      +      },
      +      "effective_at": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "expires_in_seconds": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "next_action": {
      +        "const": "execute_subscription_change",
      +        "type": "string"
      +      },
      +      "number_limit": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "operation_id": {
      +        "type": "string"
      +      },
      +      "plan": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "starter",
      +              "pro",
      +              "pro_starter",
      +              "pro_plus",
      +              "pro_max"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "promotion_code": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "proration_date": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "quote_id": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "recurring_amount": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Monthly list price in minor units, before discounts and tax."
      +      },
      +      "recurring_amount_basis": {
      +        "const": "monthly_list_price_before_discounts_and_tax",
      +        "type": "string"
      +      },
      +      "requires_user_authorization": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "trial_days": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "quote_id",
      +      "action",
      +      "plan",
      +      "amount_due",
      +      "currency",
      +      "amount_is_estimate",
      +      "trial_days",
      +      "promotion_code",
      +      "recurring_amount",
      +      "recurring_amount_basis",
      +      "effective_at",
      +      "number_limit",
      +      "proration_date",
      +      "requires_user_authorization",
      +      "expires_in_seconds",
      +      "next_action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "type": "string"
      +      },
      +      "message": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "message": {
      +        "type": "string"
      +      },
      +      "next_action": {
      +        "type": "string"
      +      },
      +      "operation_id": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "operation_id",
      +      "status"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "error": {
      -        "type": "string"
      -      },
      -      "message": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "message": {
      -        "type": "string"
      -      },
      -      "next_action": {
      -        "type": "string"
      -      },
      -      "operation_id": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "operation_id",
      -      "status"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "action": {
      +        "enum": [
      +          "subscribe",
      +          "change",
      +          "cancel",
      +          "resume"
      +        ],
      +        "type": "string"
      +      },
      +      "amount_due": {
      +        "description": "Amount due now in the currency's minor units.",
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "amount_is_estimate": {
      +        "type": "boolean"
      +      },
      +      "currency": {
      +        "type": "string"
      +      },
      +      "effective_at": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "expires_in_seconds": {
      +        "exclusiveMinimum": 0,
      +        "maximum": 9007199254740991,
      +        "type": "integer"
      +      },
      +      "next_action": {
      +        "const": "execute_subscription_change",
      +        "type": "string"
      +      },
      +      "number_limit": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "operation_id": {
      +        "type": "string"
      +      },
      +      "plan": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "starter",
      +              "pro",
      +              "pro_starter",
      +              "pro_plus",
      +              "pro_max"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "promotion_code": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "proration_date": {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "quote_id": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "recurring_amount": {
      +        "anyOf": [
      +          {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Monthly list price in minor units, before discounts and tax."
      +      },
      +      "recurring_amount_basis": {
      +        "const": "monthly_list_price_before_discounts_and_tax",
      +        "type": "string"
      +      },
      +      "requires_user_authorization": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "trial_days": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "voice_limit": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "quote_id",
      +      "action",
      +      "plan",
      +      "amount_due",
      +      "currency",
      +      "amount_is_estimate",
      +      "trial_days",
      +      "promotion_code",
      +      "recurring_amount",
      +      "recurring_amount_basis",
      +      "effective_at",
      +      "number_limit",
      +      "voice_limit",
      +      "proration_date",
      +      "requires_user_authorization",
      +      "expires_in_seconds",
      +      "next_action"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "error": {
      +        "type": "string"
      +      },
      +      "message": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "message": {
      +        "type": "string"
      +      },
      +      "next_action": {
      +        "type": "string"
      +      },
      +      "operation_id": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "operation_id",
      +      "status"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Added

TDQS

A4.5/5.0
Behavior4/5

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

Goes beyond the annotations by disclosing quote lifetime (15 minutes), side effects ("May read Stripe and save a local quote"), and the absence of billing mutation. "Each preview creates a new quote" usefully explains why idempotentHint is false, which the annotation alone would not make obvious to an agent.

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?

Four tight sentences: purpose first, return values second, side-effect and safety boundary third, operational rule (approval gate) last. No sentence is redundant, and the front-loading makes the read path obvious.

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?

The prefetch/quote model, its expiry, its side effects, and the human-approval gate are all present, and an output schema exists so return shapes need no elaboration. What remains unsaid (trial, promotion code) is minor against a 4-parameter schema.

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

Parameters3/5

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

With 0% schema description coverage, the description must carry parameter meaning: it maps the four action values well (subscribe/change/cancel/resume) and implies plan selection via "changing its plan". However, `trial` and `promotion_code` are never mentioned, and the required `action` field's role is only implied by the prose list.

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 ("Create a 15-minute quote") and enumerates the four actions it covers (subscribe, change, cancel-at-period-end, resume/undo). It is immediately distinguishable from the sibling execute_subscription_change, which it explicitly positions as the follow-up step.

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?

Gives explicit when-to-use guidance by naming the alternative workflow: preview first, show the full quote, obtain explicit approval, then call execute_subscription_change. It also sets a clear boundary ("does not charge or change a subscription"), so an agent knows this tool is always the safe precursor.

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