MCP server

Smartrr MCP by usefulapi

io.usefulapi/smartrr

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

21

Token cost

About 4,833 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http smartrr https://smartrr.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.smartrr]
url = "https://smartrr.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"smartrr":{"httpUrl":"https://smartrr.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"smartrr":{"url":"https://smartrr.usefulapi.io/mcp"}}}

VS Code

{"servers":{"smartrr":{"type":"http","url":"https://smartrr.usefulapi.io/mcp"}}}

Antigravity

agy mcp add smartrr https://smartrr.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"smartrr","server_url":"https://smartrr.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"smartrr","server_url":"https://smartrr.usefulapi.io/mcp"}

Tools

• smartrr_cancel_customer_subscription ~300 tokens
  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_
• smartrr_get_analytics ~127 tokens
  Active subscription count and active subscriber count for each day in a date range. GET /vendor/analytics-simple.
• smartrr_get_bill_history ~123 tokens
  The audit trail of one bill: every status change, retry and error. GET /vendor/bill/{billId}/history.
• smartrr_get_order ~131 tokens
  One order by its Shopify order id (the `shopifyId` field in smartrr_list_orders, passed as shown). GET /vendor/orders/{shopifyId}.
• smartrr_get_subscription ~196 tokens
  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
• smartrr_get_subscription_bills ~281 tokens
  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.
• smartrr_get_subscription_events ~170 tokens
  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.
• smartrr_get_subscription_orders ~254 tokens
  Orders generated by one subscription, by its Shopify subscription id. GET /vendor/purchase-state/{shopifySubscriptionId}/orders.
• smartrr_list_bills ~366 tokens
  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).
• smartrr_list_cancellation_reasons ~100 tokens
  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.
• smartrr_list_customer_subscriptions ~260 tokens
  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/.
• smartrr_list_customers ~286 tokens
  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.
• smartrr_list_orders ~318 tokens
  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.
• smartrr_list_selling_plan_groups ~94 tokens
  The store's subscription programs (selling plan groups) and their plans: name, options, delivery and billing frequency, discounts. GET /vendor/selling-plan-group.
• smartrr_list_subscriptions ~438 tokens
  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), `custR
• smartrr_pause_subscription ~247 tokens
  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-s
• smartrr_resume_subscription ~234 tokens
  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.
• smartrr_retry_bill ~233 tokens
  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 conf
• smartrr_set_next_billing_date ~213 tokens
  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.
• smartrr_skip_order ~237 tokens
  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.
• smartrr_unskip_order ~225 tokens
  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.

Browse

• Website monitoring
• Email
• Payments
• Online shops

Related MCP servers

• Seal Subscriptions MCP by usefulapi
  Manage Seal Subscriptions on Shopify: subscriptions, billing attempts, items, discounts, rules.
• Awtomic MCP by usefulapi
  Read Awtomic subscriptions, customers and billing attempts; pause, skip, reschedule, cancel.
• Recharge MCP by usefulapi
  Read subscriptions, customers, charges, orders; skip charges, cancel or activate subscriptions.
• Cratejoy MCP by usefulapi
  Read Cratejoy subscriptions, customers, orders and shipments; skip or cancel subscriptions.
• Autumn MCP by usefulapi
  MCP server for Autumn — read customers, plans, balances & invoices; track usage and attach plans.
• Lemon Squeezy MCP by usefulapi
  MCP server for Lemon Squeezy — stores, products, orders, subscriptions, license keys.
• Appointo MCP by usefulapi
  Read Appointo bookings, availability and subscriptions; create, reschedule and cancel bookings.
• Swell MCP by usefulapi
  Manage your Swell headless-commerce store — products, orders, customers, and subscriptions.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/smartrr.svg)](https://aptlynx.net/servers/io.usefulapi/smartrr)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents