# RevCent MCP Guide: `CancelSubscription`

Brief AI/MCP-focused guide for cancelling a RevCent Subscription.

Reference overview:

```text
https://revcent.com/documentation/markdown/mcp/operation/OverviewSubscription.md
```

---

## Operation Summary

Operation:

```text
CancelSubscription
```

Purpose:

```text
Cancel a subscription using the subscription ID.
```

Critical warning:

```text
CancelSubscription is permanent and cannot be undone.
```

If the subscription may need to be restarted later, use:

```text
SuspendSubscription
```

instead.

---

## When to Run

Run `CancelSubscription` only when:

- the customer explicitly requests permanent cancellation,
- the business explicitly approves permanent cancellation,
- retention/save flow is complete,
- the user understands cancellation cannot be undone,
- suspension is not the desired outcome.

Do not use cancellation for temporary pauses.

---

## Cancel vs Suspend

| Operation | Reversible? | Purpose |
|---|---:|---|
| `CancelSubscription` | No | Permanently end the subscription. |
| `SuspendSubscription` | Yes | Pause the subscription so it can be restarted later. |
| `ActivateSubscription` | Yes | Restart a suspended subscription. |

AI/MCP clients should clearly explain this before cancelling:

```text
Cancellation is irreversible.
Suspension is reversible.
```

---

## Input Schema

Required:

| Field | Type | Description |
|---|---|---|
| `subscription_id` | string | 20-character Subscription ID. |

Example:

```json
{
  "subscription_id": "SSSSSSSSSSSSSSSSSSSS"
}
```

---

## Output

Successful output can include:

| Field | Description |
|---|---|
| `api_call_id` | 20-character API call ID. |
| `api_call_unix` | Unix timestamp of API call initiation. |
| `code` | Response code. `1` indicates success. |
| `subscription_id` | 20-character Subscription ID. |
| `result` | Result message. |

---

## Best Practices

- Retrieve the subscription first with `GetSubscription`.
- Confirm the subscription ID and customer.
- Confirm the user/customer wants permanent cancellation.
- Explain that cancellation cannot be undone.
- Use `SuspendSubscription` instead if the customer may return later.
- Record cancellation reason using notes, metadata, Email Templates, AI Assistants, or support workflow where appropriate.
- Do not call this operation from AI Voice Agents or automations unless rules and explicit confirmation are clear.

---

## Final AI/MCP Instruction

Use `CancelSubscription` only for permanent cancellation. This operation cannot be undone. If the customer may restart later, use `SuspendSubscription` instead.


---
Document Parent Directory
* [Operations](https://revcent.com/documentation/markdown/mcp/operation/index.md) - AI/MCP details and overviews for operations available within the RevCent MCP.