{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "smartrr.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "104.21.62.184",
        "endpoints": 881,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "172.67.138.37",
        "endpoints": 881,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 881,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 881,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.62.184",
          "172.67.138.37",
          "2606:4700:3032::6815:3eb8",
          "2606:4700:3030::ac43:8a25"
        ],
        "first_seen": "2026-11-22T21:11:01.845Z",
        "last_seen": "2026-11-22T21:11:01.845Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "smartrr-mcp",
      "version": "1.20.4",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 880,
      "sample": [
        {
          "id": "22186",
          "url": "https://mcp.easyscribe.guide/mcp",
          "server_name": "guide.easyscribe/easy-scribe",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T17:59:02.319Z"
        },
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        }
      ]
    },
    "same_site": {
      "total": 1097,
      "sample": [
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        },
        {
          "id": "42106",
          "url": "https://adminpulse.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adminpulse",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:29:00.620Z"
        }
      ]
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.usefulapi",
      "total": 1097,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "same_repository": {
      "repository_url": "https://github.com/m190/usefulapi-mcp",
      "total": 1097,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "42947",
    "server_name": "io.usefulapi/smartrr",
    "url": "https://smartrr.usefulapi.io/mcp",
    "host": "smartrr.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T21:11:01.845Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "3e7bc2f311450a9965787bb8bff75b86e6d397cfb49333f43fe90298a11f571d",
    "first_listed_at": "2026-11-22T21:11:01.845Z",
    "created_at": "2026-11-21T12:45:10.622Z",
    "resolved_addresses": [
      "104.21.62.184",
      "172.67.138.37",
      "2606:4700:3032::6815:3eb8",
      "2606:4700:3030::ac43:8a25"
    ]
  },
  "server": {
    "name": "io.usefulapi/smartrr",
    "title": "Smartrr MCP by usefulapi",
    "description": "Manage Smartrr subscriptions on Shopify: customers, orders, bills; pause, resume, cancel.",
    "version": "1.20.4",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/smartrr/",
    "published_at": "2026-11-18T11:02:33.337Z",
    "updated_at": "2026-11-18T11:02:33.337Z",
    "first_seen": "2026-11-21T12:45:09.976Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "takes-payment"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T21:11:12.987Z"
  },
  "operator": {
    "key": "usefulapi.io",
    "name": "usefulapi.io",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 236,
    "first_check_in_window": "2026-11-22T21:11:01.845Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "3e7bc2f311450a9965787bb8bff75b86e6d397cfb49333f43fe90298a11f571d",
    "tools": 21,
    "resources": 0,
    "prompts": 7,
    "first_seen": "2026-11-22T21:11:02.097Z",
    "tool_names": [
      "smartrr_list_subscriptions",
      "smartrr_get_subscription",
      "smartrr_list_customer_subscriptions",
      "smartrr_get_subscription_events",
      "smartrr_get_subscription_orders",
      "smartrr_get_subscription_bills",
      "smartrr_list_customers",
      "smartrr_list_orders",
      "smartrr_get_order",
      "smartrr_list_bills",
      "smartrr_get_bill_history",
      "smartrr_list_selling_plan_groups",
      "smartrr_list_cancellation_reasons",
      "smartrr_get_analytics",
      "smartrr_pause_subscription",
      "smartrr_resume_subscription",
      "smartrr_cancel_customer_subscription",
      "smartrr_skip_order",
      "smartrr_unskip_order",
      "smartrr_set_next_billing_date",
      "smartrr_retry_bill"
    ],
    "declared": {
      "tools": [
        {
          "name": "smartrr_list_subscriptions",
          "title": "List subscriptions",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
                "exclusiveMinimum": 0
              },
              "sort": {
                "enum": [
                  "newest",
                  "oldest"
                ],
                "type": "string",
                "description": "Sort by creation date (default: Smartrr's own order)."
              },
              "status": {
                "enum": [
                  "ACTIVE",
                  "PAUSED",
                  "CANCELLED",
                  "EXPIRED",
                  "FAILED"
                ],
                "type": "string",
                "description": "Only subscriptions in this status."
              },
              "page_size": {
                "type": "integer",
                "maximum": 100,
                "description": "Results per page, 1-100 (default 25).",
                "exclusiveMinimum": 0
              },
              "created_after": {
                "type": "string",
                "description": "Only subscriptions created on or after this date."
              },
              "created_before": {
                "type": "string",
                "description": "Only subscriptions created on or before this date."
              },
              "next_billing_after": {
                "type": "string",
                "description": "Only subscriptions whose next billing date is on or after this date."
              },
              "next_billing_before": {
                "type": "string",
                "description": "Only subscriptions whose next billing date is on or before this date."
              }
            }
          },
          "annotations": {
            "title": "List subscriptions",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_get_subscription",
          "title": "Get subscription",
          "description": "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}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "shopify_subscription_id"
            ],
            "properties": {
              "shopify_subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The subscription's Shopify id (`shopifyId` in smartrr_list_subscriptions)."
              }
            }
          },
          "annotations": {
            "title": "Get subscription",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_list_customer_subscriptions",
          "title": "List a customer's subscriptions",
          "description": "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/.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
                "exclusiveMinimum": 0
              },
              "status": {
                "enum": [
                  "ACTIVE",
                  "PAUSED",
                  "CANCELLED",
                  "EXPIRED",
                  "FAILED"
                ],
                "type": "string",
                "description": "Only subscriptions in this status."
              },
              "page_size": {
                "type": "integer",
                "maximum": 100,
                "description": "Results per page, 1-100 (default 25).",
                "exclusiveMinimum": 0
              },
              "customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr customer id."
              }
            }
          },
          "annotations": {
            "title": "List a customer's subscriptions",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_get_subscription_events",
          "title": "Get subscription history",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "shopify_subscription_id"
            ],
            "properties": {
              "shopify_subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The subscription's Shopify id (`shopifyId` in smartrr_list_subscriptions)."
              }
            }
          },
          "annotations": {
            "title": "Get subscription history",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_get_subscription_orders",
          "title": "List a subscription's orders",
          "description": "Orders generated by one subscription, by its Shopify subscription id. GET /vendor/purchase-state/{shopifySubscriptionId}/orders.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "shopify_subscription_id"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
                "exclusiveMinimum": 0
              },
              "sort": {
                "enum": [
                  "newest",
                  "oldest"
                ],
                "type": "string",
                "description": "Sort by creation date (default: Smartrr's own order)."
              },
              "page_size": {
                "type": "integer",
                "maximum": 100,
                "description": "Results per page, 1-100 (default 25).",
                "exclusiveMinimum": 0
              },
              "shopify_subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The subscription's Shopify id (`shopifyId` in smartrr_list_subscriptions)."
              }
            }
          },
          "annotations": {
            "title": "List a subscription's orders",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_get_subscription_bills",
          "title": "List a subscription's bills",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "shopify_subscription_id"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
                "exclusiveMinimum": 0
              },
              "sort": {
                "enum": [
                  "newest",
                  "oldest"
                ],
                "type": "string",
                "description": "Sort by creation date (default: Smartrr's own order)."
              },
              "page_size": {
                "type": "integer",
                "maximum": 100,
                "description": "Results per page, 1-100 (default 25).",
                "exclusiveMinimum": 0
              },
              "shopify_subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The subscription's Shopify id (`shopifyId` in smartrr_list_subscriptions)."
              }
            }
          },
          "annotations": {
            "title": "List a subscription's bills",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_list_customers",
          "title": "List customers",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
                "exclusiveMinimum": 0
              },
              "sort": {
                "enum": [
                  "newest",
                  "oldest"
                ],
                "type": "string",
                "description": "Sort by creation date (default: Smartrr's own order)."
              },
              "email": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Customers whose email contains this text."
              },
              "page_size": {
                "type": "integer",
                "maximum": 100,
                "description": "Results per page, 1-100 (default 25).",
                "exclusiveMinimum": 0
              },
              "shopify_customer_id": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Only the customer with this Shopify customer id."
              }
            }
          },
          "annotations": {
            "title": "List customers",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_list_orders",
          "title": "List orders",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
                "exclusiveMinimum": 0
              },
              "sort": {
                "enum": [
                  "newest",
                  "oldest"
                ],
                "type": "string",
                "description": "Sort by creation date (default: Smartrr's own order)."
              },
              "page_size": {
                "type": "integer",
                "maximum": 100,
                "description": "Results per page, 1-100 (default 25).",
                "exclusiveMinimum": 0
              },
              "order_label": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Orders whose Shopify order label contains this text, e.g. #1001."
              },
              "processed_after": {
                "type": "string",
                "description": "Only orders processed on or after this date."
              },
              "processed_before": {
                "type": "string",
                "description": "Only orders processed on or before this date."
              }
            }
          },
          "annotations": {
            "title": "List orders",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_get_order",
          "title": "Get order",
          "description": "One order by its Shopify order id (the `shopifyId` field in smartrr_list_orders, passed as shown). GET /vendor/orders/{shopifyId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "shopify_order_id"
            ],
            "properties": {
              "shopify_order_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The order's Shopify id (`shopifyId` in smartrr_list_orders)."
              }
            }
          },
          "annotations": {
            "title": "Get order",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_list_bills",
          "title": "List bills",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 100000,
                "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
                "exclusiveMinimum": 0
              },
              "sort": {
                "enum": [
                  "newest",
                  "oldest"
                ],
                "type": "string",
                "description": "Sort by creation date (default: Smartrr's own order)."
              },
              "status": {
                "enum": [
                  "pending",
                  "processing",
                  "succeeded",
                  "failed",
                  "canceled"
                ],
                "type": "string",
                "description": "Keep only bills in this status (applied to the fetched page, not server-side)."
              },
              "page_size": {
                "type": "integer",
                "maximum": 100,
                "description": "Results per page, 1-100 (default 25).",
                "exclusiveMinimum": 0
              },
              "billing_after": {
                "type": "string",
                "description": "Only bills with a billing date on or after this date."
              },
              "billing_before": {
                "type": "string",
                "description": "Only bills with a billing date on or before this date."
              }
            }
          },
          "annotations": {
            "title": "List bills",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_get_bill_history",
          "title": "Get bill history",
          "description": "The audit trail of one bill: every status change, retry and error. GET /vendor/bill/{billId}/history.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "bill_id"
            ],
            "properties": {
              "bill_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Smartrr bill id (numeric `id` in smartrr_list_bills).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get bill history",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_list_selling_plan_groups",
          "title": "List subscription programs",
          "description": "The store's subscription programs (selling plan groups) and their plans: name, options, delivery and billing frequency, discounts. GET /vendor/selling-plan-group.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List subscription programs",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_list_cancellation_reasons",
          "title": "List cancellation reasons",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "annotations": {
            "title": "List cancellation reasons",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_get_analytics",
          "title": "Get subscription analytics",
          "description": "Active subscription count and active subscriber count for each day in a date range. GET /vendor/analytics-simple.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "start_date",
              "end_date"
            ],
            "properties": {
              "end_date": {
                "type": "string",
                "description": "Last day of the range."
              },
              "start_date": {
                "type": "string",
                "description": "First day of the range."
              }
            }
          },
          "annotations": {
            "title": "Get subscription analytics",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_pause_subscription",
          "title": "Pause a subscription",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id",
              "subscription_id",
              "unpause_date"
            ],
            "properties": {
              "customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr customer id (`custRel.id`)."
              },
              "unpause_date": {
                "type": "string",
                "description": "When the subscription resumes."
              },
              "subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr subscription id (`id`, a UUID)."
              }
            }
          },
          "annotations": {
            "title": "Pause a subscription",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_resume_subscription",
          "title": "Resume a subscription",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id",
              "subscription_id",
              "next_billing_date"
            ],
            "properties": {
              "customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr customer id (`custRel.id`)."
              },
              "subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr subscription id (`id`, a UUID)."
              },
              "next_billing_date": {
                "type": "string",
                "description": "The next billing date after reactivation."
              }
            }
          },
          "annotations": {
            "title": "Resume a subscription",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_cancel_customer_subscription",
          "title": "Cancel a customer's subscription",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id",
              "subscription_id",
              "reason_id"
            ],
            "properties": {
              "reason_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Cancellation reason id from smartrr_list_cancellation_reasons."
              },
              "customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr customer id (`custRel.id`)."
              },
              "subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr subscription id (`id`, a UUID)."
              }
            }
          },
          "annotations": {
            "title": "Cancel a customer's subscription",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "smartrr_skip_order",
          "title": "Skip a subscription order",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id",
              "subscription_id"
            ],
            "properties": {
              "date": {
                "type": "string",
                "description": "The scheduled order date to skip (default: the next order)."
              },
              "customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr customer id (`custRel.id`)."
              },
              "subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr subscription id (`id`, a UUID)."
              }
            }
          },
          "annotations": {
            "title": "Skip a subscription order",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_unskip_order",
          "title": "Unskip a subscription order",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id",
              "subscription_id"
            ],
            "properties": {
              "date": {
                "type": "string",
                "description": "The skipped order date to restore (default: the earliest skipped one)."
              },
              "customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr customer id (`custRel.id`)."
              },
              "subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr subscription id (`id`, a UUID)."
              }
            }
          },
          "annotations": {
            "title": "Unskip a subscription order",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_set_next_billing_date",
          "title": "Set next billing date",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id",
              "subscription_id",
              "date"
            ],
            "properties": {
              "date": {
                "type": "string",
                "description": "The new next billing date."
              },
              "customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr customer id (`custRel.id`)."
              },
              "subscription_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Smartrr subscription id (`id`, a UUID)."
              }
            }
          },
          "annotations": {
            "title": "Set next billing date",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "smartrr_retry_bill",
          "title": "Retry a failed bill",
          "description": "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.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "bill_id",
              "confirm"
            ],
            "properties": {
              "bill_id": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Smartrr bill id (numeric `id` in smartrr_list_bills).",
                "exclusiveMinimum": 0
              },
              "confirm": {
                "type": "boolean",
                "const": true,
                "description": "Must be true: confirms the customer's saved payment method should be charged now."
              }
            }
          },
          "annotations": {
            "title": "Retry a failed bill",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with Smartrr here, with example requests to try."
        },
        {
          "name": "find_subscriptions_with_failed_bills",
          "description": "The AI lists billing attempts with amount, status, retry count and error, and shows the subscription and customer behind each failed one."
        },
        {
          "name": "list_subscriptions_that_renew_soon",
          "description": "The AI lists subscriptions filtered by status and next billing date, with line items, selling plan and customer."
        },
        {
          "name": "review_the_history_and_orders_of_a_customer_s_subscription",
          "description": "The AI finds a customer, lists their subscriptions, and reads the recent events (pause, skip, cancel, billing failures) and orders of one subscription."
        },
        {
          "name": "track_active_subscriptions_and_subscribers_per_day",
          "description": "The AI reads the number of active subscriptions and active subscribers for each day in a date range, so you can see the trend."
        },
        {
          "name": "pause_resume_or_cancel_a_subscription",
          "description": "The AI pauses a subscription until a date, resumes a paused or cancelled one, or cancels it with a cancellation reason."
        },
        {
          "name": "skip_an_order_move_a_billing_date_or_retry_a_failed_bill",
          "description": "The AI skips a scheduled order, sets a new next billing date, or checks the bills and retries a failed one. A retry charges the customer."
        }
      ]
    },
    "instructions": "Tools for Smartrr, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"Which subscriptions have a failed bill this week?\"; \"Show every active subscription that renews in the next 7 days.\"; \"Pause the subscription of jane@example.com until January 15.\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Smartrr data. Free plan: 50 tool calls per month. Run smartrr_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run smartrr_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run smartrr_upgrade without a plan: it returns both plans, each with a payment link for the user to open. smartrr_cancel_subscription cancels Pro at the end of the paid period."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}