Skip to content

Cratejoy MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.0.1 · published by io.usefulapi

Read Cratejoy subscriptions, customers, orders and shipments; skip or cancel subscriptions.

Deletes · 4Changes · 1

18 tools: 4 can delete or cancel things, 1 change things and 13 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "cratejoy_get_store_metadata" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":true}; The name "cratejoy_get_store_metadata" says "get": a word for reading.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

18 tools

Deletes or cancels 4Claude Code: deny
  • cratejoy_cancel_customer_subscriptionWRITE: cancel a subscriber's subscription in Cratejoy (the customer stops receiving boxes and renewals).No findings

    Why it is in this group

    • The name "cratejoy_cancel_customer_subscription" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: cancel a subscriber's subscription in Cratejoy (the customer stops receiving boxes and renewals). This cancels the merchant's customer subscription, NOT this server's Pro plan (use the *_cancel_subscription tool for that). Requires confirm=true. A cancelled subscription can be restored with cratejoy_reactivate_subscription. PUT /v1/subscriptions/{sub_id}/cancel/.

    Annotations the server declares

    • title: Cancel a customer's subscription
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
  • cratejoy_reactivate_subscriptionWRITE: reactivate a cancelled subscription so it renews and charges the customer again.No findings

    Why it is in this group

    • The description's first verb is "write": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: reactivate a cancelled subscription so it renews and charges the customer again. Requires confirm=true. Reactivating an active subscription changes nothing more. PUT /v1/subscriptions/{sub_id}/reactivate/.

    Annotations the server declares

    • title: Reactivate a customer's subscription
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
  • cratejoy_retry_subscription_renewalWRITE: retry the renewal of a PAST-DUE subscription whose renewal failed within the last 30 days.No findings

    Why it is in this group

    • The description's first verb is "write": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: retry the renewal of a PAST-DUE subscription whose renewal failed within the last 30 days. This charges the customer's saved payment method. Requires confirm=true. PUT /v1/subscriptions/{sub_id}/renew/.

    Annotations the server declares

    • title: Retry a failed renewal
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
  • cratejoy_skip_subscription_renewalWRITE: skip a subscriber's next renewal (action 'skip') or undo the skip (action 'unskip').No findings

    Why it is in this group

    • The description's first verb is "write": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    WRITE: skip a subscriber's next renewal (action 'skip') or undo the skip (action 'unskip'). Requires confirm=true. Repeating the same action changes nothing more. This changes a merchant customer's subscription in Cratejoy; it is not this server's own billing. PUT /v1/subscriptions/{sub_id}/skip/.

    Annotations the server declares

    • title: Skip or unskip next renewal
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: true
    • openWorldHint: true
Changes things 1Claude Code: ask
  • cratejoy_get_store_metadataThe store-level metadata record (id, store_id, created_at, updated_at, data: free-form JSON attached to the store).1 finding

    Why it is in this group

    • The name "cratejoy_get_store_metadata" says "get": a word for reading.
    • The description's first verb is "store": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "cratejoy_get_store_metadata" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":true}; The name "cratejoy_get_store_metadata" says "get": a word for reading.

      What this check looks for
    Description, as the server wrote it
    The store-level metadata record (id, store_id, created_at, updated_at, data: free-form JSON attached to the store). GET /v1/metadata/.

    Annotations the server declares

    • title: Get store metadata
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
Only reads 13Claude Code: allow
  • cratejoy_get_customerOne customer by id, optionally with relationships (addresses, subscriptions, orders, shipments, notes...).No findings

    Why it is in this group

    • The name "cratejoy_get_customer" says "get": a word for reading.
    Description, as the server wrote it
    One customer by id, optionally with relationships (addresses, subscriptions, orders, shipments, notes...). GET /v1/customers/{customer_id}/.

    Annotations the server declares

    • title: Get customer
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_get_orderOne order by id, optionally with relationships (customer, products, coupons, addresses, fulfillments, transactions).No findings

    Why it is in this group

    • The name "cratejoy_get_order" says "get": a word for reading.
    Description, as the server wrote it
    One order by id, optionally with relationships (customer, products, coupons, addresses, fulfillments, transactions). GET /v1/orders/{order_id}/.

    Annotations the server declares

    • title: Get order
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_get_productOne product by id, optionally with relationships.No findings

    Why it is in this group

    • The name "cratejoy_get_product" says "get": a word for reading.
    Description, as the server wrote it
    One product by id, optionally with relationships. GET /v1/products/{prod_id}/.

    Annotations the server declares

    • title: Get product
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_get_shipmentOne shipment by id, optionally with relationships (customer, fulfillments, labels, ship_address, subscriptions).No findings

    Why it is in this group

    • The name "cratejoy_get_shipment" says "get": a word for reading.
    Description, as the server wrote it
    One shipment by id, optionally with relationships (customer, fulfillments, labels, ship_address, subscriptions). GET /v1/shipments/{ship_id}/.

    Annotations the server declares

    • title: Get shipment
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_get_subscriptionOne subscription by id, optionally with relationships (customer, billing, term, product, address, orders, shipments, logs).No findings

    Why it is in this group

    • The name "cratejoy_get_subscription" says "get": a word for reading.
    Description, as the server wrote it
    One subscription by id, optionally with relationships (customer, billing, term, product, address, orders, shipments, logs). GET /v1/subscriptions/{sub_id}/.

    Annotations the server declares

    • title: Get subscription
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_get_transactionOne payment transaction by id.No findings

    Why it is in this group

    • The name "cratejoy_get_transaction" says "get": a word for reading.
    Description, as the server wrote it
    One payment transaction by id. GET /v1/transactions/{trans_id}/.

    Annotations the server declares

    • title: Get transaction
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_list_customersList customers (id, name, email, country, location, num_orders, num_subscriptions, subscription_status, total_revenue).No findings

    Why it is in this group

    • The name "cratejoy_list_customers" says "list": a word for reading.
    Description, as the server wrote it
    List customers (id, name, email, country, location, num_orders, num_subscriptions, subscription_status, total_revenue). Filter by email or name, or with `filters` (e.g. { 'addresses.city': 'Austin' }). Relationships: addresses, logs, carts, notes, orders, shipments, subscriptions. GET /v1/customers/.

    Annotations the server declares

    • title: List customers
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_list_ordersList orders (id, customer_id, placed_at, status, financial_status, fulfillment_status, is_renewal, is_gift, sub_total, total, total_shipping, total_tax).No findings

    Why it is in this group

    • The name "cratejoy_list_orders" says "list": a word for reading.
    Description, as the server wrote it
    List orders (id, customer_id, placed_at, status, financial_status, fulfillment_status, is_renewal, is_gift, sub_total, total, total_shipping, total_tax). Amounts are in cents. Filter by payment status and placed-at range, or with `filters`. Relationships: customer, products, coupons, bill_address, ship_address, fulfillments, transactions, subscriptions. GET /v1/orders/.

    Annotations the server declares

    • title: List orders
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_list_productsList products (id, name, sku, slug, description, visible, listed, giftable, ship_option, ship_weight, has_subscribers).No findings

    Why it is in this group

    • The name "cratejoy_list_products" says "list": a word for reading.
    Description, as the server wrote it
    List products (id, name, sku, slug, description, visible, listed, giftable, ship_option, ship_weight, has_subscribers). Filter by type or with `filters` (e.g. { 'visible': true }). Relationships: billing, instances, variants, subscription_types. GET /v1/products/.

    Annotations the server declares

    • title: List products
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_list_shipmentsList shipments (id, customer_id, status, created_at, target_at, shipped_at, tracking_number, is_gift).No findings

    Why it is in this group

    • The name "cratejoy_list_shipments" says "list": a word for reading.
    Description, as the server wrote it
    List shipments (id, customer_id, status, created_at, target_at, shipped_at, tracking_number, is_gift). Filter by status and creation range, or with `filters`. Relationships: customer, fulfillments, labels, ship_address, subscriptions. GET /v1/shipments/.

    Annotations the server declares

    • title: List shipments
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_list_subscription_couponsCoupons applied to a subscription's next renewal (coupon_id, code_used, enabled, num_renewals).No findings

    Why it is in this group

    • The name "cratejoy_list_subscription_coupons" says "list": a word for reading.
    Description, as the server wrote it
    Coupons applied to a subscription's next renewal (coupon_id, code_used, enabled, num_renewals). GET /v1/subscriptions/{sub_id}/coupons/.

    Annotations the server declares

    • title: List subscription coupons
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_list_subscriptionsList subscriptions (id, status, autorenew, billing_name, start_date, end_date, skipped_date, is_test, product_billing_id).No findings

    Why it is in this group

    • The name "cratejoy_list_subscriptions" says "list": a word for reading.
    Description, as the server wrote it
    List subscriptions (id, status, autorenew, billing_name, start_date, end_date, skipped_date, is_test, product_billing_id). Filter by status and end-date range, or with `filters` (e.g. { 'customer.email__like': '%@example.com' }). Relationships: customer, billing, term, product, address, orders, shipments, logs. GET /v1/subscriptions/.

    Annotations the server declares

    • title: List subscriptions
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • cratejoy_list_transactionsList payment transactions (id, created_at, result: authorized/captured/failed/refunded, total in cents, is_test, order).No findings

    Why it is in this group

    • The name "cratejoy_list_transactions" says "list": a word for reading.
    Description, as the server wrote it
    List payment transactions (id, created_at, result: authorized/captured/failed/refunded, total in cents, is_test, order). Filter by result and creation range, or with `filters`. GET /v1/transactions/.

    Annotations the server declares

    • title: List transactions
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.1. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__cratejoy__cratejoy_list_customers",
      "mcp__cratejoy__cratejoy_get_customer",
      "mcp__cratejoy__cratejoy_list_subscriptions",
      "mcp__cratejoy__cratejoy_get_subscription",
      "mcp__cratejoy__cratejoy_list_subscription_coupons",
      "mcp__cratejoy__cratejoy_list_orders",
      "mcp__cratejoy__cratejoy_get_order",
      "mcp__cratejoy__cratejoy_list_shipments",
      "mcp__cratejoy__cratejoy_get_shipment",
      "mcp__cratejoy__cratejoy_list_products",
      "mcp__cratejoy__cratejoy_get_product",
      "mcp__cratejoy__cratejoy_list_transactions",
      "mcp__cratejoy__cratejoy_get_transaction"
    ],
    "ask": [
      "mcp__cratejoy__cratejoy_get_store_metadata"
    ],
    "deny": [
      "mcp__cratejoy__cratejoy_skip_subscription_renewal",
      "mcp__cratejoy__cratejoy_cancel_customer_subscription",
      "mcp__cratejoy__cratejoy_reactivate_subscription",
      "mcp__cratejoy__cratejoy_retry_subscription_renewal"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as cratejoy. Review it before you use it.