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

<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="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`

    Browse inventory items by visibility, condition, and availability.

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

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

    Find customers by activity, lifetime value, and outstanding balance.

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

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

    List charges filtered by payment status, amount, and category.

    [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="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">
    `add_comment`

    Add comments and notes to cycles, items, customers, and returns.

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

## What you can do

* **Query**: List and search cycles, inventory, customers, returns, and charges
* **Inspect**: Get full details on individual cycles and returns
* **Act**: Update cycles, create returns, reschedule dates, mark lines as received
* **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.