> ## 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

> Use the Operators MCP to manage your circular models from your preferred AI chat

The Operators MCP connects your preferred AI assistant directly to your Supercycle data. Query cycles, inventory, products, customers, returns, and charges using natural language — without leaving your AI chat.

<Frame type="glass" caption="Operators MCP overview">
  <iframe src="https://fast.wistia.net/embed/iframe/8kqy2wuhuf" title="Supercycle video" width="100%" allow="autoplay; fullscreen" frameborder="0" />
</Frame>

It uses OAuth authentication with your Shopify account and works with Claude, ChatGPT, and any MCP-compatible client.

## Available tools

Read tools are auto-approved. Write tools request confirmation before making changes, and require [full OAuth access](/ai/operators-mcp/security#oauth-access-levels) — read-only connections can list and inspect data but cannot call write tools.

<AccordionGroup>
  <Accordion title="Cycles" icon="list-check">
    `list_cycles` · `get_cycle` · `update_cycle`

    List, inspect, and update rental cycles — including packing status, dates, and item assignment.

    [View cycle tools →](/ai/operators-mcp/tools#cycles)
  </Accordion>

  <Accordion title="Outbound fulfillments" icon="truck">
    `list_outbound_fulfillments` · `get_outbound_fulfillment` · `update_outbound_fulfillment`

    Run the packing queue: see what needs to go out, reschedule shipments, and mark them fulfilled.

    [View outbound fulfillment tools →](/ai/operators-mcp/tools#outbound-fulfillments)
  </Accordion>

  <Accordion title="Inbound receivals" icon="inbox-in">
    `list_inbound_receivals` · `get_inbound_receival` · `update_inbound_receival`

    Run the receiving queue: see what is due back, reschedule returns, and mark them received.

    [View inbound receival tools →](/ai/operators-mcp/tools#inbound-receivals)
  </Accordion>

  <Accordion title="Returns" icon="rotate-left">
    `list_returns` · `get_return` · `create_return` · `update_return`

    List, inspect, create, and update return orders and return line statuses.

    [View return tools →](/ai/operators-mcp/tools#returns)
  </Accordion>

  <Accordion title="Inventory" icon="warehouse-full">
    `list_items` · `get_item` · `update_item`

    Browse and inspect inventory items, and update their condition, serial, pick location, and visibility.

    [View inventory tools →](/ai/operators-mcp/tools#inventory)
  </Accordion>

  <Accordion title="Products" icon="box-open">
    `list_products` · `get_product`

    Browse the catalog by title, status, and enabled methods, and inspect a product's configuration and inventory.

    [View product tools →](/ai/operators-mcp/tools#products)
  </Accordion>

  <Accordion title="Customers" icon="users">
    `list_customers` · `get_customer`

    Find customers by activity, lifetime value, and outstanding balance, and inspect their full profile.

    [View customer tools →](/ai/operators-mcp/tools#customers)
  </Accordion>

  <Accordion title="Charges" icon="credit-card">
    `list_charges` · `get_charge`

    List charges filtered by payment status, amount, and category, and inspect payment attempts and collector state.

    [View charge tools →](/ai/operators-mcp/tools#charges)
  </Accordion>

  <Accordion title="Pricing" icon="tag">
    `list_method_options`

    Browse pricing options across calendar, subscription, membership, and resale methods.

    [View pricing tools →](/ai/operators-mcp/tools#pricing)
  </Accordion>

  <Accordion title="Availability" icon="calendar-xmark">
    `check_availability` · `list_blocked_dates` · `create_blocked_date` · `delete_blocked_date`

    Check whether a product or variant can be booked for a date range, and list, create, and delete blocked date ranges on items, variants, products, or the whole store.

    [View availability tools →](/ai/operators-mcp/tools#availability)
  </Accordion>

  <Accordion title="Tags" icon="tags">
    `list_tags` · `add_tag` · `remove_tag`

    List, add, and remove tags on cycles, items, and returns.

    [View tag tools →](/ai/operators-mcp/tools#tags)
  </Accordion>

  <Accordion title="Comments" icon="comment">
    `list_comments` · `add_comment`

    Read and add comments and notes on cycles, items, customers, and returns.

    [View comment tools →](/ai/operators-mcp/tools#comments)
  </Accordion>
</AccordionGroup>

## What you can do

* **Query**: List and search cycles, fulfillment and receival queues, inventory, products, customers, returns, and charges
* **Inspect**: Get full details on individual cycles, fulfillments, receivals, returns, items, products, customers, and charges
* **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, manage blocked dates
* **Organise**: Tag and comment on cycles, items, customers, and returns

## Getting started

Find your MCP server URL in <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 tool.