Copy page

Subbly MCP server

Tools

The server exposes 106 tools. Each one wraps one Private API endpoint and takes the same fields, so the endpoint's reference page is where you read what a field means and what comes back. The tables below map every tool to its endpoint.

Tools that archive or delete something cannot be undone, and the tool descriptions tell the agent to confirm with you first. Publish and unpublish are the safe way to hide something and bring it back.

Products

Tool	Private API endpoint
list_products	Get list of products
get_product	Get product by ID
create_one_time_product	Create one-time product
update_one_time_product	Update one-time product
publish_one_time_product	Publish one-time product
unpublish_one_time_product	Unpublish one-time product
archive_one_time_product	Archive one-time product
set_one_time_product_metadata	Sync one-time product metadata
create_subscription_product	Create subscription product
update_subscription_product	Update subscription product
publish_subscription_product	Publish subscription product
unpublish_subscription_product	Unpublish subscription product
archive_subscription_product	Archive subscription product
set_subscription_product_metadata	Sync subscription product metadata

Variants

Tool	Private API endpoint
get_variant	Get variant by ID
create_variant	Create variant
update_variant	Update variant
archive_variant	Archive variant
batch_variants	Batch create/update/archive variants

Plans

Tool	Private API endpoint
get_plan	Get plan by ID
create_plan	Create plan
update_plan	Update plan
archive_plan	Archive plan

Bundles

Tool	Private API endpoint
list_bundles	Get list of bundles
get_bundle	Get bundle by ID
create_bundle	Create a new bundle
update_bundle	Update a bundle
publish_bundle	Publish a bundle
unpublish_bundle	Unpublish a bundle
archive_bundle	Archive a bundle
set_bundle_metadata	Sync bundle metadata
list_bundle_groups	Get list of bundle groups

Bundle items

Tool	Private API endpoint
list_bundle_items	Get list of bundle items
get_bundle_item	Get bundle item by ID
create_bundle_item	Create a bundle item
update_bundle_item	Update a bundle item
delete_bundle_item	Delete a bundle item
batch_bundle_items	Batch create bundle items

Bundle plans

Tool	Private API endpoint
get_bundle_plan	Get bundle plan by ID
create_bundle_plan	Create a bundle plan
update_bundle_plan	Update a bundle plan
archive_bundle_plan	Archive a bundle plan

Collections

Tool	Private API endpoint
list_collections	Get list of product collections
get_collection	Get product collection by ID
create_collection	Create a product collection
update_collection	Update a product collection
publish_collection	Publish a product collection
unpublish_collection	Unpublish a product collection
archive_collection	Archive a product collection
list_collection_items	Get list of collection groups with items
batch_collection_items	Sync collection items

Subscriptions

Tool	Private API endpoint
list_subscriptions	Get list of subscriptions
get_subscription	Get subscription by ID.
cancel_subscription	Cancel a subscription
undo_subscription_cancellation	Undo cancellation

Subscription items

Tool	Private API endpoint
create_subscription_item	Create a subscription item.
get_subscription_item	Show a subscription item.
update_subscription_item	Update a subscription item.
delete_subscription_item	Remove a subscription item.
update_subscription_item_preferences	Update a subscription item's preferences.
update_subscription_item_bundle	Update a subscription item's bundle.

Invoices

Tool	Private API endpoint
list_invoices	Get list of invoices.
get_invoice	Get invoice by ID.
schedule_invoice_payment	Schedule the next payment for invoice
void_invoice	Void an invoice.
forgive_invoice	Forgive an invoice.
mark_invoice_as_paid	Mark an invoice as paid.

Orders

Tool	Private API endpoint
list_orders	Get list of orders.
get_order	Get order by ID.
update_order	Update an order.
ship_order	Ship an order
cancel_order	Cancel an order
mark_order_as_pending	Mark an order as pending
archive_order	Archive an order
mark_order_as_future_shipment	Mark an order as a future shipment
batch_order_shipping_items	Sync order shipping items.

Customers and payments

Tool	Private API endpoint
list_customers	Get list of customers
get_customer	Get customer by ID.
get_payment_method	Get payment method by ID.
list_transactions	Get list of transactions.
get_transaction	Get transaction by ID.
list_cancellation_reasons	Get shop cancellation reasons

Coupons

Tool	Private API endpoint
list_coupons	Get list of coupons
get_coupon	Get coupon by ID
create_coupon	Create a coupon
update_coupon	Update a coupon
archive_coupon	Archive a coupon

Inventory

Tool	Private API endpoint
list_inventory_items	Get list of inventory items
get_inventory_item	Get inventory item by ID
create_inventory_item	Create a new inventory item
update_inventory_item	Update an inventory item
archive_inventory_item	Archive an inventory item
list_inventory_groups	Get list of inventory groups
get_inventory_group	Get inventory group by ID
create_inventory_group	Create a new inventory group
update_inventory_group	Update an inventory group

Metafields

Tool	Private API endpoint
list_metafields	Get shop's metafields
create_metafield	Create a new metadata
update_metafield	Update the metadata

Shop settings

Tool	Private API endpoint
list_tags	Get list of tags
list_surveys	Get list of surveys
get_survey	Get survey by ID
list_funnels	Get list of funnels
get_funnel	Get funnel by ID
list_options	Get list of options
list_countries	Get list of countries

Next steps

• Connect a client — add the server to Claude Code, Cursor or VS Code.
• Private API reference — every endpoint, with fields, responses and examples.