> ## 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 or grocery subscription

Manages a recurring meal or grocery subscription at a linked merchant (for example Locale): browse the recurring menu, skip or resume delivery dates, and update plan settings. It is not a one-time purchase and takes no payment, since the subscription auto-bills the card on file at the merchant.

## Parameters

| Parameter  | Type             | Required | Description                                                                                      |
| ---------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------ |
| `merchant` | string           | Yes      | Merchant slug (for example `locale`)                                                             |
| `action`   | string           | Yes      | One of `menu_search`, `get_skip_dates`, `skip`, `unskip`, `set_skip_dates`, or `update_setting`  |
| `query`    | string           | No       | For `menu_search`: search term over the recurring menu; an empty string lists everything         |
| `limit`    | number           | No       | For `menu_search`: max items to return                                                           |
| `date`     | string           | No       | For `skip` and `unskip`: one ISO delivery date (YYYY-MM-DD)                                      |
| `dates`    | array of strings | No       | For `set_skip_dates`: the full set of ISO dates to skip; an empty array resumes all              |
| `setting`  | string           | No       | For `update_setting`: the setting key, such as `subscription_size`, `diets`, or `default_window` |
| `value`    | any              | No       | For `update_setting`: the new value (number, string, or array of strings)                        |

## Returns

Depends on the action: `menu_search` lists matching dishes and flags the ones covered by the plan, `get_skip_dates` lists skipped or paused deliveries, and `skip`, `unskip`, and `set_skip_dates` confirm the updated skip list. `update_setting` confirms the changed setting. Failures return a short "Could not manage" message, and `skip`, `unskip`, and `update_setting` remind you if a required field is missing.

## Example

```json theme={null}
{ "name": "manage_subscription", "arguments": { "merchant": "locale", "action": "skip", "date": "2026-07-10" } }
```