Spree Admin MCP Server: Setup for Claude, Cursor and Other Apps

• Shows what a record type contains

  Describes a kind of record in your store, including its fields and filters, so the assistant knows what it can ask for.

  Try: “What fields can I filter products by?”

  Read · describe_resource

• Finds records in your store

  Searches records such as products and orders. It only finds what you approved.

  Try: “Which products are out of stock?”

  Read · search_resources

• Opens one record

  Fetches a single record, such as an order or product, by ID.

  Try: “Show order R123456789.”

  Read · get_resource

• Lists what reports can show

  Lists the measures and breakdowns the reporting tool supports.

  Try: “What can I report on?”

  Read · describe_reporting

• Runs a sales report

  Runs a report such as sales by country or period and returns the figures.

  Try: “What did we sell in Germany last month?”

  Read · query_report

• Makes a product live

  Activates a product so shoppers can see it.

  Try: “Activate the Summer Tote product.”

  Write · products_activate

• Moves a product to draft

  Sets a product back to draft.

  Try: “Put the Summer Tote back in draft.”

  Write · products_draft

• Archives a product

  Archives a product.

  Try: “Archive last year's holiday products.”

  Write · products_archive

• Approves a submitted product

  Approves a product that was submitted for review.

  Try: “Approve the new product from Acme Supplies.”

  Write · products_approve

• Rejects a submitted product

  Rejects a product that was submitted for review.

  Try: “Reject that product, the photos are missing.”

  Write · products_reject

• Adds a product variant

  Creates a new variant, for example a size, on a product.

  Try: “Add a size L variant to the Summer Tote.”

  Write · variants_create

• Changes a variant

  Updates a variant's details.

  Try: “Change the SKU of the size M variant.”

  Write · variants_update

• Turns a catalog on

  Activates a catalog.

  Try: “Activate the wholesale catalog.”

  Write · catalogs_activate

• Turns a catalog off

  Deactivates a catalog.

  Try: “Deactivate the wholesale catalog.”

  Write · catalogs_deactivate

• Turns a price list on

  Activates a price list.

  Try: “Activate the VIP price list.”

  Write · price_lists_activate

• Turns a price list off

  Deactivates a price list.

  Try: “Turn off the VIP price list.”

  Write · price_lists_deactivate

• Adds or removes products in a group

  Adds products to a category, collection, catalog or price list, or removes them. It reports how many memberships changed.

  Try: “Add these five products to the Summer collection.”

  Write · curate_products

• Cancels an order

  Cancels an order. The order's timeline records who did it.

  Try: “Cancel order R123456789 and tell the customer why.”

  Write · orders_cancel

• Completes an order

  Completes an order.

  Try: “Complete order R123456789.”

  Write · orders_complete

• Captures a payment

  Captures a payment that was only authorized. This moves money.

  Try: “Capture the payment on order R123456789.”

  Write · payments_capture

• Voids a payment

  Voids a payment before it settles.

  Try: “Void the payment on order R123456789.”

  Write · payments_void

• Refunds a customer

  Creates a refund for a payment. This moves money.

  Try: “Refund order R123456789 in full.”

  Write · refunds_create

• Creates a shipment

  Creates a fulfillment for an order.

  Try: “Create a shipment for order R123456789.”

  Write · fulfillments_create

• Marks a shipment delivered

  Marks a fulfillment as delivered.

  Try: “Mark the shipment for R123456789 as delivered.”

  Write · fulfillments_mark_delivered

• Updates tracking details

  Changes the tracking information on a delivery.

  Try: “Set the tracking number for R123456789.”

  Write · deliveries_update_tracking

• Buys a shipping label

  Purchases a shipping label. This spends money.

  Try: “Buy a shipping label for R123456789.”

  Write · shipping_labels_purchase

• Refunds a shipping label

  Refunds a shipping label that was bought.

  Try: “Refund the unused label on R123456789.”

  Write · shipping_labels_refund

• Sets stock levels

  Sets the stock quantity for an item.

  Try: “Set stock for the size M variant to 100.”

  Write · set_stock

• Moves a stock transfer to draft

  Sets a stock transfer back to draft.

  Try: “Set transfer 12 back to draft.”

  Write · stock_transfers_mark_draft

• Marks a transfer ready

  Marks a stock transfer ready to send.

  Try: “Mark transfer 12 as ready.”

  Write · stock_transfers_mark_ready

• Marks a transfer in transit

  Marks a stock transfer as on its way.

  Try: “Mark transfer 12 as in transit.”

  Write · stock_transfers_mark_in_transit

• Receives a stock transfer

  Records that a stock transfer arrived.

  Try: “Receive transfer 12.”

  Write · stock_transfers_receive

• Cancels a stock transfer

  Cancels a stock transfer.

  Try: “Cancel transfer 12.”

  Write · stock_transfers_cancel

• Closes a stock transfer

  Closes a stock transfer.

  Try: “Close transfer 12.”

  Write · stock_transfers_close

• Moves a purchase order to draft

  Sets a purchase order back to draft.

  Try: “Set purchase order 7 back to draft.”

  Write · purchase_orders_mark_draft

• Marks a purchase order ordered

  Marks a purchase order as sent to the supplier.

  Try: “Mark purchase order 7 as ordered.”

  Write · purchase_orders_mark_ordered

• Receives a purchase order

  Records that the goods on a purchase order arrived.

  Try: “Receive purchase order 7.”

  Write · purchase_orders_receive

• Cancels a purchase order

  Cancels a purchase order.

  Try: “Cancel purchase order 7.”

  Write · purchase_orders_cancel

• Closes a purchase order

  Closes a purchase order.

  Try: “Close purchase order 7.”

  Write · purchase_orders_close

• Invites a seller

  Invites a new seller to your marketplace.

  Try: “Invite acme@example.com as a seller.”

  Write · sellers_invite

• Approves a seller

  Approves a seller's application.

  Try: “Approve Acme Supplies as a seller.”

  Write · sellers_approve

• Rejects a seller

  Rejects a seller's application.

  Try: “Reject the application from Acme Supplies.”

  Write · sellers_reject

• Suspends a seller

  Suspends a seller.

  Try: “Suspend Acme Supplies.”

  Write · sellers_suspend

• Reopens seller onboarding

  Reopens a seller's onboarding so they can resubmit.

  Try: “Reopen onboarding for Acme Supplies.”

  Write · sellers_reopen_onboarding

• Accepts a seller document

  Accepts a document or answer a seller submitted.

  Try: “Accept Acme's tax document.”

  Write · seller_requirement_submissions_accept

• Rejects a seller document

  Rejects a document or answer a seller submitted.

  Try: “Reject Acme's tax document.”

  Write · seller_requirement_submissions_reject

• Waives a seller requirement

  Waives a requirement for a seller.

  Try: “Waive the insurance requirement for Acme.”

  Write · seller_requirement_submissions_waive

• Uploads a file

  Uploads a file to the store.

  Try: “Upload this product photo.”

  Write · upload_file

• Adds media to a product

  Creates a media item such as an image.

  Try: “Add this photo to the Summer Tote.”

  Write · media_create

• Starts a data import

  Starts an import of records from a file.

  Try: “Import this CSV of products.”

  Write · create_import

• Suggests an import column mapping

  Proposes how the columns of an import file map to store fields.

  Try: “Map the columns of this CSV to product fields.”

  Write · propose_import_mapping

• Shows an import mapping

  Describes the mapping chosen for an import.

  Try: “How are the columns of my import mapped?”

  Read · describe_import_mapping

• Checks an import

  Returns the status of an import.

  Try: “Has my product import finished?”

  Read · get_import_status

• Starts an export

  Starts an export of records as CSV. The finished file can be read as a resource.

  Try: “Export last month's orders.”

  Write · create_export

• Creates a record

  Creates a record such as a product, market or tax rate. It checks your approved permissions for that record type.

  Try: “Create a product called Expensive Bag with sizes S and M.”

  Write · create_resource

• Changes a record

  Updates a record. It checks your approved permissions for that record type.

  Try: “Change the price of the Summer Tote to 49 USD.”

  Write · update_resource

• Deletes a record

  Deletes a record of a kind you approved.

  Try: “Delete the draft product named Test.”

  Delete · delete_resource

• Verifies a tax exemption certificate

  Marks a customer's tax exemption certificate as verified.

  Try: “Verify this customer's exemption certificate.”

  Write · tax_exemption_certificates_verify

Watch out for

• It can refund and capture payments

  Payment, refund and shipping label tools move money. Only approve those permissions if you want that, and read each confirmation your app shows. github.com

• It can change or delete store records

  Three general tools create, change and delete 38 kinds of record. Approve only the record types you need. github.com

• Writes ask your app to confirm

  The docs say a write asks your client to confirm before it runs. That depends on your app, so check it does. github.com

• Some things are never reachable

  The docs say API keys, roles, staff accounts and gift card codes cannot be reached, and customer erasure is dashboard-only. github.com

Security advisories