Skip to content
MCP server

Cratejoy MCP by usefulapi

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

Install
Runs
Remotely
Version
1.24.0
Listing updated
4 days ago

About Cratejoy MCP by usefulapi

Cratejoy MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://cratejoy.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cratejoy": {
      "url": "https://cratejoy.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cratejoy": {
      "serverUrl": "https://cratejoy.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cratejoy": {
      "type": "http",
      "url": "https://cratejoy.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (18)

Read directly from the server.

cratejoy_get_store_metadata
The store-level metadata record (id, store_id, created_at, updated_at, data: free-form JSON attached to the store). GET /v1/metadata/.
cratejoy_list_customers
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/.
cratejoy_get_customer
One customer by id, optionally with relationships (addresses, subscriptions, orders, shipments, notes...). GET /v1/customers/{customer_id}/.
cratejoy_list_subscriptions
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/.
cratejoy_get_subscription
One subscription by id, optionally with relationships (customer, billing, term, product, address, orders, shipments, logs). GET /v1/subscriptions/{sub_id}/.
cratejoy_list_subscription_coupons
Coupons applied to a subscription's next renewal (coupon_id, code_used, enabled, num_renewals). GET /v1/subscriptions/{sub_id}/coupons/.
cratejoy_list_orders
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/.
cratejoy_get_order
One order by id, optionally with relationships (customer, products, coupons, addresses, fulfillments, transactions). GET /v1/orders/{order_id}/.
cratejoy_list_shipments
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/.
cratejoy_get_shipment
One shipment by id, optionally with relationships (customer, fulfillments, labels, ship_address, subscriptions). GET /v1/shipments/{ship_id}/.
cratejoy_list_products
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/.
cratejoy_get_product
One product by id, optionally with relationships. GET /v1/products/{prod_id}/.
cratejoy_list_transactions
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/.
cratejoy_get_transaction
One payment transaction by id. GET /v1/transactions/{trans_id}/.
cratejoy_skip_subscription_renewal
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/.
cratejoy_cancel_customer_subscription
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/.
cratejoy_reactivate_subscription
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/.
cratejoy_retry_subscription_renewal
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/.

Cratejoy MCP by usefulapi FAQ

How do I add Cratejoy MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http cratejoy https://cratejoy.usefulapi.io/mcp