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

# Operators MCP

> Manage cycles, inventory, customers, returns, and charges from your preferred AI chat

The Operators MCP connects your preferred AI assistant to your Supercycle data. Query cycles, inventory, products, customers, returns, and charges in plain language, and take action on them, without leaving your AI chat. It authenticates with OAuth through your Shopify account and works with Claude, ChatGPT, and any MCP-compatible client.

<Frame type="glass" caption="Asking the Operators MCP about overdue cycles and acting on the answer">
  <iframe src="https://fast.wistia.net/embed/iframe/8kqy2wuhuf" title="Operators MCP overview" width="100%" height="400" allow="autoplay; fullscreen" frameborder="0" />
</Frame>

***

## How it works

Read tools run without a prompt. Write tools ask for your confirmation before they change anything, and they need [full OAuth access](/ai/operators-mcp/security#oauth-access-levels). A read-only connection can list and inspect data but can't call write tools.

With the Operators MCP connected, your AI assistant can:

* **Query.** List and search cycles, fulfillment and receival queues, inventory, products, customers, returns, and charges.
* **Inspect.** Get the full record for a cycle, fulfillment, receival, return, item, product, customer, or charge.
* **Check.** See whether a product or variant is bookable for a date range, with conflicts and alternative windows.
* **Act.** Update cycles and items, create returns, reschedule shipments and returns, mark them fulfilled or received, and manage blocked dates.
* **Organize.** Tag and comment on cycles, items, customers, and returns.

***

## Available tools

Open a resource to see the tools it exposes. The [tools reference](/ai/operators-mcp/tools) has every parameter.

<AccordionGroup>
  <Accordion title="Cycles" icon="list-check">
    `list_cycles`, `get_cycle`, and `update_cycle`. List, inspect, and update cycles, including packing status, dates, and item assignment. See [cycle tools](/ai/operators-mcp/tools#cycles).
  </Accordion>

  <Accordion title="Outbound fulfillments" icon="truck">
    `list_outbound_fulfillments`, `get_outbound_fulfillment`, and `update_outbound_fulfillment`. Run the packing queue: see what needs to go out, reschedule shipments, and mark them fulfilled. See [outbound fulfillment tools](/ai/operators-mcp/tools#outbound-fulfillments).
  </Accordion>

  <Accordion title="Inbound receivals" icon="inbox-in">
    `list_inbound_receivals`, `get_inbound_receival`, and `update_inbound_receival`. Run the receiving queue: see what's due back, reschedule returns, and mark them received. See [inbound receival tools](/ai/operators-mcp/tools#inbound-receivals).
  </Accordion>

  <Accordion title="Returns" icon="rotate-left">
    `list_returns`, `get_return`, `create_return`, and `update_return`. List, inspect, create, and update returns and return line statuses. See [return tools](/ai/operators-mcp/tools#returns).
  </Accordion>

  <Accordion title="Inventory" icon="warehouse-full">
    `list_items`, `get_item`, and `update_item`. Browse and inspect items, and update their condition, serial, pick location, and visibility. See [inventory tools](/ai/operators-mcp/tools#inventory).
  </Accordion>

  <Accordion title="Products" icon="box-open">
    `list_products` and `get_product`. Browse the catalog by title, status, and methods, and inspect a product's configuration and inventory. See [product tools](/ai/operators-mcp/tools#products).
  </Accordion>

  <Accordion title="Customers" icon="users">
    `list_customers` and `get_customer`. Find customers by activity, lifetime value, and outstanding balance, and inspect their profile. See [customer tools](/ai/operators-mcp/tools#customers).
  </Accordion>

  <Accordion title="Charges" icon="credit-card">
    `list_charges` and `get_charge`. List charges by payment status, amount, and category, and inspect payment attempts and collector state. See [charge tools](/ai/operators-mcp/tools#charges).
  </Accordion>

  <Accordion title="Pricing" icon="tag">
    `list_method_options`. Browse pricing options across the calendar, subscription, membership, and resale methods. See [pricing tools](/ai/operators-mcp/tools#pricing).
  </Accordion>

  <Accordion title="Availability" icon="calendar-xmark">
    `check_availability`, `list_blocked_dates`, `create_blocked_date`, and `delete_blocked_date`. Check whether a product or variant can be booked for a date range, and manage blocked dates on items, variants, products, or the whole store. See [availability tools](/ai/operators-mcp/tools#availability).
  </Accordion>

  <Accordion title="Tags" icon="tags">
    `list_tags`, `add_tag`, and `remove_tag`. List, add, and remove tags on cycles, items, and returns. See [tag tools](/ai/operators-mcp/tools#tags).
  </Accordion>

  <Accordion title="Comments" icon="comment">
    `list_comments` and `add_comment`. Read and add comments on cycles, items, customers, and returns. See [comment tools](/ai/operators-mcp/tools#comments).
  </Accordion>
</AccordionGroup>

***

## Connect the Operators MCP

Find your MCP server URL under <Icon icon="shopify" iconType="solid" /> **[Integrations](https://admin.shopify.com/apps/supercycle/settings/integrations)**, then follow the [setup guide](/ai/operators-mcp/setup) to connect your AI client.