Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Appstle Subscriptions in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.
Summary
Manage Shopify subscriptions in Appstle from any AI agent: contracts and customers, upcoming and past renewal orders, pause and resume, skip and reschedule, frequency and next billing date, add, swap or remove products, discounts, delivery address, selling plans, swap rules, retention activity and revenue per contract. Cancel and bill now install switched off.
Try asking
Example prompts for Appstle Subscriptions
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Appstle Subscriptions, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Appstle Subscriptions + Claude
Manage Shopify subscriptions in Appstle from any AI agent: contracts and customers, upcoming and past renewal orders, pause and resume, skip and reschedule, frequency and next billing date, add, swap or remove products, discounts, delivery address, selling plans, swap rules, retention activity and revenue per contract. Cancel and bill now install switched off.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
APPSTLE_API_KEY
Step 1 — Get credentials
Setting up takes about 2 minutes. You need a Shopify store with the Appstle Subscriptions app on a plan that includes API access.
- In the Shopify admin open the Appstle Subscriptions app, then Settings, API Key Management.
- Create an API key (up to 10 per store) and paste it into
APPSTLE_API_KEY. The connector sends it in theX-API-Keyheader. The key gives full access to the store's subscriptions, so keep it secret. - Install the connector and run
appstle_subscriptions_list_subscription_contracts: it lists subscription contracts and confirms the key.
The connector uses the Appstle Subscriptions Admin API (https://subscription-admin.appstle.com/api/external/v2).
What it reads: subscription contracts with status, customer, next billing date, billing and delivery interval, products and order amount, searchable by status, dates, customer name or email, order number, product, variant, selling plan or amount. The full contract as Shopify holds it, with line ids, discount ids, delivery method and address and payment method. Customers that have subscriptions, with their profile, payment methods and contracts. Upcoming (QUEUED) orders with their billing attempt ids, past renewal orders (successful, failed and skipped; initial checkout orders are not included) and the tracking of the latest order. Subscription groups and selling plans, product swap rules, the delivery options a contract can switch to, revenue and the current billing cycle per contract, a shop-wide report of renewal billing attempts by status (SUCCESS for revenue, FAILURE for failed payments), and retention activities: each time a customer went through the cancel or pause flow, with the reason and whether the retention offer was accepted.
What it writes: pauses (PAUSED) or resumes (ACTIVE) a subscription, moves the next billing date, changes billing and delivery frequency, skips, unskips or reschedules an upcoming order, adds, changes, swaps or removes products, switches the selling plan, applies a Shopify discount code or a custom discount and removes discounts, changes the delivery address and the order note, and has Shopify email the customer a link to update the payment method. It can also create a time-limited login link to the customer portal; that link logs in as the customer, so give it only to that customer. These changes affect real subscriptions and usually email the customer, so the AI says what will change and waits for your yes.
Switched off at install: appstle_subscriptions_cancel_contract (stops all future billing and deliveries; a cancelled contract cannot be resumed) and appstle_subscriptions_bill_order_now (charges the customer's card at once; the result appears later in the past orders). An admin switches them on when the team needs them.
Data formats: contract, customer, billing attempt, group, product and variant ids are numbers. Line ids and discount ids are full Shopify GraphQL ids such as gid://shopify/SubscriptionLine/..., and the AI passes them exactly as returned. Dates are ISO 8601 with a time zone (2026-11-01T00:00:00Z). Amounts are in the shop currency. Contract statuses are ACTIVE, PAUSED and CANCELLED; billing attempts are QUEUED, SUCCESS, FAILURE, SKIPPED and others. A new delivery address is sent complete, not only the changed field.
Paging: list tools take page (from 0) and size (default 20, at most 2000). The total is in _headers.x-total-count. sort takes a database column in snake_case with a direction, e.g. next_billing_date,asc. appstle_subscriptions_get_customer pages the customer's contracts with cursor.
Common errors: 401 or 403 means the API key is wrong or revoked, or the Appstle plan has no API access. 400 explains a refused change, for example a date in the past, a line below the subscription minimum or an order that is no longer QUEUED. 404 is an unknown id. 429 is a rate limit: wait and retry.
The connector does not create new subscriptions, does not edit subscription groups, selling plans or swap rules, and does not change the payment method itself: it sends the customer the update link.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Claude
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Recommended path: works on claude.ai web without editing any config file.
- In Claude, open Customize → Connectors.
- Click +, then Add custom connector.
- Enter a name, e.g.
Appstle Subscriptions, and the remote MCP server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Add. - Click Connect and sign in to AnythingMCP (OAuth) to allow access.
All tools below appear in your chat: start typing prompts.
Available tools
| Tool | What it does |
|---|---|
appstle_subscriptions_list_subscription_contracts | List and search subscription contracts of the shop: contract id, status, customer name and email, next billing date, billing and delivery… |
appstle_subscriptions_get_contract | One subscription contract as Shopify holds it: status, next billing date, billing and delivery policy, lines (with the line ids the line… |
appstle_subscriptions_get_contract_analytics | Revenue analytics of one contract: total revenue generated, number of successful orders and the formatted revenue |
appstle_subscriptions_get_contract_current_cycle | Current billing cycle number of a contract (how many successful billings so far, the initial order counting as 1) |
appstle_subscriptions_get_contract_fulfillments | Fulfillment of the latest successful order of a contract: shipment status, tracking numbers and links, delivery estimate and fulfilled line… |
appstle_subscriptions_get_delivery_options | Delivery methods a contract can switch to, based on its address and products (shipping, local delivery, pickup) |
appstle_subscriptions_list_upcoming_orders | Upcoming (QUEUED) orders of a contract or a customer, by billing date: billing attempt id, billing date and status |
appstle_subscriptions_list_past_orders | Past (processed) renewal orders of the shop, a contract or a customer: successful, failed and skipped billing attempts with order id and… |
appstle_subscriptions_get_past_orders_report | Report of renewal billing attempts across the shop by status (e.g |
appstle_subscriptions_list_customers | Customers that have subscriptions, with name, email, number of subscriptions and their status |
appstle_subscriptions_get_customer | One customer with profile (name, email, phone, addresses), payment methods and a page of their subscription contracts |
appstle_subscriptions_list_customer_subscriptions | All valid (active, paused or otherwise not deleted) subscription contracts of one customer with full details: status, products, billing and… |
appstle_subscriptions_get_customer_portal_link | Create a time-limited link to the customer portal where a customer manages their own subscriptions |
appstle_subscriptions_list_subscription_groups | Subscription groups (Shopify selling plan groups) with their selling plans (frequency, discount, prepaid settings) and the products and… |
appstle_subscriptions_get_subscription_group | One subscription group (selling plan group) by id with its plans and products |
appstle_subscriptions_list_selling_plans | Every selling plan across all subscription groups in one flat list: selling plan id and name, frequency, discount and group |
appstle_subscriptions_list_product_swaps | Product swap automations of the shop: rules that replace products in subscription orders after a number of cycles, with source and… |
appstle_subscriptions_list_retention_activities | Customer retention activities: each time a customer went through the cancel or pause flow, with the reason, the retention offer shown and… |
appstle_subscriptions_update_contract_status | Pause (PAUSED) or resume (ACTIVE) a subscription |
appstle_subscriptions_cancel_contract | Cancel a subscription contract now: all future billing and deliveries stop and the customer gets the cancellation email if enabled |
appstle_subscriptions_update_next_billing_date | Move the next billing (order) date of a contract |
appstle_subscriptions_update_billing_interval | Change how often the customer is charged, e.g. every 2 WEEK or every 1 MONTH |
appstle_subscriptions_update_delivery_interval | Change how often the subscription is delivered (for prepaid plans this can differ from billing) |
appstle_subscriptions_skip_order | Skip one upcoming (QUEUED) order by its billing attempt id; it stays listed as SKIPPED and later orders are not affected |
appstle_subscriptions_skip_upcoming_order | Skip the next upcoming order of a contract without knowing its billing attempt id |
appstle_subscriptions_unskip_order | Restore a skipped order to QUEUED so it is billed and shipped again; only possible before its billing date |
appstle_subscriptions_reschedule_order | Move one upcoming order to another date; optionally shift the later orders by the same offset |
appstle_subscriptions_bill_order_now | Charge an upcoming order now instead of on its billing date |
appstle_subscriptions_add_line_item | Add a product variant to a subscription, recurring or only for the next order |
appstle_subscriptions_update_line_item | Change a product in a subscription: its quantity, price, variant (swap to another product or flavour) and/or selling plan (frequency), in… |
appstle_subscriptions_remove_line_item | Remove a product from a subscription |
appstle_subscriptions_apply_discount_code | Apply an existing Shopify discount code to the future orders of a subscription |
appstle_subscriptions_add_custom_discount | Give a subscription a manual discount: PERCENTAGE (percentage), FIXED amount off or a fixed PRICE (amount), optionally for a limited number… |
appstle_subscriptions_remove_discount | Remove a discount from a subscription; future orders are priced without it |
appstle_subscriptions_update_shipping_address | Change the delivery address (or delivery method type) of a subscription for future orders |
appstle_subscriptions_update_order_note | Set the note added to every future order of a subscription (empty text clears it) |
appstle_subscriptions_send_payment_method_update_email | Have Shopify email the customer a secure link to update the payment method of a subscription (e.g. after a failed payment) |
Example prompts
- "Which subscriptions bill in the next 7 days? List customer, products and amount."
- "Find the subscriptions of [email protected] and skip her next order."
- "Show the failed renewal payments of the last 30 days and send each customer the payment method update email after I confirm."
- "Why did customers cancel last month? Summarise the retention activities by reason and accepted offer."
- "Change contract 123456 to deliver every 2 months and swap the coffee for the decaf variant. Show me the contract first."
FAQ
Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Next steps
- Connector landing page
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
- Connect to Microsoft Copilot
Was this guide helpful?