Skip to navigation

write_subscription

Create and manage subscriptions and ramps, including init, cancel and void

Live server: test server (test.mcp.solvimon.com) only.

Creates and manages BILLING subscriptions and their schedules. Use init to subscribe a known customer from your backend. Use create_checkout_link for self-serve. Quotes go through create_quote and write_quote.

Actions: create, update, delete, init, activate, cancel, void, archive, copy

Resource types: pricing_plan_subscriptions, pricing_plan_subscription_groups, pricing_plan_schedules

  • init activates at once. For a ramp (several schedules on one subscription), create a DRAFT subscription with its schedules, review it, then activate.
  • Every schedule is checked: an ACTIVE plan version, a billing_period the version declares (required when it declares several), no overlap with the next schedule. Gaps and a start in the past are warned about.
  • A config with a yearly price and no pricing_period is refused, because it would be charged every period.
  • cancel ends the subscription at period end. void terminates it immediately. copy duplicates it in DRAFT with all schedules, discounts and commitments.
Subscribe an existing customer
{
"action": "init",
"resource_type": "pricing_plan_subscriptions",
"body": {
"pricing_plan_subscription": {"customer_id": "cust_AbD3DqausjOYiMNDZY11F", "reference": "acme-2026"},
"pricing_plan_schedules": [{
"pricing_plan_version_id": "ppve_Zt6yUw2QmK9nXr4VcHb37",
"start_at": "2026-11-01T00:00:00Z",
"billing_period": {"type": "MONTH", "value": 1},
"pricing_currency": "EUR"
}]
}
}

Example prompts

  • “Subscribe Acme Inc. to the Growth Plan, billed monthly in EUR, starting on the first of next month.”
  • “Draft a ramp for Acme Inc.: 50% off the platform fee in year one, full price from year two.”
  • “Cancel Acme Inc.’s subscription at the end of the current period.”
  • “Copy Acme Inc.’s subscription as a draft so I can move it to the new plan version.”
  • “Void the subscription we created for Acme Inc. by mistake today.”

Example output

Prompt: “Draft a Growth Plan subscription for Docs Example B.V., billed every six months in EUR, starting at the beginning of next year. Don’t activate it yet.”

Tool call:

{
"action": "create",
"resource_type": "pricing_plan_subscriptions",
"body": {
"pricing_plan_subscription": {"customer_id": "cust_BwDpzo0vA1cb03CA8t1f", "reference": "docs-example-subscription"},
"pricing_plan_schedules": [{
"pricing_plan_version_id": "ppve_VwD6720vzgsII1Csge1c",
"start_at": "2027-01-01T00:00:00Z",
"billing_period": {"type": "MONTH", "value": 6},
"pricing_currency": "EUR"
}]
}
}

Response (trimmed):

{
"pricing_plan_subscription": {
"id": "ppsu_ewDpzo0vA1ceR5Cd8p1y",
"status": "DRAFT",
"type": "BILLING",
"reference": "docs-example-subscription",
"customer_id": "cust_BwDpzo0vA1cb03CA8t1f",
"billing_currency": "EUR",
"billing_time": "EXACT"
},
"pricing_plan_schedules": [
{
"id": "ppsc_NwDpzo0vA1ceStCs8q1v",
"status": "DRAFT",
"pricing_plan_version_id": "ppve_VwD6720vzgsII1Csge1c",
"start_at": "2027-01-01T00:00:00Z",
"billing_period": {"type": "MONTH", "value": 6},
"pricing_currency": "EUR"
}
],
"note": "Created as DRAFT and not activated: nothing bills yet."
}

Claude’s answer: The subscription is drafted for Docs Example B.V. on the Growth Plan, billed every six months in EUR from the start date. Nothing bills yet. When you’re ready, I can activate its schedule and then the subscription.