Loop Returns MCP server for your AI

Retrieves a draft return as a draft return.

Initialize a new draft return and receive a response.

Cancel a return in Loop.

Report per-line-item return eligibility for an order, by its order name, without starting a return.

Close a return.

Attach a fraud report to a return.

Create a deep link URL.

Post a new note to a return.

Generate a link to a QR code image file that, when scanned, will take the user directly to their order in Loop so they can initiate a return without requiring them to enter their order information.

Find returns by shopper email, order name, SKU, return reason or outcome.

Flag a return in Loop for review.

Get the details of a specific return based on a return's ID, an order name, or an order ID from the commerce provider (e.g. Shopify) depending on the query value of the call.

This endpoint will pull all packages by tracking statuses/timeframe.

Get notes on a specific return using the return's ID.

Pull a detailed list of returns created within a given timeframe.

Process a return in Loop based on the return ID.

Remove one or more line items from an open return.

See one return in full: state, outcome, order, shopper, totals, each item with its reason and condition, exchanges, tracking and label, and the notes on it.

Report on returns for a date range: how many, by state, outcome and reason, the most returned SKUs, and refund, gift card, exchange and return totals per currency.

Queue label generation for a return.

Retrieve a list of label requests.

Queue a new Loop label for a return that already has one, for example when the original label expired before the shopper dropped off the package.

Create an allowlist entry.

Create a blocklist entry.

Delete an allowlist entry.

Delete a blocklist entry.

Retrieve a list of paginated allowlist entries.

Retrieve a list of paginated blocklist entries.

Create a new webhook subscription.

Delete a webhook subscription.

Retrieve all destinations.

Get all webhook subscriptions.

Get information about all Happy Returns shipments created within a given timeframe.

Assess return line item dispositions.

Grade the condition of return line items.

Show which Loop shop this API key belongs to and which scopes it has.

Records the customer's acceptance of the return policy.

Adds an item to the draft return's cart.

Adds an exchange item for a specific returning item to the cart.

Adds a specific item to the draft return's ReturningItems.

Cancel a draft return.

Create a draft return with everything set in one request, instead of the step-by-step initialize_draft_return flow.

Creates a payment intent for the draft return.

Finalizes the returning items and cart items of the draft return.

Returns the computed monetary totals for the draft return.

Returns the order's line items in the context of the draft return, including return and warranty eligibility, available return reasons, variant details, and advanced-exchange options.

Returns a collection describing the draft-return actions available for the shop.

Removes a specific item from the draft return's cart.

Removes a specific item from the draft return's ReturningItems.

Removes a payment intent from the draft return.

Selects the carrier label format for a previously selected return method.

Selects a return method for the draft return.

Sets the return shipping address for the draft return.

Sets the entire cart for the draft return in a single request.

Sets the credit type for the draft return.

Sets the customer information for the draft return.

Sets the return reason for a specific returning item.

Sets the return type for a specific returning item.

Adds user input for a specific returning item.

Sets the display language for the draft return.

Sets the processing type (regular or instant) of the draft return.

Submits the draft return.

Reopens the returning items and cart items of the draft return for modification.

Removes the credit type selection from the draft return.

Upload an image answer for a returning item's photo question on a draft return.

Retract the fraud report on a return, the one added with create_fraud_report.

Create a new product.

Create a new product variant.

Delete a product.

Delete a product by its commerce external_id.

Delete a product variant.

Delete a product variant by the parent product's commerce external_id and the variant's commerce external_id.

Get the details about a single product.

Get the details about a single product by its commerce external_id.

Get the details about a single product variant.

Get the details about a single product variant by the parent product's commerce external_id and the variant's commerce external_id.

Retrieve a list of product variants.

Retrieve a list of products.

Update a product.

Update a product variant.

Upsert a product, identified using the product's external_id.

Upsert a product variant, identified using the product's external_id.

Upsert a product variant under a parent product identified by its commerce external_id.

Attach a product to a collection.

Attach a product to a collection by commerce external_id.

Create a new collection.

Delete a collection.

Delete a collection by its commerce external_id.

Get details about a single collection.

Get details about a single collection by its commerce external_id.

Retrieve a list of collections.

Delete a product from a collection.

Delete a product from a collection by commerce external_id.

Update a collection.

Upsert a collection, identified using the collection's name and external_id.

Create a label for a label request.

Create a Ship by Loop order for a shipment.

Get details about a single label request.

Get the Ship by Loop services available for a shipment.

Report a label generation failure against a label request.

Push a status update for a label.

Create a new customer.

Upsert inventory details for a product variant by location.

Create a new location.

Create a new order.

Delete a customer.

Delete a customer by its commerce external_id.

Delete an inventory.

Delete an inventory record identified by the product variant's external_id and the location's external_id.

Delete a location.

Delete a location by its commerce external_id.

Delete a specific order.

Delete a specific order by its commerce external_id.

Retrieve an allowlist entry.

Retrieve a blocklist entry.

Get details about a single customer.

Get details about a single customer by its commerce external_id.

Get inventory details for a product variant by location.

Get inventory details for a product variant at a location, identified by the variant's external_id and the location's external_id.

Get the details about a single location.

Get the details about a single location by its commerce external_id.

Get details about a specific order.

Get details about a specific order by its commerce external_id.

Retrieve a list of customers.

Retrieve a list of inventories.

Retrieve a list of locations.

List all orders.

Update a customer.

Update a location.

Update a specific order.

Upsert a customer, identified using the customer's external_id.

Upsert inventory details for a product variant by location.

Upsert inventory details for a product variant at a location, identified by the variant's external_id and the location's external_id.

Upsert a location, identified using the location's external_id.

Upsert an order using the external_id.

Create a destination.

Delete a destination.

Get details for a single destination.

Get example payloads for each webhook topic, to build and test a handler without waiting for a real event.

Update a destination.

Update a webhook subscriptions.

Create a new bulk operation.

Create a cart object and populate it with one or more product variants.

Delete a Shop Now cart by its token.

Get the details about a specific bulk operation.

Get a Shop Now cart by its token.

Retrieve a list of bulk operation jobs.

Retrieve a list of bulk operations.

Replace the product variants in a Shop Now cart.

Price Checkout+ order protection for a cart and open or reuse an offer session.

Read a Checkout+ offer session without re-analyzing the cart.

Get high level information from a Happy Returns shipment.

Read the shop's Checkout+ order protection settings.

Get all items for a Happy Returns shipment.