> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# manage_subscription

> Manage a recurring meal/grocery SUBSCRIPTION (e.g.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

## What it does

Manage a recurring meal/grocery SUBSCRIPTION (e.g. Locale) — NOT a one-time purchase, and no payment is taken (the subscription auto-bills the card on file at the merchant). action: 'menu\_search' (browse the recurring menu; items flagged inPlan are covered by the plan), 'get\_skip\_dates' (list skipped/paused deliveries), 'skip'/'unskip' (one upcoming delivery date), 'set\_skip\_dates' (replace the full skip set; \[] resumes all), 'update\_setting' (change a setting). Locale settings: subscription\_size (meals, e.g. 8), calorie\_preference (low\_calorie|both|moderate), diets (array), longevity\_allergens (array), ingredient\_allergies (array), default\_window ('9am - 6pm'|'3pm - 7pm'|'9am - 12pm'), delivery\_instructions (text). Link the merchant first.

## Inputs

| Field                   | Type                                                                                               | Description                                                                     |
| ----------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `merchant` *(required)* | string                                                                                             | merchant slug (e.g. locale)                                                     |
| `action` *(required)*   | string: `menu_search` · `get_skip_dates` · `skip` · `unskip` · `set_skip_dates` · `update_setting` | the management action                                                           |
| `query`                 | string                                                                                             | menu\_search: term over the recurring menu (e.g. 'salmon'); '' lists everything |
| `limit`                 | number                                                                                             | menu\_search: max items                                                         |
| `date`                  | string                                                                                             | skip/unskip: one ISO delivery date (YYYY-MM-DD)                                 |
| `dates`                 | array                                                                                              | set\_skip\_dates: FULL set of ISO dates to skip (\[] resumes all)               |
| `setting`               | string                                                                                             | update\_setting: the setting key (see description)                              |
| `value`                 | object                                                                                             | update\_setting: the new value (number, string, or array of strings)            |

## Returns

| Field                  | Type   | Description                         |
| ---------------------- | ------ | ----------------------------------- |
| `message` *(required)* | string | Human-readable result or next step. |

## Example call

```json theme={null}
{
  "tool": "manage_subscription",
  "arguments": {
    "merchant": "\u2026",
    "action": "\u2026"
  }
}
```