# Cratejoy MCP by usefulapi

> Cratejoy MCP by usefulapi is an MCP server. Read Cratejoy subscriptions, customers, orders and shipments; skip or cancel subscriptions. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/cratejoy/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/cratejoy
- **MCP Registry name:** io.usefulapi/cratejoy
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cratejoy.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cratejoy": {
      "url": "https://cratejoy.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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/.

## 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

---
Source: https://ai-powered.com/mcp/cratejoy-mcp-by-usefulapi
