---
title: "Scopes"
description: "The scope sets you pick from when an app connects, and what each scope lets a connection do."
---

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

# Scopes

A scope names a resource and an action, as `resource:action`: `product:read` reads products, `product:write` creates and changes them, and `product:delete` removes them. Every tool needs one or more scopes, which its page in the [Tools reference](/merchant-mcp/tools) names.

## What a connection holds

When an app connects, you pick one set for each business on the consent screen (see [Sign-in and consent](/merchant-mcp/sign-in#what-it-may-do)). In each business, the connection holds that set's scopes, cut to your own permissions there: it never gets more than your seat allows. A connection reaching several businesses lists every tool any of them may call, and each call is checked against the business of the store it acts on.

A connection's scopes are fixed for its whole life. To give an app more, connect it again and pick a wider set.

## The sets

| Set | On the consent screen | What it covers |
| --- | --- | --- |
| `catalog` | Catalog | Products, prices and discounts. |
| `content` | Content | The website, pages, files, quizzes and certificates. |
| `sales` | Sales | Orders, revenue, subscriptions and affiliates. |
| `customers` | Customers | Customers, reviews and event check-in. |
| `portfolio` | Portfolio | Portfolios and their holdings. |
| `everything` | Everything | Everything an app may do through Sherpo's MCP server. |

Each set holds read, write and, where there is one, delete scopes. There is no read-only set.

| Set | Scopes |
| --- | --- |
| `catalog` | `discount:read`, `discount:write`, `discount:delete`, `price:read`, `price:write`, `price:delete`, `product:read`, `product:write`, `product:delete` |
| `content` | `certificate:read`, `certificate:write`, `certificate:delete`, `custompage:read`, `custompage:write`, `custompage:delete`, `entry:read`, `entry:write`, `entry:delete`, `file:read`, `file:write`, `file:delete`, `quiz:read`, `quiz:write`, `quiz:delete`, `site:read`, `site:write`, `site:delete` |
| `sales` | `affiliate:read`, `affiliate:write`, `revenue:read`, `subscription:read`, `subscription:write`, `transaction:read`, `transaction:write` |
| `customers` | `attendee:checkin`, `customer:read`, `customer:write`, `customer:delete`, `review:read`, `review:write`, `review:moderate` |
| `portfolio` | `portfolio:read`, `portfolio:write` |
| `everything` | Every scope below. |

## What each resource covers

- `product`: products, their tiers, who may access them, a software product's activity, and product, catalog and product traffic stats. A release that ships files takes `file:write` too, and deleting one also takes `product:write`, since its files leave the product's downloads.
- `price`: prices, including highlighting, archiving and restoring them.
- `discount`: discounts, what they apply to, and their stats.
- `entry`: entries, the lessons, posts or episodes inside a product, and their sections.
- `custompage`: the store's pages.
- `file`: files and uploads, attachments, rich text bodies, prompts, product posters and video versions, plus storage use and where each file is used and delivered.
- `quiz`: quizzes and their attempts.
- `certificate`: certificates and the certificates issued.
- `site`: the store itself: its settings, plan usage, icon and redirects.
- `transaction`: orders, with their items, settlements, refunds and affiliates, plus store, order, traffic, conversion and API call stats. It also records orders and refunds.
- `revenue`: amounts. See below.
- `subscription`: subscriptions, their periods and changes, and their stats. It also cancels and resumes them.
- `affiliate`: affiliates, their commissions and payouts.
- `customer`: customers, their activity and checkouts, and the access they hold. `customer:delete` erases a customer.
- `review`: reviews and their stats. `review:write` replies to them, and `review:moderate` hides and unhides them.
- `attendee`: `attendee:checkin` checks attendees in at an event's door and undoes it, and reads the door's counts and the events to check in. Alone, it never reads the guest list, which takes `customer:read`. A check-in it makes still runs the event's check-in automations and issues its certificates of attendance, though it reads neither.
- `organization`: the business: its profile and logo, balance, payouts, plan, notifications and webhooks.
- `integration`: the store's integrations and their settings.
- `automation`: automations and their runs.
- `portfolio`: portfolios, holdings, their valuation, events and snapshots, and symbol search and quotes.

### `revenue:read`

`revenue:read` names no tool. Without it, amounts read back as `null`, for example an order's `amount`, `total` and `fees`. A webhook for an event that carries amounts is refused too. The `sales` and `everything` sets hold it.

### What needs Everything

Only the `everything` set holds the `organization`, `integration` and `automation` scopes. So these need Everything:

- [webhooks](/merchant-mcp/webhooks);
- [integrations and automations](/merchant-mcp/integrations-and-automations);
- the business's own tools, such as [`get_organization`](/merchant-mcp/tools/get_organization), [`get_balance`](/merchant-mcp/tools/get_balance) and [`list_notifications`](/merchant-mcp/tools/list_notifications);
- the account tools [`list_merchants`](/merchant-mcp/tools/list_merchants) and [`get_merchant`](/merchant-mcp/tools/get_merchant), which read your businesses and their stores. A connection reaching one business answers only that one. A connection on the seller's Connections page always has `list_merchants` among its tools, whatever its sets, and it answers every business the connection reaches, each with up to 20 of its stores. Pass `store` to `list_merchants` to look up the business of another store the connection reaches.

## Tools you can't call aren't listed

The server lists only the tools the connection may call, so an agent connected with the `catalog` set never sees the order or customer tools. Calling a tool the connection lacks a scope for answers HTTP `403` with `insufficient_scope` (see [Errors](/merchant-mcp/errors)), except on a connection reaching several businesses when another of them holds the scope, which is a tool error (see [Sign-in and consent](/merchant-mcp/sign-in#401-and-403-at-the-mcp-endpoint)).

## Every scope and its tools

| Scope | Tools that need it |
| --- | --- |
| `affiliate:read` | [`list_commissions`](/merchant-mcp/tools/list_commissions), [`commission_stats`](/merchant-mcp/tools/commission_stats), [`list_affiliate_payouts`](/merchant-mcp/tools/list_affiliate_payouts), [`list_affiliates`](/merchant-mcp/tools/list_affiliates) |
| `affiliate:write` | [`record_affiliate_payout`](/merchant-mcp/tools/record_affiliate_payout), [`set_affiliate`](/merchant-mcp/tools/set_affiliate), [`remove_affiliate`](/merchant-mcp/tools/remove_affiliate), [`revert_affiliate`](/merchant-mcp/tools/revert_affiliate) |
| `attendee:checkin` | [`check_in_event_attendee`](/merchant-mcp/tools/check_in_event_attendee), [`undo_event_attendee_check_in`](/merchant-mcp/tools/undo_event_attendee_check_in), [`event_check_in_stats`](/merchant-mcp/tools/event_check_in_stats), [`list_check_in_events`](/merchant-mcp/tools/list_check_in_events) |
| `automation:read` | [`list_all_automations`](/merchant-mcp/tools/list_all_automations), [`list_automation_runs`](/merchant-mcp/tools/list_automation_runs), [`get_automation`](/merchant-mcp/tools/get_automation) |
| `automation:write` | [`create_automation`](/merchant-mcp/tools/create_automation), [`update_automation`](/merchant-mcp/tools/update_automation), [`pause_automation`](/merchant-mcp/tools/pause_automation), [`resume_automation`](/merchant-mcp/tools/resume_automation) |
| `automation:delete` | [`delete_automation`](/merchant-mcp/tools/delete_automation) |
| `certificate:read` | [`list_certificates`](/merchant-mcp/tools/list_certificates), [`list_certificate_issues`](/merchant-mcp/tools/list_certificate_issues), [`certificate_stats`](/merchant-mcp/tools/certificate_stats) |
| `certificate:write` | [`issue_certificate`](/merchant-mcp/tools/issue_certificate), [`create_certificate`](/merchant-mcp/tools/create_certificate), [`update_certificate`](/merchant-mcp/tools/update_certificate), [`revoke_certificate_issue`](/merchant-mcp/tools/revoke_certificate_issue) |
| `certificate:delete` | [`delete_certificate`](/merchant-mcp/tools/delete_certificate) |
| `custompage:read` | [`list_pages`](/merchant-mcp/tools/list_pages), [`get_page`](/merchant-mcp/tools/get_page) |
| `custompage:write` | [`create_page`](/merchant-mcp/tools/create_page), [`update_page`](/merchant-mcp/tools/update_page), [`publish_page`](/merchant-mcp/tools/publish_page), [`unpublish_page`](/merchant-mcp/tools/unpublish_page) |
| `custompage:delete` | [`delete_page`](/merchant-mcp/tools/delete_page) |
| `customer:read` | [`customer_stats`](/merchant-mcp/tools/customer_stats), [`list_grants`](/merchant-mcp/tools/list_grants), [`list_feeds`](/merchant-mcp/tools/list_feeds), [`list_licenses`](/merchant-mcp/tools/list_licenses), [`get_license`](/merchant-mcp/tools/get_license), [`license_stats`](/merchant-mcp/tools/license_stats), [`list_license_activations`](/merchant-mcp/tools/list_license_activations), [`verify_license`](/merchant-mcp/tools/verify_license), [`refresh_license_token`](/merchant-mcp/tools/refresh_license_token), [`list_license_signing_keys`](/merchant-mcp/tools/list_license_signing_keys), [`list_entitlements`](/merchant-mcp/tools/list_entitlements), [`list_customers`](/merchant-mcp/tools/list_customers), [`list_customer_activity`](/merchant-mcp/tools/list_customer_activity), [`list_product_customers`](/merchant-mcp/tools/list_product_customers), [`product_customer_stats`](/merchant-mcp/tools/product_customer_stats), [`list_checkouts`](/merchant-mcp/tools/list_checkouts), [`get_customer`](/merchant-mcp/tools/get_customer), [`list_event_attendees`](/merchant-mcp/tools/list_event_attendees), [`event_attendee_stats`](/merchant-mcp/tools/event_attendee_stats), [`list_customer_answers`](/merchant-mcp/tools/list_customer_answers), [`list_product_requests`](/merchant-mcp/tools/list_product_requests) |
| `customer:write` | [`grant_access`](/merchant-mcp/tools/grant_access), [`revoke_grant`](/merchant-mcp/tools/revoke_grant), [`update_feed`](/merchant-mcp/tools/update_feed), [`revoke_feed`](/merchant-mcp/tools/revoke_feed), [`unblock_feed`](/merchant-mcp/tools/unblock_feed), [`update_license`](/merchant-mcp/tools/update_license), [`disable_license`](/merchant-mcp/tools/disable_license), [`enable_license`](/merchant-mcp/tools/enable_license), [`record_license`](/merchant-mcp/tools/record_license), [`deactivate_license_activation`](/merchant-mcp/tools/deactivate_license_activation), [`rotate_license`](/merchant-mcp/tools/rotate_license), [`activate_license`](/merchant-mcp/tools/activate_license), [`deactivate_license`](/merchant-mcp/tools/deactivate_license), [`rotate_license_signing_keys`](/merchant-mcp/tools/rotate_license_signing_keys), [`set_customer_answers`](/merchant-mcp/tools/set_customer_answers), [`approve_product_request`](/merchant-mcp/tools/approve_product_request), [`decline_product_request`](/merchant-mcp/tools/decline_product_request), [`promote_product_request`](/merchant-mcp/tools/promote_product_request) |
| `customer:delete` | [`erase_customer`](/merchant-mcp/tools/erase_customer) |
| `discount:read` | [`list_discounts`](/merchant-mcp/tools/list_discounts), [`get_discount`](/merchant-mcp/tools/get_discount), [`discount_stats`](/merchant-mcp/tools/discount_stats) |
| `discount:write` | [`create_discount`](/merchant-mcp/tools/create_discount), [`update_discount`](/merchant-mcp/tools/update_discount), [`archive_discount`](/merchant-mcp/tools/archive_discount), [`restore_discount`](/merchant-mcp/tools/restore_discount), [`restrict_discount`](/merchant-mcp/tools/restrict_discount), [`attach_discount`](/merchant-mcp/tools/attach_discount), [`detach_discount`](/merchant-mcp/tools/detach_discount) |
| `discount:delete` | [`delete_discount`](/merchant-mcp/tools/delete_discount) |
| `entry:read` | [`list_entries`](/merchant-mcp/tools/list_entries), [`list_entry_details`](/merchant-mcp/tools/list_entry_details), [`get_entry`](/merchant-mcp/tools/get_entry), [`entry_stats`](/merchant-mcp/tools/entry_stats), [`list_entry_sections`](/merchant-mcp/tools/list_entry_sections), [`list_entry_tags`](/merchant-mcp/tools/list_entry_tags), [`list_sections`](/merchant-mcp/tools/list_sections) |
| `entry:write` | [`create_entry`](/merchant-mcp/tools/create_entry), [`update_entry`](/merchant-mcp/tools/update_entry), [`publish_entry`](/merchant-mcp/tools/publish_entry), [`unpublish_entry`](/merchant-mcp/tools/unpublish_entry), [`reorder_entries`](/merchant-mcp/tools/reorder_entries), [`create_section`](/merchant-mcp/tools/create_section), [`rename_section`](/merchant-mcp/tools/rename_section), [`remove_section`](/merchant-mcp/tools/remove_section) |
| `entry:delete` | [`delete_entry`](/merchant-mcp/tools/delete_entry) |
| `file:read` | [`list_attachments`](/merchant-mcp/tools/list_attachments), [`get_body_schema`](/merchant-mcp/tools/get_body_schema), [`read_body`](/merchant-mcp/tools/read_body), [`list_prompts`](/merchant-mcp/tools/list_prompts), [`get_prompt`](/merchant-mcp/tools/get_prompt), [`list_assets`](/merchant-mcp/tools/list_assets), [`get_asset`](/merchant-mcp/tools/get_asset), [`get_quota`](/merchant-mcp/tools/get_quota), [`list_media_outputs`](/merchant-mcp/tools/list_media_outputs), [`get_media_output`](/merchant-mcp/tools/get_media_output), [`get_asset_url`](/merchant-mcp/tools/get_asset_url), [`product_file_stats`](/merchant-mcp/tools/product_file_stats), [`list_asset_deliveries`](/merchant-mcp/tools/list_asset_deliveries), [`list_asset_uses`](/merchant-mcp/tools/list_asset_uses) |
| `file:write` | [`set_body`](/merchant-mcp/tools/set_body), [`edit_body`](/merchant-mcp/tools/edit_body), [`publish_body`](/merchant-mcp/tools/publish_body), [`discard_staged`](/merchant-mcp/tools/discard_staged), [`attach_asset`](/merchant-mcp/tools/attach_asset), [`update_attachment`](/merchant-mcp/tools/update_attachment), [`reorder_attachments`](/merchant-mcp/tools/reorder_attachments), [`detach_attachment`](/merchant-mcp/tools/detach_attachment), [`create_prompt`](/merchant-mcp/tools/create_prompt), [`update_prompt`](/merchant-mcp/tools/update_prompt), [`set_product_poster`](/merchant-mcp/tools/set_product_poster), [`generate_media_output`](/merchant-mcp/tools/generate_media_output), [`update_media_output`](/merchant-mcp/tools/update_media_output), [`publish_media_output`](/merchant-mcp/tools/publish_media_output), [`create_asset`](/merchant-mcp/tools/create_asset), [`create_upload`](/merchant-mcp/tools/create_upload), [`create_inline_upload`](/merchant-mcp/tools/create_inline_upload), [`complete_upload`](/merchant-mcp/tools/complete_upload), [`cancel_upload`](/merchant-mcp/tools/cancel_upload), [`update_asset`](/merchant-mcp/tools/update_asset), [`move_asset`](/merchant-mcp/tools/move_asset), [`replace_asset`](/merchant-mcp/tools/replace_asset) |
| `file:delete` | [`delete_prompt`](/merchant-mcp/tools/delete_prompt), [`delete_media_output`](/merchant-mcp/tools/delete_media_output), [`delete_asset`](/merchant-mcp/tools/delete_asset) |
| `integration:read` | [`list_integrations`](/merchant-mcp/tools/list_integrations) |
| `integration:write` | [`set_integration`](/merchant-mcp/tools/set_integration) |
| `organization:read` | [`get_organization`](/merchant-mcp/tools/get_organization), [`get_balance`](/merchant-mcp/tools/get_balance), [`list_payouts`](/merchant-mcp/tools/list_payouts), [`preview_plan_store`](/merchant-mcp/tools/preview_plan_store), [`preview_plan_change`](/merchant-mcp/tools/preview_plan_change), [`list_notifications`](/merchant-mcp/tools/list_notifications), [`list_webhooks`](/merchant-mcp/tools/list_webhooks), [`get_webhook`](/merchant-mcp/tools/get_webhook), [`list_webhook_deliveries`](/merchant-mcp/tools/list_webhook_deliveries), [`list_merchants`](/merchant-mcp/tools/list_merchants), [`get_merchant`](/merchant-mcp/tools/get_merchant) |
| `organization:write` | [`update_organization`](/merchant-mcp/tools/update_organization), [`set_organization_logo`](/merchant-mcp/tools/set_organization_logo), [`change_plan`](/merchant-mcp/tools/change_plan), [`confirm_plan_change`](/merchant-mcp/tools/confirm_plan_change), [`cancel_plan_change`](/merchant-mcp/tools/cancel_plan_change), [`set_auto_upgrade`](/merchant-mcp/tools/set_auto_upgrade), [`set_auto_add_ons`](/merchant-mcp/tools/set_auto_add_ons), [`create_notification`](/merchant-mcp/tools/create_notification), [`update_notification`](/merchant-mcp/tools/update_notification), [`create_webhook`](/merchant-mcp/tools/create_webhook), [`update_webhook`](/merchant-mcp/tools/update_webhook), [`roll_webhook_secret`](/merchant-mcp/tools/roll_webhook_secret), [`resend_webhook_delivery`](/merchant-mcp/tools/resend_webhook_delivery) |
| `organization:delete` | [`delete_notification`](/merchant-mcp/tools/delete_notification), [`delete_webhook`](/merchant-mcp/tools/delete_webhook) |
| `portfolio:read` | [`get_portfolio`](/merchant-mcp/tools/get_portfolio), [`get_portfolio_valuation`](/merchant-mcp/tools/get_portfolio_valuation), [`list_holdings`](/merchant-mcp/tools/list_holdings), [`list_announced_files`](/merchant-mcp/tools/list_announced_files), [`list_portfolio_events`](/merchant-mcp/tools/list_portfolio_events), [`list_portfolio_snapshots`](/merchant-mcp/tools/list_portfolio_snapshots), [`search_symbols`](/merchant-mcp/tools/search_symbols), [`quote_symbols`](/merchant-mcp/tools/quote_symbols) |
| `portfolio:write` | [`update_portfolio`](/merchant-mcp/tools/update_portfolio), [`update_holding`](/merchant-mcp/tools/update_holding), [`record_portfolio_event`](/merchant-mcp/tools/record_portfolio_event) |
| `price:read` | [`list_prices`](/merchant-mcp/tools/list_prices), [`simulate_checkout`](/merchant-mcp/tools/simulate_checkout) |
| `price:write` | [`create_price`](/merchant-mcp/tools/create_price), [`update_price`](/merchant-mcp/tools/update_price), [`highlight_price`](/merchant-mcp/tools/highlight_price), [`archive_price`](/merchant-mcp/tools/archive_price), [`restore_price`](/merchant-mcp/tools/restore_price) |
| `price:delete` | [`delete_price`](/merchant-mcp/tools/delete_price) |
| `product:read` | [`list_categories`](/merchant-mcp/tools/list_categories), [`list_products`](/merchant-mcp/tools/list_products), [`get_product`](/merchant-mcp/tools/get_product), [`product_summaries`](/merchant-mcp/tools/product_summaries), [`list_tiers`](/merchant-mcp/tools/list_tiers), [`list_prompts`](/merchant-mcp/tools/list_prompts), [`get_prompt`](/merchant-mcp/tools/get_prompt), [`list_access_requirements`](/merchant-mcp/tools/list_access_requirements), [`list_resource_access`](/merchant-mcp/tools/list_resource_access), [`product_stats`](/merchant-mcp/tools/product_stats), [`catalog_stats`](/merchant-mcp/tools/catalog_stats), [`product_traffic_stats`](/merchant-mcp/tools/product_traffic_stats), [`list_product_questions`](/merchant-mcp/tools/list_product_questions), [`list_event_sessions`](/merchant-mcp/tools/list_event_sessions), [`get_event_cancellation`](/merchant-mcp/tools/get_event_cancellation), [`list_software_events`](/merchant-mcp/tools/list_software_events) |
| `product:write` | [`create_product`](/merchant-mcp/tools/create_product), [`update_product`](/merchant-mcp/tools/update_product), [`publish_product`](/merchant-mcp/tools/publish_product), [`unpublish_product`](/merchant-mcp/tools/unpublish_product), [`discontinue_product`](/merchant-mcp/tools/discontinue_product), [`reinstate_product`](/merchant-mcp/tools/reinstate_product), [`unlist_product`](/merchant-mcp/tools/unlist_product), [`relist_product`](/merchant-mcp/tools/relist_product), [`create_tier`](/merchant-mcp/tools/create_tier), [`update_tier`](/merchant-mcp/tools/update_tier), [`reorder_tiers`](/merchant-mcp/tools/reorder_tiers), [`create_prompt`](/merchant-mcp/tools/create_prompt), [`update_prompt`](/merchant-mcp/tools/update_prompt), [`delete_prompt`](/merchant-mcp/tools/delete_prompt), [`set_product_poster`](/merchant-mcp/tools/set_product_poster), [`set_access_requirement`](/merchant-mcp/tools/set_access_requirement), [`clear_access_requirement`](/merchant-mcp/tools/clear_access_requirement), [`create_product_question`](/merchant-mcp/tools/create_product_question), [`update_product_question`](/merchant-mcp/tools/update_product_question), [`create_event_session`](/merchant-mcp/tools/create_event_session), [`update_event_session`](/merchant-mcp/tools/update_event_session), [`record_software_event`](/merchant-mcp/tools/record_software_event), [`update_software_event`](/merchant-mcp/tools/update_software_event) |
| `product:delete` | [`delete_product`](/merchant-mcp/tools/delete_product), [`delete_tier`](/merchant-mcp/tools/delete_tier), [`delete_product_question`](/merchant-mcp/tools/delete_product_question), [`delete_event_session`](/merchant-mcp/tools/delete_event_session), [`delete_software_event`](/merchant-mcp/tools/delete_software_event) |
| `quiz:read` | [`list_attempts`](/merchant-mcp/tools/list_attempts), [`get_attempt`](/merchant-mcp/tools/get_attempt), [`list_quizzes`](/merchant-mcp/tools/list_quizzes), [`get_quiz`](/merchant-mcp/tools/get_quiz), [`quiz_stats`](/merchant-mcp/tools/quiz_stats) |
| `quiz:write` | [`create_quiz`](/merchant-mcp/tools/create_quiz), [`update_quiz`](/merchant-mcp/tools/update_quiz) |
| `quiz:delete` | [`delete_quiz`](/merchant-mcp/tools/delete_quiz), [`clear_attempts`](/merchant-mcp/tools/clear_attempts), [`delete_attempt`](/merchant-mcp/tools/delete_attempt) |
| `revenue:read` | No tool needs it alone: without it, amounts read back as null, and a webhook for an event carrying them is refused. |
| `review:read` | [`list_reviews`](/merchant-mcp/tools/list_reviews), [`review_stats`](/merchant-mcp/tools/review_stats) |
| `review:write` | [`reply_to_review`](/merchant-mcp/tools/reply_to_review) |
| `review:moderate` | [`hide_review`](/merchant-mcp/tools/hide_review), [`unhide_review`](/merchant-mcp/tools/unhide_review) |
| `site:read` | [`get_store`](/merchant-mcp/tools/get_store), [`get_settings`](/merchant-mcp/tools/get_settings), [`get_plan_usage`](/merchant-mcp/tools/get_plan_usage), [`get_domain`](/merchant-mcp/tools/get_domain), [`list_redirects`](/merchant-mcp/tools/list_redirects), [`check_path`](/merchant-mcp/tools/check_path) |
| `site:write` | [`update_settings`](/merchant-mcp/tools/update_settings), [`update_store`](/merchant-mcp/tools/update_store), [`connect_domain`](/merchant-mcp/tools/connect_domain), [`check_domain`](/merchant-mcp/tools/check_domain), [`remove_domain`](/merchant-mcp/tools/remove_domain), [`set_store_icon`](/merchant-mcp/tools/set_store_icon), [`create_redirect`](/merchant-mcp/tools/create_redirect), [`update_redirect`](/merchant-mcp/tools/update_redirect) |
| `site:delete` | [`delete_redirect`](/merchant-mcp/tools/delete_redirect) |
| `subscription:read` | [`subscription_stats`](/merchant-mcp/tools/subscription_stats), [`list_subscriptions`](/merchant-mcp/tools/list_subscriptions), [`list_subscription_periods`](/merchant-mcp/tools/list_subscription_periods), [`list_subscription_transitions`](/merchant-mcp/tools/list_subscription_transitions), [`get_subscription`](/merchant-mcp/tools/get_subscription) |
| `subscription:write` | [`cancel_subscription`](/merchant-mcp/tools/cancel_subscription), [`resume_subscription`](/merchant-mcp/tools/resume_subscription) |
| `transaction:read` | [`store_stats`](/merchant-mcp/tools/store_stats), [`order_stats`](/merchant-mcp/tools/order_stats), [`store_totals`](/merchant-mcp/tools/store_totals), [`traffic_stats`](/merchant-mcp/tools/traffic_stats), [`conversion_stats`](/merchant-mcp/tools/conversion_stats), [`call_stats`](/merchant-mcp/tools/call_stats), [`list_orders`](/merchant-mcp/tools/list_orders), [`get_order`](/merchant-mcp/tools/get_order), [`list_order_items`](/merchant-mcp/tools/list_order_items), [`list_order_settlements`](/merchant-mcp/tools/list_order_settlements), [`list_order_refunds`](/merchant-mcp/tools/list_order_refunds), [`list_order_affiliates`](/merchant-mcp/tools/list_order_affiliates), [`list_revocations`](/merchant-mcp/tools/list_revocations), [`list_event_refunds`](/merchant-mcp/tools/list_event_refunds) |
| `transaction:write` | [`record_refund`](/merchant-mcp/tools/record_refund), [`record_order`](/merchant-mcp/tools/record_order), [`create_revocation`](/merchant-mcp/tools/create_revocation), [`retry_revocation_refund`](/merchant-mcp/tools/retry_revocation_refund), [`cancel_event`](/merchant-mcp/tools/cancel_event), [`retry_event_refund`](/merchant-mcp/tools/retry_event_refund) |

Source: https://docs.sherpo.io/merchant-mcp/scopes/index.mdx
