Smartrr MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.16.4Updated Nov 7, 2026

Manage Smartrr subscriptions on Shopify: customers, orders, bills; pause, resume, cancel.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted Smartrr MCP server that lets an assistant read and change Shopify subscription data: customers, orders, bills, pauses, cancels and billing retries.

What you can do
  • List and inspect subscriptions, a customer's subscriptions, subscription events, orders and bills
  • Search customers and orders, and read individual orders by Shopify order id
  • Review billing attempts, bill history, selling plan groups, cancellation reasons and daily subscription analytics
  • Pause, resume, cancel, skip or unskip a subscription and change its next billing date
  • Retry a failed bill, which charges the customer's saved payment method
  • Check usage, request a feature, and upgrade or cancel the paid plan
When to use it
Useful for Shopify merchants running Smartrr subscriptions who want to ask questions in plain language about renewals, failed bills or churn, and to make routine subscription changes such as pausing, skipping or cancelling without opening the Smartrr dashboard.
Requirements
Remote MCP endpoint added by URL only; the server signs in with OAuth and the login page asks for Smartrr credentials. On first connect you paste a Smartrr API access token from the Shopify admin (Apps, Smartrr, Integrations). No API key or Authorization header goes in the client config. Free plan allows 50 tool calls per month.
Before you install
Several tools change live customer data: cancel is destructive and stops all future orders and charges, resume and next-billing-date restart charges, and retry_bill charges the customer's saved card and is not idempotent. Confirm before any write. The Smartrr API token is a store credential. Paid plans cost $9/month or $90/year (Pro) and $39/month or $390/year (Pro+), billed through Stripe checkout links, with no refund for the current period on cancellation.

Installation

In SourceWeft

  1. Open Smartrr MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fsmartrr/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "smartrr-by-usefulapi": {
      "type": "http",
      "url": "https://smartrr.usefulapi.io/mcp"
    }
  }
}

README

Smartrr MCP by usefulapi

Manage Smartrr subscriptions on Shopify: customers, orders, bills; pause, resume, cancel.

Live endpoint: https://smartrr.usefulapi.io/mcp · Homepage: https://usefulapi.io/smartrr

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://smartrr.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http smartrr https://smartrr.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "smartrr": {      "url": "https://smartrr.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Smartrr credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/smartrr/

On first connect you'll paste your Smartrr API access token (Shopify admin → Apps → Smartrr → Integrations).

Tools

ToolTypeWhat it does
smartrr_list_subscriptionsreadList subscriptions
smartrr_get_subscriptionreadGet subscription
smartrr_list_customer_subscriptionsreadList a customer's subscriptions
smartrr_get_subscription_eventsreadGet subscription history
smartrr_get_subscription_ordersreadList a subscription's orders
smartrr_get_subscription_billsreadList a subscription's bills
smartrr_list_customersreadList customers
smartrr_list_ordersreadList orders
smartrr_get_orderreadGet order
smartrr_list_billsreadList bills
smartrr_get_bill_historyreadGet bill history
smartrr_list_selling_plan_groupsreadList subscription programs
smartrr_list_cancellation_reasonsreadList cancellation reasons
smartrr_get_analyticsreadGet subscription analytics
smartrr_pause_subscriptionwritePause a subscription
smartrr_resume_subscriptionwriteResume a subscription
smartrr_cancel_customer_subscriptionwriteCancel a customer's subscription
smartrr_skip_orderwriteSkip a subscription order
smartrr_unskip_orderwriteUnskip a subscription order
smartrr_set_next_billing_datewriteSet next billing date
smartrr_retry_billwriteRetry a failed bill
smartrr_usage_statusmetaUsage status (free-tier meter)
smartrr_request_featuremetaRequest a missing feature
smartrr_upgrademetaUpgrade to Pro or Pro+
smartrr_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with smartrr_upgrade (it returns a Stripe Checkout link). Cancel any time with smartrr_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running smartrr_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Smartrr.

Source: servers/smartrr/README.md at commit 4046075

Tools

21

smartrr_list_subscriptions

List subscriptions

List customer subscriptions (Smartrr 'purchase states') with status, next billing date, selling plan, line items, shipping address, discounts and the customer (id, email, name). Filter by status, next billing date or creation date. The ids you need for the other tools: `id` (subscription id), `custRel.id` (customer id) and `shopifyId` (Shopify subscription id). GET /vendor/purchase-state.

Parameterspagesortstatuspage_sizecreated_aftercreated_beforenext_billing_afternext_billing_before

smartrr_get_subscription

Get subscription

One subscription by its Shopify subscription id (the `shopifyId` field from smartrr_list_subscriptions, passed exactly as shown): status, schedule, next billing date, line items, discounts, shipping address, customer and payment method (brand, last digits and expiry only). GET /vendor/purchase-state/{shopifySubscriptionId}.

Parametersshopify_subscription_idrequired

smartrr_list_customer_subscriptions

List a customer's subscriptions

List the subscriptions of one customer, by Smartrr customer id (`custRel.id` from smartrr_list_subscriptions, or `id` from smartrr_list_customers). GET /vendor/customer/{customerRelationshipId}/purchase-state/.

Parameterspagestatuspage_sizecustomer_idrequired

smartrr_get_subscription_events

Get subscription history

The 250 most recent events on a subscription (pause, skip, cancel, activate, billing attempts and failures, line-item and address changes, discounts) with who did it. GET /vendor/purchase-state/{shopifySubscriptionId}/events.

Parametersshopify_subscription_idrequired

smartrr_get_subscription_orders

List a subscription's orders

Orders generated by one subscription, by its Shopify subscription id. GET /vendor/purchase-state/{shopifySubscriptionId}/orders.

Parameterspagesortpage_sizeshopify_subscription_idrequired

smartrr_get_subscription_bills

List a subscription's bills

Billing attempts of one subscription (amount, status pending/processing/succeeded/failed/canceled, billing date, retry count, error), by its Shopify subscription id. GET /vendor/purchase-state/{shopifySubscriptionId}/bills.

Parameterspagesortpage_sizeshopify_subscription_idrequired

smartrr_list_customers

List customers

List Smartrr customers (subscribers) with email, name, phone, order count, total spent and custom attributes. Search by email fragment or filter by Shopify customer id. GET /vendor/customer-relationship.

Parameterspagesortemailpage_sizeshopify_customer_id

smartrr_list_orders

List orders

List orders Smartrr has synced from Shopify (subscription and one-time) with totals, status, financial and fulfillment status, tracking, items and customer. Filter by processed date or order label (e.g. #1001). GET /vendor/order.

Parameterspagesortpage_sizeorder_labelprocessed_afterprocessed_before

smartrr_get_order

Get order

One order by its Shopify order id (the `shopifyId` field in smartrr_list_orders, passed as shown). GET /vendor/orders/{shopifyId}.

Parametersshopify_order_idrequired

smartrr_list_bills

List bills

List billing attempts across all subscriptions with amount, status (pending, processing, succeeded, failed, canceled), billing date, retry count, error and the subscription and customer. Filter by billing date; `status` filters the returned page only (use page_size 100 and next_page to cover more). Bill ids are numbers. GET /vendor/bill.

Parameterspagesortstatuspage_sizebilling_afterbilling_before

smartrr_get_bill_history

Get bill history

The audit trail of one bill: every status change, retry and error. GET /vendor/bill/{billId}/history.

Parametersbill_idrequired

smartrr_list_selling_plan_groups

List subscription programs

The store's subscription programs (selling plan groups) and their plans: name, options, delivery and billing frequency, discounts. GET /vendor/selling-plan-group.

Takes no parameters.

smartrr_list_cancellation_reasons

List cancellation reasons

The cancellation reasons configured in Smartrr (id, type, text, action, retention discount). Use an `id` as reason_id when cancelling a subscription. GET /vendor/cancellation-reasons.

Takes no parameters.

smartrr_get_analytics

Get subscription analytics

Active subscription count and active subscriber count for each day in a date range. GET /vendor/analytics-simple.

Parametersend_daterequiredstart_daterequired

smartrr_pause_subscription

Pause a subscription

WRITE: pause a customer's subscription until a date: no orders or charges are created while it is paused, then it resumes on that date. Reverse it with smartrr_resume_subscription. Takes the customer id and subscription id from smartrr_list_subscriptions. PUT /vendor/customer/{customerId}/purchase-state/{subscriptionId}/pause.

Parameterscustomer_idrequiredunpause_daterequiredsubscription_idrequired

smartrr_resume_subscription

Resume a subscription

WRITE: reactivate a paused or cancelled subscription; the customer will be billed on next_billing_date and every cycle after. Customer-facing: it restarts charges to the customer's card. PUT /vendor/customer/{customerId}/purchase-state/{subscriptionId}/activate.

Parameterscustomer_idrequiredsubscription_idrequirednext_billing_daterequired

smartrr_cancel_customer_subscription

Cancel a customer's subscription

WRITE, DESTRUCTIVE: cancel a customer's subscription in the merchant's store (this is the customer's Smartrr subscription, not your usefulapi plan). It stops all future orders and charges; the reason may trigger Smartrr's configured cancellation emails or actions. It can be undone only with smartrr_resume_subscription. Get reason_id from smartrr_list_cancellation_reasons. PUT /vendor/customer/{customerId}/purchase-state/{subscriptionId}/cancel.

Parametersreason_idrequiredcustomer_idrequiredsubscription_idrequired

smartrr_skip_order

Skip a subscription order

WRITE: skip one scheduled order of a subscription (no order and no charge for that cycle; the schedule moves on). `date` is the scheduled order date to skip; omit it to skip the next one. Reverse with smartrr_unskip_order. PUT /vendor/customer/{customerId}/purchase-state/{subscriptionId}/skip.

Parametersdatecustomer_idrequiredsubscription_idrequired

smartrr_unskip_order

Unskip a subscription order

WRITE: restore a previously skipped order of a subscription, so it is billed and shipped again. `date` is the skipped order date; omit it to restore the earliest skip. PUT /vendor/customer/{customerId}/purchase-state/{subscriptionId}/unskip.

Parametersdatecustomer_idrequiredsubscription_idrequired

smartrr_set_next_billing_date

Set next billing date

WRITE: change the date on which a subscription is next billed and its order created. Customer-facing: the customer is charged on the new date. PUT /vendor/customer/{customerId}/purchase-state/{subscriptionId}/next-billing-date.

Parametersdaterequiredcustomer_idrequiredsubscription_idrequired

smartrr_retry_bill

Retry a failed bill

WRITE, CHARGES THE CUSTOMER: retry a billing attempt now. If it succeeds the customer's saved payment method is charged for the bill amount and the order is created. Check the bill with smartrr_list_bills first; do not retry a succeeded bill. Not idempotent: each call can charge again. Requires confirm=true. POST /vendor/bill/{billId}/retry.

Parametersbill_idrequiredconfirmrequired

Version history

15
  1. v1.16.4LatestNov 7, 2026
  2. v1.15.3Nov 5, 2026
  3. v1.15.2Nov 5, 2026
  4. v1.15.1Nov 4, 2026
  5. v1.15.0Nov 3, 2026
  6. v1.14.1Nov 3, 2026
  7. v1.13.0Nov 1, 2026
  8. v1.11.0Oct 31, 2026
  9. v1.10.0Oct 31, 2026
  10. v1.9.2Oct 30, 2026
  11. v1.9.0Oct 30, 2026
  12. v1.4.0Oct 26, 2026
  13. v1.1.3Oct 25, 2026
  14. v1.1.0Oct 25, 2026
  15. v1.0.0Oct 24, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026