MCP tool · Services & subscriptions
manage_service_addons
List, add or remove the addons attached to a service.
manage_service_addons
Description
List, add or remove the addons attached to a service. action=list returns the addon child services {data:[…], total} and needs only read access. action=add (service_plan_id, optional quantity) buys an addon: it costs money and does not charge on the call — it writes an unpaid proforma order and returns {status:"confirmation_required", confirmationUrl, …} for the human to approve, then poll get_pending_action; the addon provisions only once that order is paid. action=remove (addon_id) schedules the addon to cancel at period end — also held for confirmation, and reversible with cancel_service (undo:true) on the addon id.
Input
| Name | Type | Description |
|---|---|---|
input
required
|
string |
A domain, email address, website URL, numeric service id, or hosting-account username the customer actually owns. Resolved to the owning account automatically; the resolved target is echoed back in the response.
|
action
required
|
enum |
list the addons (read), add a new addon (money, held for confirmation), or remove one (held for confirmation). One of list, add, remove.
|
service_plan_id
|
integer |
For add: the addon plan id to attach. Get available plans from list_products.
|
quantity
|
integer |
For add: how many, 1–24 (default 1).
|
addon_id
|
integer |
For remove: the addon child-service id, from manage_service_addons (action=list) → data[].id.
|
attempt_key
|
string |
For add/remove: an idempotency key you choose. Reusing it within an hour returns the same held action.
|