> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox MCP Servers

> Shopify, Gorgias, and Recharge operations as agent-callable tools.

# Sandbox MCP Servers

MCP servers for e-commerce platform operations, giving an agent tools to work directly against
Shopify, Gorgias, Recharge, and related platforms.

## Available servers

### Shopify

| Server            | Scope                    | Tools                                             |
| ----------------- | ------------------------ | ------------------------------------------------- |
| `shopify`         | Fulfillment holds        | `preview_orders`, `release_holds`, `add_tags`     |
| `shopify-full`    | Comprehensive operations | **40+**                                           |
| `shopify-refunds` | Partial refunds          | `lookup_order`, `preview_refund`, `create_refund` |

<Tip>
  The narrow servers exist so you can grant an agent exactly one job. If an agent only needs to
  release fulfillment holds, give it `shopify` rather than `shopify-full` — 3 tools instead of 40+,
  and no path to issuing a refund.
</Tip>

### `shopify-full` coverage

**Orders** — `search_orders` with status, financial, fulfillment and date filters; `get_order`
with line items, customer and transactions; `update_order`; `cancel_order` with reason, refund
option and restock; `close_order` / `reopen_order`.

**Fulfillment** — `get_fulfillment_orders`, `create_fulfillment` with tracking,
`update_tracking`, `cancel_fulfillment`, `release_fulfillment_hold`.

**Refunds** — `calculate_refund` to preview amounts, `create_refund`, `get_refunds`.

**Products** — `search_products`, `get_product` with variants and images, `update_product`,
`update_variant`.

Plus customers, inventory, discounts, metafields, collections, gift cards, and draft orders.

<Warning>
  `create_refund`, `cancel_order`, and `create_fulfillment` take **real action on a live store**.
  `calculate_refund` and `preview_refund` exist precisely so an agent can check its arithmetic
  before committing — have it preview first.
</Warning>

## Other platforms

Servers are also available for **Gorgias** (support tickets) and **Recharge** (subscriptions),
following the same pattern.

## Setup

```bash theme={null}
cd mcp-servers
npm install
```

Then register the server you want with your MCP host, supplying that platform's credentials via
environment variables. Each server's README documents its required variables.

## Choosing a scope

| If the agent needs to…         | Give it           |
| ------------------------------ | ----------------- |
| Release fulfillment holds only | `shopify`         |
| Issue partial refunds only     | `shopify-refunds` |
| Operate the store broadly      | `shopify-full`    |
| Handle support tickets         | `gorgias`         |
| Manage subscriptions           | `recharge`        |

## Related

* [Sandbox Architecture](/stateset-sandbox/stateset-sandbox-architecture)
* [Sandbox Security Guide](/stateset-sandbox/stateset-sandbox-security-guide)
* [All MCP servers](/mcp-servers)