MCP server
Cratejoy MCP by usefulapi
Read Cratejoy subscriptions, customers, orders and shipments; skip or cancel…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://cratejoy.usefulapi.io/mcpInstall 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