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.
18 tools: 4 can delete or cancel things, 1 change things and 13 only read.
Scanned Oct 21, 2026
- Deletes or cancels4Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things1Claude Code: ask: see these tools
- Only reads13Claude Code: allow: see these tools
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/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "cratejoy_get_store_metadata" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":true}; The name "cratejoy_get_store_metadata" says "get": a word for reading.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":true}; The name "cratejoy_get_store_metadata" says "get": a word for reading.
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/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .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.