# get_subscription (/docs/mcp/tools/get-subscription)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/get_subscription.mdx. */}

**Get subscription** · Read-only

Shows the current subscription: plan, tierName, leads per month, usedCredits, remaining, topUpCredits, refreshOn, price (monthly equivalent, USD), annualTotal, interval ('month' or 'year'), nextBillingDate, cancelAtPeriodEnd, subscriptionStatus, isPausedByUser/pausedUntil, pendingDowngrade, retentionDiscount and add-ons. Read-only. Call it before any plan change: the interval tells you which value of `annual` to pass to preview_plan_change, upgrade_plan and downgrade_plan. Price fields are empty when there is no paid subscription. Needs an account-level key.

| Connection | Account-owner URL or OAuth (not a team member URL) |
| --- | --- |

## Parameters [#parameters]

This tool takes no parameters.

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "get_subscription",
  "title": "Get subscription",
  "annotations": {
    "title": "Get subscription",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}
```