# What You Can Do

Once the MCP server is connected, you can talk to your Limio environment through your AI assistant. Below are the actions available today, with examples of how to use them.

## Retrieve offers

Pull offers from your Limio catalog or published inventory. You can filter by tag, path, date, or custom attributes.

**Try asking:**

* "Show me all published offers"
* "List offers tagged as 'student'"
* "What offers were modified in the last 7 days?"
* "Get the first 10 offers in JSON format"
* "Show me all offers in India"
* "What are all the save offers?"

You can paginate through large result sets — the assistant will let you know when more results are available and offer to fetch the next page.

## Create offers

Create one or more offers by describing what you want. The assistant converts your description into the right format and submits it to Limio.

**Try asking:**

* "Create a monthly digital subscription at $9.99 USD"
* "Set up two offers: a monthly plan at $14.99 and an annual plan at $129.99, both in GBP"
* "Create a student offer with a 3-month trial at $4.99/month, then $9.99/month after"
* "Create a volume-priced offer: 1-10 units at $10, 11-50 at $8, 51+ at $6"

You can also provide a CSV or JSON file with your offer data and ask the assistant to create them. For example, attach a spreadsheet export and say **"Create these offers in Limio"** — the assistant will parse the file and handle the rest.

For each offer, you can specify:

* **Price** — amount, currency, recurring or one-time. Supports [all pricing types](https://docs.limio.com/ai/mcp-server/pricing) including volume and usage-based
* **Billing cycle** — monthly, yearly, weekly, or custom intervals
* **Offer type** — standard, student, gift, trial, or cancel-save
* **Display text** — name, description, call-to-action button text, feature list
* **Restrictions** — allowed countries, labels/tags
* **Renewal** — auto-renew settings, initial and renewal terms
* **Products** — attach a product and rate plan to the offer

You don't need to remember field names. Describe what you want and the assistant fills in the details. It will confirm before creating anything.

## Update offers

Modify existing offers without losing any data. The assistant fetches the current offer, merges your changes, and saves the result — so attributes you don't mention stay untouched.

**Try asking:**

* "Update the annual plan price to $139.99"
* "Change the CTA text on the student offer to 'Start Free Trial'"
* "Add the 'premium' tag to all GBP offers"
* "Pull offers with label X, update the prices, and create a CSV audit trail"

You can update any offer attribute:

* **Pricing** — price amount, currency, billing interval
* **Display fields** — name, description, display price, features, CTA text
* **Configuration** — payment types, renewal terms, auto-renew, allowed countries
* **Labels and tags** — add or change labels for page targeting

{% hint style="info" %}
When updating prices, the assistant automatically updates the customer-facing display price fields to match. You can also provide custom display price HTML if needed.
{% endhint %}

## Find offer pages

Find which pages display a specific offer. The assistant follows the offer-to-label-to-page relationship — no need to manually cross-reference labels.

**Try asking:**

* "Where is the Canada Digital Annual offer shown?"
* "Which pages display offers tagged 'default'?"
* "Is the $8/mo offer still live on any page?"

The assistant will:

1. Look up the offer and extract its labels
2. Search for pages that reference each label
3. Show you the results grouped by label, noting any labels with no matching pages

Check where an offer appears before changing prices or removing labels.

## Query orders

Search order and subscription events. Filter by order type, date range, offer name, and source.

**Try asking:**

* "How many orders came in this month?"
* "Show me cancellations in the last 7 days"
* "How many people bought via our Black Friday offers?"
* "What orders came from shop.example.com?"
* "Show me all renewal events for the last 90 days"

Available filters:

* **Order types** — new orders, renewals, cancellations, offer changes, offer additions
* **Date range** — look back 1 to 365 days (default: 30)
* **Offer name** — match orders by offer name (e.g., "Black Friday")
* **Source** — filter by order source domain
* **Status** — filter by event status

Results include order details like offer name, amount, currency, and source. For cancellations, you'll see the cancel reason. For offer switches, you'll see both the original and new offer.

## Combine actions

You can chain actions together in a single question. The assistant picks the right tools and runs them in sequence.

**Try asking:**

* "Pull all offers with label 'annual', update their prices to $149.99, and show me a summary"
* "Where is the student offer shown, and has anyone ordered it in the last 30 days?"
* "Show me all India offers with orders in the last 6 months"
* "Find our Black Friday offers, check which pages they appear on, and count total orders"

## Build artifacts

Claude Desktop can turn Limio data into artifacts — charts, dashboards, and comparison tables — within the same conversation. Ask for what you want and the assistant pulls the data, then renders it as a visual you can iterate on.

**Try asking:**

* "Build me an orders dashboard showing new orders and cancellations over the last 90 days"
* "Create a chart comparing order volume across my top 5 offers"
* "Make a pricing comparison table for all GBP annual offers"
* "Show me a breakdown of orders by source as a pie chart"

Follow up to adjust the output — change date ranges, add filters, or switch chart types.

<figure><img src="https://1858184712-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYpwKExiFMrZewDDrGTrX%2Fuploads%2FPsSObJtE2zWey5UsMp0X%2Fimage.png?alt=media&#x26;token=a84f9487-ee69-4892-94ed-be1c67d249ec" alt=""><figcaption></figcaption></figure>

## Migrate between environments

If you connect multiple Limio environments to the same AI assistant, you can use the MCP server to move offers between them — for example, from sandbox to pre-production.

**Try asking:**

* "Pull the Black Friday offer from my sandbox environment and create it in pre-production"
* "Compare the student offer between sandbox and production — are they in sync?"
* "Migrate all offers tagged 'Q1-launch' from staging to production"

The assistant fetches the offer data from one environment and creates or updates it in the other. It will show you a preview of the changes before applying them.

{% hint style="info" %}
This requires separate MCP connectors for each environment. See the [Setup](https://docs.limio.com/ai/mcp-server/setup) guide for how to configure multiple environments.
{% endhint %}

## Tips

* **Ask for markdown or JSON.** By default, results come back as readable text. If you need structured data, ask for JSON.
* **Be specific.** "Show me published GBP offers tagged 'annual'" works better than "show me some offers."
* **Bulk operations work.** You can create or update multiple offers in a single request — describe them all at once.
* **Use plan mode for bulk changes.** In Claude Desktop or Claude Code, enable [plan mode](https://code.claude.com/docs/en/interactive-mode) before large operations like price rises. The assistant will outline every change it intends to make, and you can review and approve the full plan before anything executes.
* **Nothing happens without your approval.** The assistant will always confirm before creating or modifying data.
* **Pricing types are documented.** See the [Pricing Reference](https://docs.limio.com/ai/mcp-server/pricing) for details on configuring volume, usage-based, and other pricing types.
