deploy

README.md

@@ -0,0 +1,11 @@
+# square-connect-openapi-agent
+
+Generated A2APack agent for Square.
+
+- Source OpenAPI: https://raw.githubusercontent.com/square/connect-api-specification/master/api.json
+- Generated operations: 328
+- Main skill: `auto`
+- Routing mode: DeepAgents subagents across 32 route groups
+
+The generated code is intentionally editable. Tune prompts, operation
+grouping, auth names, and safety policy before publishing serious agents.

a2a.yaml

@@ -0,0 +1,13 @@
+name: square-connect-openapi-agent
+version: '2.0'
+entrypoint: agent:SquareConnectOpenapiAgent
+description: Commerce API for payments, orders, catalogs, customers, inventory, and
+  locations.
+runtime:
+  resources:
+    cpu: 200m
+    memory: 512Mi
+  egress:
+    allow_hosts:
+    - connect.squareup.com
+    deny_internet_by_default: true

requirements.txt

@@ -0,0 +1,7 @@
+# a2a-pack is installed by the platform base image.
+deepagents>=0.5.0
+langchain>=0.3
+langchain-openai>=0.2
+langchain-core>=0.3
+langgraph>=0.6
+httpx>=0.27

skills/apple-pay/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: apple-pay-routes
+description: Handle 1 OpenAPI operation(s) under /v2/apple-pay/domains for the apple pay route group.
+---
+
+# apple pay API Routes
+
+Handle 1 OpenAPI operation(s) under /v2/apple-pay/domains for the apple pay route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### register_domain
+
+- Operation ID: `register_domain`
+- Route: `POST /v2/apple-pay/domains`
+- Mode: WRITE
+- Summary: RegisterDomain
+- Body: JSON request body accepted.

skills/bank-accounts/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: bank-accounts-routes
+description: Handle 5 OpenAPI operation(s) under /v2/bank-accounts for the bank accounts route group.
+---
+
+# bank accounts API Routes
+
+Handle 5 OpenAPI operation(s) under /v2/bank-accounts for the bank accounts route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_bank_accounts
+
+- Operation ID: `list_bank_accounts`
+- Route: `GET /v2/bank-accounts`
+- Mode: READ
+- Summary: ListBankAccounts
+- Parameters:
+  - `cursor` in `query`
+  - `limit` in `query`
+  - `location_id` in `query`
+  - `customer_id` in `query`
+
+### create_bank_account
+
+- Operation ID: `create_bank_account`
+- Route: `POST /v2/bank-accounts`
+- Mode: WRITE
+- Summary: CreateBankAccount
+- Body: JSON request body accepted.
+
+### get_bank_account_by_v1_id
+
+- Operation ID: `get_bank_account_by_v1_id`
+- Route: `GET /v2/bank-accounts/by-v1-id/{v1_bank_account_id}`
+- Mode: READ
+- Summary: GetBankAccountByV1Id
+- Parameters:
+  - `v1_bank_account_id` in `path` required
+
+### get_bank_account
+
+- Operation ID: `get_bank_account`
+- Route: `GET /v2/bank-accounts/{bank_account_id}`
+- Mode: READ
+- Summary: GetBankAccount
+- Parameters:
+  - `bank_account_id` in `path` required
+
+### disable_bank_account
+
+- Operation ID: `disable_bank_account`
+- Route: `POST /v2/bank-accounts/{bank_account_id}/disable`
+- Mode: WRITE
+- Summary: DisableBankAccount
+- Parameters:
+  - `bank_account_id` in `path` required

skills/bookings/SKILL.md

@@ -0,0 +1,245 @@
+---
+name: bookings-routes
+description: Handle 24 OpenAPI operation(s) under /v2/bookings for the bookings route group.
+---
+
+# bookings API Routes
+
+Handle 24 OpenAPI operation(s) under /v2/bookings for the bookings route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_bookings
+
+- Operation ID: `list_bookings`
+- Route: `GET /v2/bookings`
+- Mode: READ
+- Summary: ListBookings
+- Parameters:
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `customer_id` in `query`
+  - `team_member_id` in `query`
+  - `location_id` in `query`
+  - `start_at_min` in `query`
+  - `start_at_max` in `query`
+
+### create_booking
+
+- Operation ID: `create_booking`
+- Route: `POST /v2/bookings`
+- Mode: WRITE
+- Summary: CreateBooking
+- Body: JSON request body accepted.
+
+### search_availability
+
+- Operation ID: `search_availability`
+- Route: `POST /v2/bookings/availability/search`
+- Mode: WRITE
+- Summary: SearchAvailability
+- Body: JSON request body accepted.
+
+### bulk_retrieve_bookings
+
+- Operation ID: `bulk_retrieve_bookings`
+- Route: `POST /v2/bookings/bulk-retrieve`
+- Mode: WRITE
+- Summary: BulkRetrieveBookings
+- Body: JSON request body accepted.
+
+### retrieve_business_booking_profile
+
+- Operation ID: `retrieve_business_booking_profile`
+- Route: `GET /v2/bookings/business-booking-profile`
+- Mode: READ
+- Summary: RetrieveBusinessBookingProfile
+
+### list_booking_custom_attribute_definitions
+
+- Operation ID: `list_booking_custom_attribute_definitions`
+- Route: `GET /v2/bookings/custom-attribute-definitions`
+- Mode: READ
+- Summary: ListBookingCustomAttributeDefinitions
+- Parameters:
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### create_booking_custom_attribute_definition
+
+- Operation ID: `create_booking_custom_attribute_definition`
+- Route: `POST /v2/bookings/custom-attribute-definitions`
+- Mode: WRITE
+- Summary: CreateBookingCustomAttributeDefinition
+- Body: JSON request body accepted.
+
+### delete_booking_custom_attribute_definition
+
+- Operation ID: `delete_booking_custom_attribute_definition`
+- Route: `DELETE /v2/bookings/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: DeleteBookingCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+
+### retrieve_booking_custom_attribute_definition
+
+- Operation ID: `retrieve_booking_custom_attribute_definition`
+- Route: `GET /v2/bookings/custom-attribute-definitions/{key}`
+- Mode: READ
+- Summary: RetrieveBookingCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+  - `version` in `query`
+
+### update_booking_custom_attribute_definition
+
+- Operation ID: `update_booking_custom_attribute_definition`
+- Route: `PUT /v2/bookings/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: UpdateBookingCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+- Body: JSON request body accepted.
+
+### bulk_delete_booking_custom_attributes
+
+- Operation ID: `bulk_delete_booking_custom_attributes`
+- Route: `POST /v2/bookings/custom-attributes/bulk-delete`
+- Mode: WRITE
+- Summary: BulkDeleteBookingCustomAttributes
+- Body: JSON request body accepted.
+
+### bulk_upsert_booking_custom_attributes
+
+- Operation ID: `bulk_upsert_booking_custom_attributes`
+- Route: `POST /v2/bookings/custom-attributes/bulk-upsert`
+- Mode: WRITE
+- Summary: BulkUpsertBookingCustomAttributes
+- Body: JSON request body accepted.
+
+### list_location_booking_profiles
+
+- Operation ID: `list_location_booking_profiles`
+- Route: `GET /v2/bookings/location-booking-profiles`
+- Mode: READ
+- Summary: ListLocationBookingProfiles
+- Parameters:
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### retrieve_location_booking_profile
+
+- Operation ID: `retrieve_location_booking_profile`
+- Route: `GET /v2/bookings/location-booking-profiles/{location_id}`
+- Mode: READ
+- Summary: RetrieveLocationBookingProfile
+- Parameters:
+  - `location_id` in `path` required
+
+### list_team_member_booking_profiles
+
+- Operation ID: `list_team_member_booking_profiles`
+- Route: `GET /v2/bookings/team-member-booking-profiles`
+- Mode: READ
+- Summary: ListTeamMemberBookingProfiles
+- Parameters:
+  - `bookable_only` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `location_id` in `query`
+
+### bulk_retrieve_team_member_booking_profiles
+
+- Operation ID: `bulk_retrieve_team_member_booking_profiles`
+- Route: `POST /v2/bookings/team-member-booking-profiles/bulk-retrieve`
+- Mode: WRITE
+- Summary: BulkRetrieveTeamMemberBookingProfiles
+- Body: JSON request body accepted.
+
+### retrieve_team_member_booking_profile
+
+- Operation ID: `retrieve_team_member_booking_profile`
+- Route: `GET /v2/bookings/team-member-booking-profiles/{team_member_id}`
+- Mode: READ
+- Summary: RetrieveTeamMemberBookingProfile
+- Parameters:
+  - `team_member_id` in `path` required
+
+### retrieve_booking
+
+- Operation ID: `retrieve_booking`
+- Route: `GET /v2/bookings/{booking_id}`
+- Mode: READ
+- Summary: RetrieveBooking
+- Parameters:
+  - `booking_id` in `path` required
+
+### update_booking
+
+- Operation ID: `update_booking`
+- Route: `PUT /v2/bookings/{booking_id}`
+- Mode: WRITE
+- Summary: UpdateBooking
+- Parameters:
+  - `booking_id` in `path` required
+- Body: JSON request body accepted.
+
+### cancel_booking
+
+- Operation ID: `cancel_booking`
+- Route: `POST /v2/bookings/{booking_id}/cancel`
+- Mode: WRITE
+- Summary: CancelBooking
+- Parameters:
+  - `booking_id` in `path` required
+- Body: JSON request body accepted.
+
+### list_booking_custom_attributes
+
+- Operation ID: `list_booking_custom_attributes`
+- Route: `GET /v2/bookings/{booking_id}/custom-attributes`
+- Mode: READ
+- Summary: ListBookingCustomAttributes
+- Parameters:
+  - `booking_id` in `path` required
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `with_definitions` in `query`
+
+### delete_booking_custom_attribute
+
+- Operation ID: `delete_booking_custom_attribute`
+- Route: `DELETE /v2/bookings/{booking_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: DeleteBookingCustomAttribute
+- Parameters:
+  - `booking_id` in `path` required
+  - `key` in `path` required
+
+### retrieve_booking_custom_attribute
+
+- Operation ID: `retrieve_booking_custom_attribute`
+- Route: `GET /v2/bookings/{booking_id}/custom-attributes/{key}`
+- Mode: READ
+- Summary: RetrieveBookingCustomAttribute
+- Parameters:
+  - `booking_id` in `path` required
+  - `key` in `path` required
+  - `with_definition` in `query`
+  - `version` in `query`
+
+### upsert_booking_custom_attribute
+
+- Operation ID: `upsert_booking_custom_attribute`
+- Route: `PUT /v2/bookings/{booking_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: UpsertBookingCustomAttribute
+- Parameters:
+  - `booking_id` in `path` required
+  - `key` in `path` required
+- Body: JSON request body accepted.

skills/cards/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: cards-routes
+description: Handle 4 OpenAPI operation(s) under /v2/cards for the cards route group.
+---
+
+# cards API Routes
+
+Handle 4 OpenAPI operation(s) under /v2/cards for the cards route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_cards
+
+- Operation ID: `list_cards`
+- Route: `GET /v2/cards`
+- Mode: READ
+- Summary: ListCards
+- Parameters:
+  - `cursor` in `query`
+  - `customer_id` in `query`
+  - `include_disabled` in `query`
+  - `reference_id` in `query`
+  - `sort_order` in `query`
+
+### create_card
+
+- Operation ID: `create_card`
+- Route: `POST /v2/cards`
+- Mode: WRITE
+- Summary: CreateCard
+- Body: JSON request body accepted.
+
+### retrieve_card
+
+- Operation ID: `retrieve_card`
+- Route: `GET /v2/cards/{card_id}`
+- Mode: READ
+- Summary: RetrieveCard
+- Parameters:
+  - `card_id` in `path` required
+
+### disable_card
+
+- Operation ID: `disable_card`
+- Route: `POST /v2/cards/{card_id}/disable`
+- Mode: WRITE
+- Summary: DisableCard
+- Parameters:
+  - `card_id` in `path` required

skills/cash-drawers/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: cash-drawers-routes
+description: Handle 3 OpenAPI operation(s) under /v2/cash-drawers/shifts for the cash drawers route group.
+---
+
+# cash drawers API Routes
+
+Handle 3 OpenAPI operation(s) under /v2/cash-drawers/shifts for the cash drawers route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_cash_drawer_shifts
+
+- Operation ID: `list_cash_drawer_shifts`
+- Route: `GET /v2/cash-drawers/shifts`
+- Mode: READ
+- Summary: ListCashDrawerShifts
+- Parameters:
+  - `location_id` in `query` required
+  - `sort_order` in `query`
+  - `begin_time` in `query`
+  - `end_time` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### retrieve_cash_drawer_shift
+
+- Operation ID: `retrieve_cash_drawer_shift`
+- Route: `GET /v2/cash-drawers/shifts/{shift_id}`
+- Mode: READ
+- Summary: RetrieveCashDrawerShift
+- Parameters:
+  - `location_id` in `query` required
+  - `shift_id` in `path` required
+
+### list_cash_drawer_shift_events
+
+- Operation ID: `list_cash_drawer_shift_events`
+- Route: `GET /v2/cash-drawers/shifts/{shift_id}/events`
+- Mode: READ
+- Summary: ListCashDrawerShiftEvents
+- Parameters:
+  - `location_id` in `query` required
+  - `shift_id` in `path` required
+  - `limit` in `query`
+  - `cursor` in `query`

skills/catalog/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: catalog-routes
+description: Handle 14 OpenAPI operation(s) under /v2/catalog for the catalog route group.
+---
+
+# catalog API Routes
+
+Handle 14 OpenAPI operation(s) under /v2/catalog for the catalog route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### batch_delete_catalog_objects
+
+- Operation ID: `batch_delete_catalog_objects`
+- Route: `POST /v2/catalog/batch-delete`
+- Mode: WRITE
+- Summary: BatchDeleteCatalogObjects
+- Body: JSON request body accepted.
+
+### batch_retrieve_catalog_objects
+
+- Operation ID: `batch_retrieve_catalog_objects`
+- Route: `POST /v2/catalog/batch-retrieve`
+- Mode: WRITE
+- Summary: BatchRetrieveCatalogObjects
+- Body: JSON request body accepted.
+
+### batch_upsert_catalog_objects
+
+- Operation ID: `batch_upsert_catalog_objects`
+- Route: `POST /v2/catalog/batch-upsert`
+- Mode: WRITE
+- Summary: BatchUpsertCatalogObjects
+- Body: JSON request body accepted.
+
+### create_catalog_image
+
+- Operation ID: `create_catalog_image`
+- Route: `POST /v2/catalog/images`
+- Mode: WRITE
+- Summary: CreateCatalogImage
+- Body: JSON request body accepted.
+
+### update_catalog_image
+
+- Operation ID: `update_catalog_image`
+- Route: `PUT /v2/catalog/images/{image_id}`
+- Mode: WRITE
+- Summary: UpdateCatalogImage
+- Parameters:
+  - `image_id` in `path` required
+- Body: JSON request body accepted.
+
+### catalog_info
+
+- Operation ID: `catalog_info`
+- Route: `GET /v2/catalog/info`
+- Mode: READ
+- Summary: CatalogInfo
+
+### list_catalog
+
+- Operation ID: `list_catalog`
+- Route: `GET /v2/catalog/list`
+- Mode: READ
+- Summary: ListCatalog
+- Parameters:
+  - `cursor` in `query`
+  - `types` in `query`
+  - `catalog_version` in `query`
+
+### upsert_catalog_object
+
+- Operation ID: `upsert_catalog_object`
+- Route: `POST /v2/catalog/object`
+- Mode: WRITE
+- Summary: UpsertCatalogObject
+- Body: JSON request body accepted.
+
+### delete_catalog_object
+
+- Operation ID: `delete_catalog_object`
+- Route: `DELETE /v2/catalog/object/{object_id}`
+- Mode: WRITE
+- Summary: DeleteCatalogObject
+- Parameters:
+  - `object_id` in `path` required
+
+### retrieve_catalog_object
+
+- Operation ID: `retrieve_catalog_object`
+- Route: `GET /v2/catalog/object/{object_id}`
+- Mode: READ
+- Summary: RetrieveCatalogObject
+- Parameters:
+  - `object_id` in `path` required
+  - `include_related_objects` in `query`
+  - `catalog_version` in `query`
+  - `include_category_path_to_root` in `query`
+
+### search_catalog_objects
+
+- Operation ID: `search_catalog_objects`
+- Route: `POST /v2/catalog/search`
+- Mode: WRITE
+- Summary: SearchCatalogObjects
+- Body: JSON request body accepted.
+
+### search_catalog_items
+
+- Operation ID: `search_catalog_items`
+- Route: `POST /v2/catalog/search-catalog-items`
+- Mode: WRITE
+- Summary: SearchCatalogItems
+- Body: JSON request body accepted.
+
+### update_item_modifier_lists
+
+- Operation ID: `update_item_modifier_lists`
+- Route: `POST /v2/catalog/update-item-modifier-lists`
+- Mode: WRITE
+- Summary: UpdateItemModifierLists
+- Body: JSON request body accepted.
+
+### update_item_taxes
+
+- Operation ID: `update_item_taxes`
+- Route: `POST /v2/catalog/update-item-taxes`
+- Mode: WRITE
+- Summary: UpdateItemTaxes
+- Body: JSON request body accepted.

skills/channels/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: channels-routes
+description: Handle 3 OpenAPI operation(s) under /v2/channels for the channels route group.
+---
+
+# channels API Routes
+
+Handle 3 OpenAPI operation(s) under /v2/channels for the channels route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_channels
+
+- Operation ID: `list_channels`
+- Route: `GET /v2/channels`
+- Mode: READ
+- Summary: ListChannels
+- Parameters:
+  - `reference_type` in `query`
+  - `reference_id` in `query`
+  - `status` in `query`
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### bulk_retrieve_channels
+
+- Operation ID: `bulk_retrieve_channels`
+- Route: `POST /v2/channels/bulk-retrieve`
+- Mode: WRITE
+- Summary: BulkRetrieveChannels
+- Body: JSON request body accepted.
+
+### retrieve_channel
+
+- Operation ID: `retrieve_channel`
+- Route: `GET /v2/channels/{channel_id}`
+- Mode: READ
+- Summary: RetrieveChannel
+- Parameters:
+  - `channel_id` in `path` required

skills/customers/SKILL.md

@@ -0,0 +1,309 @@
+---
+name: customers-routes
+description: Handle 31 OpenAPI operation(s) under /v2/customers for the customers route group.
+---
+
+# customers API Routes
+
+Handle 31 OpenAPI operation(s) under /v2/customers for the customers route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_customers
+
+- Operation ID: `list_customers`
+- Route: `GET /v2/customers`
+- Mode: READ
+- Summary: ListCustomers
+- Parameters:
+  - `cursor` in `query`
+  - `limit` in `query`
+  - `sort_field` in `query`
+  - `sort_order` in `query`
+  - `count` in `query`
+
+### create_customer
+
+- Operation ID: `create_customer`
+- Route: `POST /v2/customers`
+- Mode: WRITE
+- Summary: CreateCustomer
+- Body: JSON request body accepted.
+
+### bulk_create_customers
+
+- Operation ID: `bulk_create_customers`
+- Route: `POST /v2/customers/bulk-create`
+- Mode: WRITE
+- Summary: BulkCreateCustomers
+- Body: JSON request body accepted.
+
+### bulk_delete_customers
+
+- Operation ID: `bulk_delete_customers`
+- Route: `POST /v2/customers/bulk-delete`
+- Mode: WRITE
+- Summary: BulkDeleteCustomers
+- Body: JSON request body accepted.
+
+### bulk_retrieve_customers
+
+- Operation ID: `bulk_retrieve_customers`
+- Route: `POST /v2/customers/bulk-retrieve`
+- Mode: WRITE
+- Summary: BulkRetrieveCustomers
+- Body: JSON request body accepted.
+
+### bulk_update_customers
+
+- Operation ID: `bulk_update_customers`
+- Route: `POST /v2/customers/bulk-update`
+- Mode: WRITE
+- Summary: BulkUpdateCustomers
+- Body: JSON request body accepted.
+
+### list_customer_custom_attribute_definitions
+
+- Operation ID: `list_customer_custom_attribute_definitions`
+- Route: `GET /v2/customers/custom-attribute-definitions`
+- Mode: READ
+- Summary: ListCustomerCustomAttributeDefinitions
+- Parameters:
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### create_customer_custom_attribute_definition
+
+- Operation ID: `create_customer_custom_attribute_definition`
+- Route: `POST /v2/customers/custom-attribute-definitions`
+- Mode: WRITE
+- Summary: CreateCustomerCustomAttributeDefinition
+- Body: JSON request body accepted.
+
+### delete_customer_custom_attribute_definition
+
+- Operation ID: `delete_customer_custom_attribute_definition`
+- Route: `DELETE /v2/customers/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: DeleteCustomerCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+
+### retrieve_customer_custom_attribute_definition
+
+- Operation ID: `retrieve_customer_custom_attribute_definition`
+- Route: `GET /v2/customers/custom-attribute-definitions/{key}`
+- Mode: READ
+- Summary: RetrieveCustomerCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+  - `version` in `query`
+
+### update_customer_custom_attribute_definition
+
+- Operation ID: `update_customer_custom_attribute_definition`
+- Route: `PUT /v2/customers/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: UpdateCustomerCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+- Body: JSON request body accepted.
+
+### bulk_upsert_customer_custom_attributes
+
+- Operation ID: `bulk_upsert_customer_custom_attributes`
+- Route: `POST /v2/customers/custom-attributes/bulk-upsert`
+- Mode: WRITE
+- Summary: BulkUpsertCustomerCustomAttributes
+- Body: JSON request body accepted.
+
+### list_customer_groups
+
+- Operation ID: `list_customer_groups`
+- Route: `GET /v2/customers/groups`
+- Mode: READ
+- Summary: ListCustomerGroups
+- Parameters:
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### create_customer_group
+
+- Operation ID: `create_customer_group`
+- Route: `POST /v2/customers/groups`
+- Mode: WRITE
+- Summary: CreateCustomerGroup
+- Body: JSON request body accepted.
+
+### delete_customer_group
+
+- Operation ID: `delete_customer_group`
+- Route: `DELETE /v2/customers/groups/{group_id}`
+- Mode: WRITE
+- Summary: DeleteCustomerGroup
+- Parameters:
+  - `group_id` in `path` required
+
+### retrieve_customer_group
+
+- Operation ID: `retrieve_customer_group`
+- Route: `GET /v2/customers/groups/{group_id}`
+- Mode: READ
+- Summary: RetrieveCustomerGroup
+- Parameters:
+  - `group_id` in `path` required
+
+### update_customer_group
+
+- Operation ID: `update_customer_group`
+- Route: `PUT /v2/customers/groups/{group_id}`
+- Mode: WRITE
+- Summary: UpdateCustomerGroup
+- Parameters:
+  - `group_id` in `path` required
+- Body: JSON request body accepted.
+
+### search_customers
+
+- Operation ID: `search_customers`
+- Route: `POST /v2/customers/search`
+- Mode: WRITE
+- Summary: SearchCustomers
+- Body: JSON request body accepted.
+
+### list_customer_segments
+
+- Operation ID: `list_customer_segments`
+- Route: `GET /v2/customers/segments`
+- Mode: READ
+- Summary: ListCustomerSegments
+- Parameters:
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### retrieve_customer_segment
+
+- Operation ID: `retrieve_customer_segment`
+- Route: `GET /v2/customers/segments/{segment_id}`
+- Mode: READ
+- Summary: RetrieveCustomerSegment
+- Parameters:
+  - `segment_id` in `path` required
+
+### delete_customer
+
+- Operation ID: `delete_customer`
+- Route: `DELETE /v2/customers/{customer_id}`
+- Mode: WRITE
+- Summary: DeleteCustomer
+- Parameters:
+  - `customer_id` in `path` required
+  - `version` in `query`
+
+### retrieve_customer
+
+- Operation ID: `retrieve_customer`
+- Route: `GET /v2/customers/{customer_id}`
+- Mode: READ
+- Summary: RetrieveCustomer
+- Parameters:
+  - `customer_id` in `path` required
+
+### update_customer
+
+- Operation ID: `update_customer`
+- Route: `PUT /v2/customers/{customer_id}`
+- Mode: WRITE
+- Summary: UpdateCustomer
+- Parameters:
+  - `customer_id` in `path` required
+- Body: JSON request body accepted.
+
+### create_customer_card
+
+- Operation ID: `create_customer_card`
+- Route: `POST /v2/customers/{customer_id}/cards`
+- Mode: WRITE
+- Summary: CreateCustomerCard
+- Parameters:
+  - `customer_id` in `path` required
+- Body: JSON request body accepted.
+
+### delete_customer_card
+
+- Operation ID: `delete_customer_card`
+- Route: `DELETE /v2/customers/{customer_id}/cards/{card_id}`
+- Mode: WRITE
+- Summary: DeleteCustomerCard
+- Parameters:
+  - `customer_id` in `path` required
+  - `card_id` in `path` required
+
+### list_customer_custom_attributes
+
+- Operation ID: `list_customer_custom_attributes`
+- Route: `GET /v2/customers/{customer_id}/custom-attributes`
+- Mode: READ
+- Summary: ListCustomerCustomAttributes
+- Parameters:
+  - `customer_id` in `path` required
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `with_definitions` in `query`
+
+### delete_customer_custom_attribute
+
+- Operation ID: `delete_customer_custom_attribute`
+- Route: `DELETE /v2/customers/{customer_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: DeleteCustomerCustomAttribute
+- Parameters:
+  - `customer_id` in `path` required
+  - `key` in `path` required
+
+### retrieve_customer_custom_attribute
+
+- Operation ID: `retrieve_customer_custom_attribute`
+- Route: `GET /v2/customers/{customer_id}/custom-attributes/{key}`
+- Mode: READ
+- Summary: RetrieveCustomerCustomAttribute
+- Parameters:
+  - `customer_id` in `path` required
+  - `key` in `path` required
+  - `with_definition` in `query`
+  - `version` in `query`
+
+### upsert_customer_custom_attribute
+
+- Operation ID: `upsert_customer_custom_attribute`
+- Route: `POST /v2/customers/{customer_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: UpsertCustomerCustomAttribute
+- Parameters:
+  - `customer_id` in `path` required
+  - `key` in `path` required
+- Body: JSON request body accepted.
+
+### remove_group_from_customer
+
+- Operation ID: `remove_group_from_customer`
+- Route: `DELETE /v2/customers/{customer_id}/groups/{group_id}`
+- Mode: WRITE
+- Summary: RemoveGroupFromCustomer
+- Parameters:
+  - `customer_id` in `path` required
+  - `group_id` in `path` required
+
+### add_group_to_customer
+
+- Operation ID: `add_group_to_customer`
+- Route: `PUT /v2/customers/{customer_id}/groups/{group_id}`
+- Mode: WRITE
+- Summary: AddGroupToCustomer
+- Parameters:
+  - `customer_id` in `path` required
+  - `group_id` in `path` required

skills/devices/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: devices-routes
+description: Handle 5 OpenAPI operation(s) under /v2/devices for the devices route group.
+---
+
+# devices API Routes
+
+Handle 5 OpenAPI operation(s) under /v2/devices for the devices route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_devices
+
+- Operation ID: `list_devices`
+- Route: `GET /v2/devices`
+- Mode: READ
+- Summary: ListDevices
+- Parameters:
+  - `cursor` in `query`
+  - `sort_order` in `query`
+  - `limit` in `query`
+  - `location_id` in `query`
+
+### list_device_codes
+
+- Operation ID: `list_device_codes`
+- Route: `GET /v2/devices/codes`
+- Mode: READ
+- Summary: ListDeviceCodes
+- Parameters:
+  - `cursor` in `query`
+  - `location_id` in `query`
+  - `product_type` in `query`
+  - `status` in `query`
+
+### create_device_code
+
+- Operation ID: `create_device_code`
+- Route: `POST /v2/devices/codes`
+- Mode: WRITE
+- Summary: CreateDeviceCode
+- Body: JSON request body accepted.
+
+### get_device_code
+
+- Operation ID: `get_device_code`
+- Route: `GET /v2/devices/codes/{id}`
+- Mode: READ
+- Summary: GetDeviceCode
+- Parameters:
+  - `id` in `path` required
+
+### get_device
+
+- Operation ID: `get_device`
+- Route: `GET /v2/devices/{device_id}`
+- Mode: READ
+- Summary: GetDevice
+- Parameters:
+  - `device_id` in `path` required

skills/disputes/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: disputes-routes
+description: Handle 9 OpenAPI operation(s) under /v2/disputes for the disputes route group.
+---
+
+# disputes API Routes
+
+Handle 9 OpenAPI operation(s) under /v2/disputes for the disputes route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_disputes
+
+- Operation ID: `list_disputes`
+- Route: `GET /v2/disputes`
+- Mode: READ
+- Summary: ListDisputes
+- Parameters:
+  - `cursor` in `query`
+  - `states` in `query`
+  - `location_id` in `query`
+
+### retrieve_dispute
+
+- Operation ID: `retrieve_dispute`
+- Route: `GET /v2/disputes/{dispute_id}`
+- Mode: READ
+- Summary: RetrieveDispute
+- Parameters:
+  - `dispute_id` in `path` required
+
+### accept_dispute
+
+- Operation ID: `accept_dispute`
+- Route: `POST /v2/disputes/{dispute_id}/accept`
+- Mode: WRITE
+- Summary: AcceptDispute
+- Parameters:
+  - `dispute_id` in `path` required
+
+### list_dispute_evidence
+
+- Operation ID: `list_dispute_evidence`
+- Route: `GET /v2/disputes/{dispute_id}/evidence`
+- Mode: READ
+- Summary: ListDisputeEvidence
+- Parameters:
+  - `dispute_id` in `path` required
+  - `cursor` in `query`
+
+### create_dispute_evidence_file
+
+- Operation ID: `create_dispute_evidence_file`
+- Route: `POST /v2/disputes/{dispute_id}/evidence-files`
+- Mode: WRITE
+- Summary: CreateDisputeEvidenceFile
+- Parameters:
+  - `dispute_id` in `path` required
+- Body: JSON request body accepted.
+
+### create_dispute_evidence_text
+
+- Operation ID: `create_dispute_evidence_text`
+- Route: `POST /v2/disputes/{dispute_id}/evidence-text`
+- Mode: WRITE
+- Summary: CreateDisputeEvidenceText
+- Parameters:
+  - `dispute_id` in `path` required
+- Body: JSON request body accepted.
+
+### delete_dispute_evidence
+
+- Operation ID: `delete_dispute_evidence`
+- Route: `DELETE /v2/disputes/{dispute_id}/evidence/{evidence_id}`
+- Mode: WRITE
+- Summary: DeleteDisputeEvidence
+- Parameters:
+  - `dispute_id` in `path` required
+  - `evidence_id` in `path` required
+
+### retrieve_dispute_evidence
+
+- Operation ID: `retrieve_dispute_evidence`
+- Route: `GET /v2/disputes/{dispute_id}/evidence/{evidence_id}`
+- Mode: READ
+- Summary: RetrieveDisputeEvidence
+- Parameters:
+  - `dispute_id` in `path` required
+  - `evidence_id` in `path` required
+
+### submit_evidence
+
+- Operation ID: `submit_evidence`
+- Route: `POST /v2/disputes/{dispute_id}/submit-evidence`
+- Mode: WRITE
+- Summary: SubmitEvidence
+- Parameters:
+  - `dispute_id` in `path` required

skills/employees/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: employees-routes
+description: Handle 2 OpenAPI operation(s) under /v2/employees for the employees route group.
+---
+
+# employees API Routes
+
+Handle 2 OpenAPI operation(s) under /v2/employees for the employees route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_employees
+
+- Operation ID: `list_employees`
+- Route: `GET /v2/employees`
+- Mode: READ
+- Summary: ListEmployees
+- Parameters:
+  - `location_id` in `query`
+  - `status` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### retrieve_employee
+
+- Operation ID: `retrieve_employee`
+- Route: `GET /v2/employees/{id}`
+- Mode: READ
+- Summary: RetrieveEmployee
+- Parameters:
+  - `id` in `path` required

skills/events/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: events-routes
+description: Handle 4 OpenAPI operation(s) under /v2/events for the events route group.
+---
+
+# events API Routes
+
+Handle 4 OpenAPI operation(s) under /v2/events for the events route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### search_events
+
+- Operation ID: `search_events`
+- Route: `POST /v2/events`
+- Mode: WRITE
+- Summary: SearchEvents
+- Body: JSON request body accepted.
+
+### disable_events
+
+- Operation ID: `disable_events`
+- Route: `PUT /v2/events/disable`
+- Mode: WRITE
+- Summary: DisableEvents
+
+### enable_events
+
+- Operation ID: `enable_events`
+- Route: `PUT /v2/events/enable`
+- Mode: WRITE
+- Summary: EnableEvents
+
+### list_event_types
+
+- Operation ID: `list_event_types`
+- Route: `GET /v2/events/types`
+- Mode: READ
+- Summary: ListEventTypes
+- Parameters:
+  - `api_version` in `query`

skills/gift-cards/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: gift-cards-routes
+description: Handle 9 OpenAPI operation(s) under /v2/gift-cards for the gift cards route group.
+---
+
+# gift cards API Routes
+
+Handle 9 OpenAPI operation(s) under /v2/gift-cards for the gift cards route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_gift_cards
+
+- Operation ID: `list_gift_cards`
+- Route: `GET /v2/gift-cards`
+- Mode: READ
+- Summary: ListGiftCards
+- Parameters:
+  - `type` in `query`
+  - `state` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `customer_id` in `query`
+
+### create_gift_card
+
+- Operation ID: `create_gift_card`
+- Route: `POST /v2/gift-cards`
+- Mode: WRITE
+- Summary: CreateGiftCard
+- Body: JSON request body accepted.
+
+### list_gift_card_activities
+
+- Operation ID: `list_gift_card_activities`
+- Route: `GET /v2/gift-cards/activities`
+- Mode: READ
+- Summary: ListGiftCardActivities
+- Parameters:
+  - `gift_card_id` in `query`
+  - `type` in `query`
+  - `location_id` in `query`
+  - `begin_time` in `query`
+  - `end_time` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `sort_order` in `query`
+
+### create_gift_card_activity
+
+- Operation ID: `create_gift_card_activity`
+- Route: `POST /v2/gift-cards/activities`
+- Mode: WRITE
+- Summary: CreateGiftCardActivity
+- Body: JSON request body accepted.
+
+### retrieve_gift_card_from_gan
+
+- Operation ID: `retrieve_gift_card_from_gan`
+- Route: `POST /v2/gift-cards/from-gan`
+- Mode: WRITE
+- Summary: RetrieveGiftCardFromGAN
+- Body: JSON request body accepted.
+
+### retrieve_gift_card_from_nonce
+
+- Operation ID: `retrieve_gift_card_from_nonce`
+- Route: `POST /v2/gift-cards/from-nonce`
+- Mode: WRITE
+- Summary: RetrieveGiftCardFromNonce
+- Body: JSON request body accepted.
+
+### link_customer_to_gift_card
+
+- Operation ID: `link_customer_to_gift_card`
+- Route: `POST /v2/gift-cards/{gift_card_id}/link-customer`
+- Mode: WRITE
+- Summary: LinkCustomerToGiftCard
+- Parameters:
+  - `gift_card_id` in `path` required
+- Body: JSON request body accepted.
+
+### unlink_customer_from_gift_card
+
+- Operation ID: `unlink_customer_from_gift_card`
+- Route: `POST /v2/gift-cards/{gift_card_id}/unlink-customer`
+- Mode: WRITE
+- Summary: UnlinkCustomerFromGiftCard
+- Parameters:
+  - `gift_card_id` in `path` required
+- Body: JSON request body accepted.
+
+### retrieve_gift_card
+
+- Operation ID: `retrieve_gift_card`
+- Route: `GET /v2/gift-cards/{id}`
+- Mode: READ
+- Summary: RetrieveGiftCard
+- Parameters:
+  - `id` in `path` required

skills/inventory/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: inventory-routes
+description: Handle 13 OpenAPI operation(s) under /v2/inventory for the inventory route group.
+---
+
+# inventory API Routes
+
+Handle 13 OpenAPI operation(s) under /v2/inventory for the inventory route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### deprecated_retrieve_inventory_adjustment
+
+- Operation ID: `deprecated_retrieve_inventory_adjustment`
+- Route: `GET /v2/inventory/adjustment/{adjustment_id}`
+- Mode: READ
+- Summary: DeprecatedRetrieveInventoryAdjustment
+- Parameters:
+  - `adjustment_id` in `path` required
+
+### retrieve_inventory_adjustment
+
+- Operation ID: `retrieve_inventory_adjustment`
+- Route: `GET /v2/inventory/adjustments/{adjustment_id}`
+- Mode: READ
+- Summary: RetrieveInventoryAdjustment
+- Parameters:
+  - `adjustment_id` in `path` required
+
+### deprecated_batch_change_inventory
+
+- Operation ID: `deprecated_batch_change_inventory`
+- Route: `POST /v2/inventory/batch-change`
+- Mode: WRITE
+- Summary: DeprecatedBatchChangeInventory
+- Body: JSON request body accepted.
+
+### deprecated_batch_retrieve_inventory_changes
+
+- Operation ID: `deprecated_batch_retrieve_inventory_changes`
+- Route: `POST /v2/inventory/batch-retrieve-changes`
+- Mode: WRITE
+- Summary: DeprecatedBatchRetrieveInventoryChanges
+- Body: JSON request body accepted.
+
+### deprecated_batch_retrieve_inventory_counts
+
+- Operation ID: `deprecated_batch_retrieve_inventory_counts`
+- Route: `POST /v2/inventory/batch-retrieve-counts`
+- Mode: WRITE
+- Summary: DeprecatedBatchRetrieveInventoryCounts
+- Body: JSON request body accepted.
+
+### batch_change_inventory
+
+- Operation ID: `batch_change_inventory`
+- Route: `POST /v2/inventory/changes/batch-create`
+- Mode: WRITE
+- Summary: BatchChangeInventory
+- Body: JSON request body accepted.
+
+### batch_retrieve_inventory_changes
+
+- Operation ID: `batch_retrieve_inventory_changes`
+- Route: `POST /v2/inventory/changes/batch-retrieve`
+- Mode: WRITE
+- Summary: BatchRetrieveInventoryChanges
+- Body: JSON request body accepted.
+
+### batch_retrieve_inventory_counts
+
+- Operation ID: `batch_retrieve_inventory_counts`
+- Route: `POST /v2/inventory/counts/batch-retrieve`
+- Mode: WRITE
+- Summary: BatchRetrieveInventoryCounts
+- Body: JSON request body accepted.
+
+### deprecated_retrieve_inventory_physical_count
+
+- Operation ID: `deprecated_retrieve_inventory_physical_count`
+- Route: `GET /v2/inventory/physical-count/{physical_count_id}`
+- Mode: READ
+- Summary: DeprecatedRetrieveInventoryPhysicalCount
+- Parameters:
+  - `physical_count_id` in `path` required
+
+### retrieve_inventory_physical_count
+
+- Operation ID: `retrieve_inventory_physical_count`
+- Route: `GET /v2/inventory/physical-counts/{physical_count_id}`
+- Mode: READ
+- Summary: RetrieveInventoryPhysicalCount
+- Parameters:
+  - `physical_count_id` in `path` required
+
+### retrieve_inventory_transfer
+
+- Operation ID: `retrieve_inventory_transfer`
+- Route: `GET /v2/inventory/transfers/{transfer_id}`
+- Mode: READ
+- Summary: RetrieveInventoryTransfer
+- Parameters:
+  - `transfer_id` in `path` required
+
+### retrieve_inventory_count
+
+- Operation ID: `retrieve_inventory_count`
+- Route: `GET /v2/inventory/{catalog_object_id}`
+- Mode: READ
+- Summary: RetrieveInventoryCount
+- Parameters:
+  - `catalog_object_id` in `path` required
+  - `location_ids` in `query`
+  - `cursor` in `query`
+
+### retrieve_inventory_changes
+
+- Operation ID: `retrieve_inventory_changes`
+- Route: `GET /v2/inventory/{catalog_object_id}/changes`
+- Mode: READ
+- Summary: RetrieveInventoryChanges
+- Parameters:
+  - `catalog_object_id` in `path` required
+  - `location_ids` in `query`
+  - `cursor` in `query`

skills/invoices/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: invoices-routes
+description: Handle 10 OpenAPI operation(s) under /v2/invoices for the invoices route group.
+---
+
+# invoices API Routes
+
+Handle 10 OpenAPI operation(s) under /v2/invoices for the invoices route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_invoices
+
+- Operation ID: `list_invoices`
+- Route: `GET /v2/invoices`
+- Mode: READ
+- Summary: ListInvoices
+- Parameters:
+  - `location_id` in `query` required
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### create_invoice
+
+- Operation ID: `create_invoice`
+- Route: `POST /v2/invoices`
+- Mode: WRITE
+- Summary: CreateInvoice
+- Body: JSON request body accepted.
+
+### search_invoices
+
+- Operation ID: `search_invoices`
+- Route: `POST /v2/invoices/search`
+- Mode: WRITE
+- Summary: SearchInvoices
+- Body: JSON request body accepted.
+
+### delete_invoice
+
+- Operation ID: `delete_invoice`
+- Route: `DELETE /v2/invoices/{invoice_id}`
+- Mode: WRITE
+- Summary: DeleteInvoice
+- Parameters:
+  - `invoice_id` in `path` required
+  - `version` in `query`
+
+### get_invoice
+
+- Operation ID: `get_invoice`
+- Route: `GET /v2/invoices/{invoice_id}`
+- Mode: READ
+- Summary: GetInvoice
+- Parameters:
+  - `invoice_id` in `path` required
+
+### update_invoice
+
+- Operation ID: `update_invoice`
+- Route: `PUT /v2/invoices/{invoice_id}`
+- Mode: WRITE
+- Summary: UpdateInvoice
+- Parameters:
+  - `invoice_id` in `path` required
+- Body: JSON request body accepted.
+
+### create_invoice_attachment
+
+- Operation ID: `create_invoice_attachment`
+- Route: `POST /v2/invoices/{invoice_id}/attachments`
+- Mode: WRITE
+- Summary: CreateInvoiceAttachment
+- Parameters:
+  - `invoice_id` in `path` required
+- Body: JSON request body accepted.
+
+### delete_invoice_attachment
+
+- Operation ID: `delete_invoice_attachment`
+- Route: `DELETE /v2/invoices/{invoice_id}/attachments/{attachment_id}`
+- Mode: WRITE
+- Summary: DeleteInvoiceAttachment
+- Parameters:
+  - `invoice_id` in `path` required
+  - `attachment_id` in `path` required
+
+### cancel_invoice
+
+- Operation ID: `cancel_invoice`
+- Route: `POST /v2/invoices/{invoice_id}/cancel`
+- Mode: WRITE
+- Summary: CancelInvoice
+- Parameters:
+  - `invoice_id` in `path` required
+- Body: JSON request body accepted.
+
+### publish_invoice
+
+- Operation ID: `publish_invoice`
+- Route: `POST /v2/invoices/{invoice_id}/publish`
+- Mode: WRITE
+- Summary: PublishInvoice
+- Parameters:
+  - `invoice_id` in `path` required
+- Body: JSON request body accepted.

skills/labor/SKILL.md

@@ -0,0 +1,262 @@
+---
+name: labor-routes
+description: Handle 27 OpenAPI operation(s) under /v2/labor for the labor route group.
+---
+
+# labor API Routes
+
+Handle 27 OpenAPI operation(s) under /v2/labor for the labor route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_break_types
+
+- Operation ID: `list_break_types`
+- Route: `GET /v2/labor/break-types`
+- Mode: READ
+- Summary: ListBreakTypes
+- Parameters:
+  - `location_id` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### create_break_type
+
+- Operation ID: `create_break_type`
+- Route: `POST /v2/labor/break-types`
+- Mode: WRITE
+- Summary: CreateBreakType
+- Body: JSON request body accepted.
+
+### delete_break_type
+
+- Operation ID: `delete_break_type`
+- Route: `DELETE /v2/labor/break-types/{id}`
+- Mode: WRITE
+- Summary: DeleteBreakType
+- Parameters:
+  - `id` in `path` required
+
+### get_break_type
+
+- Operation ID: `get_break_type`
+- Route: `GET /v2/labor/break-types/{id}`
+- Mode: READ
+- Summary: GetBreakType
+- Parameters:
+  - `id` in `path` required
+
+### update_break_type
+
+- Operation ID: `update_break_type`
+- Route: `PUT /v2/labor/break-types/{id}`
+- Mode: WRITE
+- Summary: UpdateBreakType
+- Parameters:
+  - `id` in `path` required
+- Body: JSON request body accepted.
+
+### list_employee_wages
+
+- Operation ID: `list_employee_wages`
+- Route: `GET /v2/labor/employee-wages`
+- Mode: READ
+- Summary: ListEmployeeWages
+- Parameters:
+  - `employee_id` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### get_employee_wage
+
+- Operation ID: `get_employee_wage`
+- Route: `GET /v2/labor/employee-wages/{id}`
+- Mode: READ
+- Summary: GetEmployeeWage
+- Parameters:
+  - `id` in `path` required
+
+### create_scheduled_shift
+
+- Operation ID: `create_scheduled_shift`
+- Route: `POST /v2/labor/scheduled-shifts`
+- Mode: WRITE
+- Summary: CreateScheduledShift
+- Body: JSON request body accepted.
+
+### bulk_publish_scheduled_shifts
+
+- Operation ID: `bulk_publish_scheduled_shifts`
+- Route: `POST /v2/labor/scheduled-shifts/bulk-publish`
+- Mode: WRITE
+- Summary: BulkPublishScheduledShifts
+- Body: JSON request body accepted.
+
+### search_scheduled_shifts
+
+- Operation ID: `search_scheduled_shifts`
+- Route: `POST /v2/labor/scheduled-shifts/search`
+- Mode: WRITE
+- Summary: SearchScheduledShifts
+- Body: JSON request body accepted.
+
+### retrieve_scheduled_shift
+
+- Operation ID: `retrieve_scheduled_shift`
+- Route: `GET /v2/labor/scheduled-shifts/{id}`
+- Mode: READ
+- Summary: RetrieveScheduledShift
+- Parameters:
+  - `id` in `path` required
+
+### update_scheduled_shift
+
+- Operation ID: `update_scheduled_shift`
+- Route: `PUT /v2/labor/scheduled-shifts/{id}`
+- Mode: WRITE
+- Summary: UpdateScheduledShift
+- Parameters:
+  - `id` in `path` required
+- Body: JSON request body accepted.
+
+### publish_scheduled_shift
+
+- Operation ID: `publish_scheduled_shift`
+- Route: `POST /v2/labor/scheduled-shifts/{id}/publish`
+- Mode: WRITE
+- Summary: PublishScheduledShift
+- Parameters:
+  - `id` in `path` required
+- Body: JSON request body accepted.
+
+### create_shift
+
+- Operation ID: `create_shift`
+- Route: `POST /v2/labor/shifts`
+- Mode: WRITE
+- Summary: CreateShift
+- Body: JSON request body accepted.
+
+### search_shifts
+
+- Operation ID: `search_shifts`
+- Route: `POST /v2/labor/shifts/search`
+- Mode: WRITE
+- Summary: SearchShifts
+- Body: JSON request body accepted.
+
+### delete_shift
+
+- Operation ID: `delete_shift`
+- Route: `DELETE /v2/labor/shifts/{id}`
+- Mode: WRITE
+- Summary: DeleteShift
+- Parameters:
+  - `id` in `path` required
+
+### get_shift
+
+- Operation ID: `get_shift`
+- Route: `GET /v2/labor/shifts/{id}`
+- Mode: READ
+- Summary: GetShift
+- Parameters:
+  - `id` in `path` required
+
+### update_shift
+
+- Operation ID: `update_shift`
+- Route: `PUT /v2/labor/shifts/{id}`
+- Mode: WRITE
+- Summary: UpdateShift
+- Parameters:
+  - `id` in `path` required
+- Body: JSON request body accepted.
+
+### list_team_member_wages
+
+- Operation ID: `list_team_member_wages`
+- Route: `GET /v2/labor/team-member-wages`
+- Mode: READ
+- Summary: ListTeamMemberWages
+- Parameters:
+  - `team_member_id` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### get_team_member_wage
+
+- Operation ID: `get_team_member_wage`
+- Route: `GET /v2/labor/team-member-wages/{id}`
+- Mode: READ
+- Summary: GetTeamMemberWage
+- Parameters:
+  - `id` in `path` required
+
+### create_timecard
+
+- Operation ID: `create_timecard`
+- Route: `POST /v2/labor/timecards`
+- Mode: WRITE
+- Summary: CreateTimecard
+- Body: JSON request body accepted.
+
+### search_timecards
+
+- Operation ID: `search_timecards`
+- Route: `POST /v2/labor/timecards/search`
+- Mode: WRITE
+- Summary: SearchTimecards
+- Body: JSON request body accepted.
+
+### delete_timecard
+
+- Operation ID: `delete_timecard`
+- Route: `DELETE /v2/labor/timecards/{id}`
+- Mode: WRITE
+- Summary: DeleteTimecard
+- Parameters:
+  - `id` in `path` required
+
+### retrieve_timecard
+
+- Operation ID: `retrieve_timecard`
+- Route: `GET /v2/labor/timecards/{id}`
+- Mode: READ
+- Summary: RetrieveTimecard
+- Parameters:
+  - `id` in `path` required
+
+### update_timecard
+
+- Operation ID: `update_timecard`
+- Route: `PUT /v2/labor/timecards/{id}`
+- Mode: WRITE
+- Summary: UpdateTimecard
+- Parameters:
+  - `id` in `path` required
+- Body: JSON request body accepted.
+
+### list_workweek_configs
+
+- Operation ID: `list_workweek_configs`
+- Route: `GET /v2/labor/workweek-configs`
+- Mode: READ
+- Summary: ListWorkweekConfigs
+- Parameters:
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### update_workweek_config
+
+- Operation ID: `update_workweek_config`
+- Route: `PUT /v2/labor/workweek-configs/{id}`
+- Mode: WRITE
+- Summary: UpdateWorkweekConfig
+- Parameters:
+  - `id` in `path` required
+- Body: JSON request body accepted.

skills/locations/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: locations-routes
+description: Handle 20 OpenAPI operation(s) under /v2/locations for the locations route group.
+---
+
+# locations API Routes
+
+Handle 20 OpenAPI operation(s) under /v2/locations for the locations route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_locations
+
+- Operation ID: `list_locations`
+- Route: `GET /v2/locations`
+- Mode: READ
+- Summary: ListLocations
+
+### create_location
+
+- Operation ID: `create_location`
+- Route: `POST /v2/locations`
+- Mode: WRITE
+- Summary: CreateLocation
+- Body: JSON request body accepted.
+
+### list_location_custom_attribute_definitions
+
+- Operation ID: `list_location_custom_attribute_definitions`
+- Route: `GET /v2/locations/custom-attribute-definitions`
+- Mode: READ
+- Summary: ListLocationCustomAttributeDefinitions
+- Parameters:
+  - `visibility_filter` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### create_location_custom_attribute_definition
+
+- Operation ID: `create_location_custom_attribute_definition`
+- Route: `POST /v2/locations/custom-attribute-definitions`
+- Mode: WRITE
+- Summary: CreateLocationCustomAttributeDefinition
+- Body: JSON request body accepted.
+
+### delete_location_custom_attribute_definition
+
+- Operation ID: `delete_location_custom_attribute_definition`
+- Route: `DELETE /v2/locations/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: DeleteLocationCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+
+### retrieve_location_custom_attribute_definition
+
+- Operation ID: `retrieve_location_custom_attribute_definition`
+- Route: `GET /v2/locations/custom-attribute-definitions/{key}`
+- Mode: READ
+- Summary: RetrieveLocationCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+  - `version` in `query`
+
+### update_location_custom_attribute_definition
+
+- Operation ID: `update_location_custom_attribute_definition`
+- Route: `PUT /v2/locations/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: UpdateLocationCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+- Body: JSON request body accepted.
+
+### bulk_delete_location_custom_attributes
+
+- Operation ID: `bulk_delete_location_custom_attributes`
+- Route: `POST /v2/locations/custom-attributes/bulk-delete`
+- Mode: WRITE
+- Summary: BulkDeleteLocationCustomAttributes
+- Body: JSON request body accepted.
+
+### bulk_upsert_location_custom_attributes
+
+- Operation ID: `bulk_upsert_location_custom_attributes`
+- Route: `POST /v2/locations/custom-attributes/bulk-upsert`
+- Mode: WRITE
+- Summary: BulkUpsertLocationCustomAttributes
+- Body: JSON request body accepted.
+
+### retrieve_location
+
+- Operation ID: `retrieve_location`
+- Route: `GET /v2/locations/{location_id}`
+- Mode: READ
+- Summary: RetrieveLocation
+- Parameters:
+  - `location_id` in `path` required
+
+### update_location
+
+- Operation ID: `update_location`
+- Route: `PUT /v2/locations/{location_id}`
+- Mode: WRITE
+- Summary: UpdateLocation
+- Parameters:
+  - `location_id` in `path` required
+- Body: JSON request body accepted.
+
+### create_checkout
+
+- Operation ID: `create_checkout`
+- Route: `POST /v2/locations/{location_id}/checkouts`
+- Mode: WRITE
+- Summary: CreateCheckout
+- Parameters:
+  - `location_id` in `path` required
+- Body: JSON request body accepted.
+
+### list_location_custom_attributes
+
+- Operation ID: `list_location_custom_attributes`
+- Route: `GET /v2/locations/{location_id}/custom-attributes`
+- Mode: READ
+- Summary: ListLocationCustomAttributes
+- Parameters:
+  - `location_id` in `path` required
+  - `visibility_filter` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `with_definitions` in `query`
+
+### delete_location_custom_attribute
+
+- Operation ID: `delete_location_custom_attribute`
+- Route: `DELETE /v2/locations/{location_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: DeleteLocationCustomAttribute
+- Parameters:
+  - `location_id` in `path` required
+  - `key` in `path` required
+
+### retrieve_location_custom_attribute
+
+- Operation ID: `retrieve_location_custom_attribute`
+- Route: `GET /v2/locations/{location_id}/custom-attributes/{key}`
+- Mode: READ
+- Summary: RetrieveLocationCustomAttribute
+- Parameters:
+  - `location_id` in `path` required
+  - `key` in `path` required
+  - `with_definition` in `query`
+  - `version` in `query`
+
+### upsert_location_custom_attribute
+
+- Operation ID: `upsert_location_custom_attribute`
+- Route: `POST /v2/locations/{location_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: UpsertLocationCustomAttribute
+- Parameters:
+  - `location_id` in `path` required
+  - `key` in `path` required
+- Body: JSON request body accepted.
+
+### list_transactions
+
+- Operation ID: `list_transactions`
+- Route: `GET /v2/locations/{location_id}/transactions`
+- Mode: READ
+- Summary: ListTransactions
+- Parameters:
+  - `location_id` in `path` required
+  - `begin_time` in `query`
+  - `end_time` in `query`
+  - `sort_order` in `query`
+  - `cursor` in `query`
+
+### retrieve_transaction
+
+- Operation ID: `retrieve_transaction`
+- Route: `GET /v2/locations/{location_id}/transactions/{transaction_id}`
+- Mode: READ
+- Summary: RetrieveTransaction
+- Parameters:
+  - `location_id` in `path` required
+  - `transaction_id` in `path` required
+
+### capture_transaction
+
+- Operation ID: `capture_transaction`
+- Route: `POST /v2/locations/{location_id}/transactions/{transaction_id}/capture`
+- Mode: WRITE
+- Summary: CaptureTransaction
+- Parameters:
+  - `location_id` in `path` required
+  - `transaction_id` in `path` required
+
+### void_transaction
+
+- Operation ID: `void_transaction`
+- Route: `POST /v2/locations/{location_id}/transactions/{transaction_id}/void`
+- Mode: WRITE
+- Summary: VoidTransaction
+- Parameters:
+  - `location_id` in `path` required
+  - `transaction_id` in `path` required

skills/loyalty/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: loyalty-routes
+description: Handle 18 OpenAPI operation(s) under /v2/loyalty for the loyalty route group.
+---
+
+# loyalty API Routes
+
+Handle 18 OpenAPI operation(s) under /v2/loyalty for the loyalty route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### create_loyalty_account
+
+- Operation ID: `create_loyalty_account`
+- Route: `POST /v2/loyalty/accounts`
+- Mode: WRITE
+- Summary: CreateLoyaltyAccount
+- Body: JSON request body accepted.
+
+### search_loyalty_accounts
+
+- Operation ID: `search_loyalty_accounts`
+- Route: `POST /v2/loyalty/accounts/search`
+- Mode: WRITE
+- Summary: SearchLoyaltyAccounts
+- Body: JSON request body accepted.
+
+### retrieve_loyalty_account
+
+- Operation ID: `retrieve_loyalty_account`
+- Route: `GET /v2/loyalty/accounts/{account_id}`
+- Mode: READ
+- Summary: RetrieveLoyaltyAccount
+- Parameters:
+  - `account_id` in `path` required
+
+### accumulate_loyalty_points
+
+- Operation ID: `accumulate_loyalty_points`
+- Route: `POST /v2/loyalty/accounts/{account_id}/accumulate`
+- Mode: WRITE
+- Summary: AccumulateLoyaltyPoints
+- Parameters:
+  - `account_id` in `path` required
+- Body: JSON request body accepted.
+
+### adjust_loyalty_points
+
+- Operation ID: `adjust_loyalty_points`
+- Route: `POST /v2/loyalty/accounts/{account_id}/adjust`
+- Mode: WRITE
+- Summary: AdjustLoyaltyPoints
+- Parameters:
+  - `account_id` in `path` required
+- Body: JSON request body accepted.
+
+### search_loyalty_events
+
+- Operation ID: `search_loyalty_events`
+- Route: `POST /v2/loyalty/events/search`
+- Mode: WRITE
+- Summary: SearchLoyaltyEvents
+- Body: JSON request body accepted.
+
+### list_loyalty_programs
+
+- Operation ID: `list_loyalty_programs`
+- Route: `GET /v2/loyalty/programs`
+- Mode: READ
+- Summary: ListLoyaltyPrograms
+
+### retrieve_loyalty_program
+
+- Operation ID: `retrieve_loyalty_program`
+- Route: `GET /v2/loyalty/programs/{program_id}`
+- Mode: READ
+- Summary: RetrieveLoyaltyProgram
+- Parameters:
+  - `program_id` in `path` required
+
+### calculate_loyalty_points
+
+- Operation ID: `calculate_loyalty_points`
+- Route: `POST /v2/loyalty/programs/{program_id}/calculate`
+- Mode: WRITE
+- Summary: CalculateLoyaltyPoints
+- Parameters:
+  - `program_id` in `path` required
+- Body: JSON request body accepted.
+
+### list_loyalty_promotions
+
+- Operation ID: `list_loyalty_promotions`
+- Route: `GET /v2/loyalty/programs/{program_id}/promotions`
+- Mode: READ
+- Summary: ListLoyaltyPromotions
+- Parameters:
+  - `program_id` in `path` required
+  - `status` in `query`
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### create_loyalty_promotion
+
+- Operation ID: `create_loyalty_promotion`
+- Route: `POST /v2/loyalty/programs/{program_id}/promotions`
+- Mode: WRITE
+- Summary: CreateLoyaltyPromotion
+- Parameters:
+  - `program_id` in `path` required
+- Body: JSON request body accepted.
+
+### retrieve_loyalty_promotion
+
+- Operation ID: `retrieve_loyalty_promotion`
+- Route: `GET /v2/loyalty/programs/{program_id}/promotions/{promotion_id}`
+- Mode: READ
+- Summary: RetrieveLoyaltyPromotion
+- Parameters:
+  - `promotion_id` in `path` required
+  - `program_id` in `path` required
+
+### cancel_loyalty_promotion
+
+- Operation ID: `cancel_loyalty_promotion`
+- Route: `POST /v2/loyalty/programs/{program_id}/promotions/{promotion_id}/cancel`
+- Mode: WRITE
+- Summary: CancelLoyaltyPromotion
+- Parameters:
+  - `promotion_id` in `path` required
+  - `program_id` in `path` required
+
+### create_loyalty_reward
+
+- Operation ID: `create_loyalty_reward`
+- Route: `POST /v2/loyalty/rewards`
+- Mode: WRITE
+- Summary: CreateLoyaltyReward
+- Body: JSON request body accepted.
+
+### search_loyalty_rewards
+
+- Operation ID: `search_loyalty_rewards`
+- Route: `POST /v2/loyalty/rewards/search`
+- Mode: WRITE
+- Summary: SearchLoyaltyRewards
+- Body: JSON request body accepted.
+
+### delete_loyalty_reward
+
+- Operation ID: `delete_loyalty_reward`
+- Route: `DELETE /v2/loyalty/rewards/{reward_id}`
+- Mode: WRITE
+- Summary: DeleteLoyaltyReward
+- Parameters:
+  - `reward_id` in `path` required
+
+### retrieve_loyalty_reward
+
+- Operation ID: `retrieve_loyalty_reward`
+- Route: `GET /v2/loyalty/rewards/{reward_id}`
+- Mode: READ
+- Summary: RetrieveLoyaltyReward
+- Parameters:
+  - `reward_id` in `path` required
+
+### redeem_loyalty_reward
+
+- Operation ID: `redeem_loyalty_reward`
+- Route: `POST /v2/loyalty/rewards/{reward_id}/redeem`
+- Mode: WRITE
+- Summary: RedeemLoyaltyReward
+- Parameters:
+  - `reward_id` in `path` required
+- Body: JSON request body accepted.

skills/merchants/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: merchants-routes
+description: Handle 13 OpenAPI operation(s) under /v2/merchants for the merchants route group.
+---
+
+# merchants API Routes
+
+Handle 13 OpenAPI operation(s) under /v2/merchants for the merchants route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_merchants
+
+- Operation ID: `list_merchants`
+- Route: `GET /v2/merchants`
+- Mode: READ
+- Summary: ListMerchants
+- Parameters:
+  - `cursor` in `query`
+
+### list_merchant_custom_attribute_definitions
+
+- Operation ID: `list_merchant_custom_attribute_definitions`
+- Route: `GET /v2/merchants/custom-attribute-definitions`
+- Mode: READ
+- Summary: ListMerchantCustomAttributeDefinitions
+- Parameters:
+  - `visibility_filter` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+
+### create_merchant_custom_attribute_definition
+
+- Operation ID: `create_merchant_custom_attribute_definition`
+- Route: `POST /v2/merchants/custom-attribute-definitions`
+- Mode: WRITE
+- Summary: CreateMerchantCustomAttributeDefinition
+- Body: JSON request body accepted.
+
+### delete_merchant_custom_attribute_definition
+
+- Operation ID: `delete_merchant_custom_attribute_definition`
+- Route: `DELETE /v2/merchants/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: DeleteMerchantCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+
+### retrieve_merchant_custom_attribute_definition
+
+- Operation ID: `retrieve_merchant_custom_attribute_definition`
+- Route: `GET /v2/merchants/custom-attribute-definitions/{key}`
+- Mode: READ
+- Summary: RetrieveMerchantCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+  - `version` in `query`
+
+### update_merchant_custom_attribute_definition
+
+- Operation ID: `update_merchant_custom_attribute_definition`
+- Route: `PUT /v2/merchants/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: UpdateMerchantCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+- Body: JSON request body accepted.
+
+### bulk_delete_merchant_custom_attributes
+
+- Operation ID: `bulk_delete_merchant_custom_attributes`
+- Route: `POST /v2/merchants/custom-attributes/bulk-delete`
+- Mode: WRITE
+- Summary: BulkDeleteMerchantCustomAttributes
+- Body: JSON request body accepted.
+
+### bulk_upsert_merchant_custom_attributes
+
+- Operation ID: `bulk_upsert_merchant_custom_attributes`
+- Route: `POST /v2/merchants/custom-attributes/bulk-upsert`
+- Mode: WRITE
+- Summary: BulkUpsertMerchantCustomAttributes
+- Body: JSON request body accepted.
+
+### retrieve_merchant
+
+- Operation ID: `retrieve_merchant`
+- Route: `GET /v2/merchants/{merchant_id}`
+- Mode: READ
+- Summary: RetrieveMerchant
+- Parameters:
+  - `merchant_id` in `path` required
+
+### list_merchant_custom_attributes
+
+- Operation ID: `list_merchant_custom_attributes`
+- Route: `GET /v2/merchants/{merchant_id}/custom-attributes`
+- Mode: READ
+- Summary: ListMerchantCustomAttributes
+- Parameters:
+  - `merchant_id` in `path` required
+  - `visibility_filter` in `query`
+  - `limit` in `query`
+  - `cursor` in `query`
+  - `with_definitions` in `query`
+
+### delete_merchant_custom_attribute
+
+- Operation ID: `delete_merchant_custom_attribute`
+- Route: `DELETE /v2/merchants/{merchant_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: DeleteMerchantCustomAttribute
+- Parameters:
+  - `merchant_id` in `path` required
+  - `key` in `path` required
+
+### retrieve_merchant_custom_attribute
+
+- Operation ID: `retrieve_merchant_custom_attribute`
+- Route: `GET /v2/merchants/{merchant_id}/custom-attributes/{key}`
+- Mode: READ
+- Summary: RetrieveMerchantCustomAttribute
+- Parameters:
+  - `merchant_id` in `path` required
+  - `key` in `path` required
+  - `with_definition` in `query`
+  - `version` in `query`
+
+### upsert_merchant_custom_attribute
+
+- Operation ID: `upsert_merchant_custom_attribute`
+- Route: `POST /v2/merchants/{merchant_id}/custom-attributes/{key}`
+- Mode: WRITE
+- Summary: UpsertMerchantCustomAttribute
+- Parameters:
+  - `merchant_id` in `path` required
+  - `key` in `path` required
+- Body: JSON request body accepted.

skills/oauth2/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: oauth2-routes
+description: Handle 3 OpenAPI operation(s) under /oauth2 for the oauth2 route group.
+---
+
+# oauth2 API Routes
+
+Handle 3 OpenAPI operation(s) under /oauth2 for the oauth2 route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### revoke_token
+
+- Operation ID: `revoke_token`
+- Route: `POST /oauth2/revoke`
+- Mode: WRITE
+- Summary: RevokeToken
+- Body: JSON request body accepted.
+
+### obtain_token
+
+- Operation ID: `obtain_token`
+- Route: `POST /oauth2/token`
+- Mode: WRITE
+- Summary: ObtainToken
+- Body: JSON request body accepted.
+
+### retrieve_token_status
+
+- Operation ID: `retrieve_token_status`
+- Route: `POST /oauth2/token/status`
+- Mode: WRITE
+- Summary: RetrieveTokenStatus

skills/online-checkout/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: online-checkout-routes
+description: Handle 9 OpenAPI operation(s) under /v2/online-checkout for the online checkout route group.
+---
+
+# online checkout API Routes
+
+Handle 9 OpenAPI operation(s) under /v2/online-checkout for the online checkout route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### retrieve_location_settings
+
+- Operation ID: `retrieve_location_settings`
+- Route: `GET /v2/online-checkout/location-settings/{location_id}`
+- Mode: READ
+- Summary: RetrieveLocationSettings
+- Parameters:
+  - `location_id` in `path` required
+
+### update_location_settings
+
+- Operation ID: `update_location_settings`
+- Route: `PUT /v2/online-checkout/location-settings/{location_id}`
+- Mode: WRITE
+- Summary: UpdateLocationSettings
+- Parameters:
+  - `location_id` in `path` required
+- Body: JSON request body accepted.
+
+### retrieve_merchant_settings
+
+- Operation ID: `retrieve_merchant_settings`
+- Route: `GET /v2/online-checkout/merchant-settings`
+- Mode: READ
+- Summary: RetrieveMerchantSettings
+
+### update_merchant_settings
+
+- Operation ID: `update_merchant_settings`
+- Route: `PUT /v2/online-checkout/merchant-settings`
+- Mode: WRITE
+- Summary: UpdateMerchantSettings
+- Body: JSON request body accepted.
+
+### list_payment_links
+
+- Operation ID: `list_payment_links`
+- Route: `GET /v2/online-checkout/payment-links`
+- Mode: READ
+- Summary: ListPaymentLinks
+- Parameters:
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### create_payment_link
+
+- Operation ID: `create_payment_link`
+- Route: `POST /v2/online-checkout/payment-links`
+- Mode: WRITE
+- Summary: CreatePaymentLink
+- Body: JSON request body accepted.
+
+### delete_payment_link
+
+- Operation ID: `delete_payment_link`
+- Route: `DELETE /v2/online-checkout/payment-links/{id}`
+- Mode: WRITE
+- Summary: DeletePaymentLink
+- Parameters:
+  - `id` in `path` required
+
+### retrieve_payment_link
+
+- Operation ID: `retrieve_payment_link`
+- Route: `GET /v2/online-checkout/payment-links/{id}`
+- Mode: READ
+- Summary: RetrievePaymentLink
+- Parameters:
+  - `id` in `path` required
+
+### update_payment_link
+
+- Operation ID: `update_payment_link`
+- Route: `PUT /v2/online-checkout/payment-links/{id}`
+- Mode: WRITE
+- Summary: UpdatePaymentLink
+- Parameters:
+  - `id` in `path` required
+- Body: JSON request body accepted.

skills/orders/SKILL.md

@@ -0,0 +1,226 @@
+---
+name: orders-routes
+description: Handle 22 OpenAPI operation(s) for the orders route group.
+---
+
+# orders API Routes
+
+Handle 22 OpenAPI operation(s) for the orders route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### v1_list_orders
+
+- Operation ID: `v1_list_orders`
+- Route: `GET /v1/{location_id}/orders`
+- Mode: READ
+- Summary: V1ListOrders
+- Parameters:
+  - `location_id` in `path` required
+  - `order` in `query`
+  - `limit` in `query`
+  - `batch_token` in `query`
+
+### v1_retrieve_order
+
+- Operation ID: `v1_retrieve_order`
+- Route: `GET /v1/{location_id}/orders/{order_id}`
+- Mode: READ
+- Summary: V1RetrieveOrder
+- Parameters:
+  - `location_id` in `path` required
+  - `order_id` in `path` required
+
+### v1_update_order
+
+- Operation ID: `v1_update_order`
+- Route: `PUT /v1/{location_id}/orders/{order_id}`
+- Mode: WRITE
+- Summary: V1UpdateOrder
+- Parameters:
+  - `location_id` in `path` required
+  - `order_id` in `path` required
+- Body: JSON request body accepted.
+
+### create_order
+
+- Operation ID: `create_order`
+- Route: `POST /v2/orders`
+- Mode: WRITE
+- Summary: CreateOrder
+- Body: JSON request body accepted.
+
+### batch_retrieve_orders
+
+- Operation ID: `batch_retrieve_orders`
+- Route: `POST /v2/orders/batch-retrieve`
+- Mode: WRITE
+- Summary: BatchRetrieveOrders
+- Body: JSON request body accepted.
+
+### calculate_order
+
+- Operation ID: `calculate_order`
+- Route: `POST /v2/orders/calculate`
+- Mode: WRITE
+- Summary: CalculateOrder
+- Body: JSON request body accepted.
+
+### clone_order
+
+- Operation ID: `clone_order`
+- Route: `POST /v2/orders/clone`
+- Mode: WRITE
+- Summary: CloneOrder
+- Body: JSON request body accepted.
+
+### list_order_custom_attribute_definitions
+
+- Operation ID: `list_order_custom_attribute_definitions`
+- Route: `GET /v2/orders/custom-attribute-definitions`
+- Mode: READ
+- Summary: ListOrderCustomAttributeDefinitions
+- Parameters:
+  - `visibility_filter` in `query`
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### create_order_custom_attribute_definition
+
+- Operation ID: `create_order_custom_attribute_definition`
+- Route: `POST /v2/orders/custom-attribute-definitions`
+- Mode: WRITE
+- Summary: CreateOrderCustomAttributeDefinition
+- Body: JSON request body accepted.
+
+### delete_order_custom_attribute_definition
+
+- Operation ID: `delete_order_custom_attribute_definition`
+- Route: `DELETE /v2/orders/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: DeleteOrderCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+
+### retrieve_order_custom_attribute_definition
+
+- Operation ID: `retrieve_order_custom_attribute_definition`
+- Route: `GET /v2/orders/custom-attribute-definitions/{key}`
+- Mode: READ
+- Summary: RetrieveOrderCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+  - `version` in `query`
+
+### update_order_custom_attribute_definition
+
+- Operation ID: `update_order_custom_attribute_definition`
+- Route: `PUT /v2/orders/custom-attribute-definitions/{key}`
+- Mode: WRITE
+- Summary: UpdateOrderCustomAttributeDefinition
+- Parameters:
+  - `key` in `path` required
+- Body: JSON request body accepted.
+
+### bulk_delete_order_custom_attributes
+
+- Operation ID: `bulk_delete_order_custom_attributes`
+- Route: `POST /v2/orders/custom-attributes/bulk-delete`
+- Mode: WRITE
+- Summary: BulkDeleteOrderCustomAttributes
+- Body: JSON request body accepted.
+
+### bulk_upsert_order_custom_attributes
+
+- Operation ID: `bulk_upsert_order_custom_attributes`
+- Route: `POST /v2/orders/custom-attributes/bulk-upsert`
+- Mode: WRITE
+- Summary: BulkUpsertOrderCustomAttributes
+- Body: JSON request body accepted.
+
+### search_orders
+
+- Operation ID: `search_orders`
+- Route: `POST /v2/orders/search`
+- Mode: WRITE
+- Summary: SearchOrders
+- Body: JSON request body accepted.
+
+### retrieve_order
+
+- Operation ID: `retrieve_order`
+- Route: `GET /v2/orders/{order_id}`
+- Mode: READ
+- Summary: RetrieveOrder
+- Parameters:
+  - `order_id` in `path` required
+
+### update_order
+
+- Operation ID: `update_order`
+- Route: `PUT /v2/orders/{order_id}`
+- Mode: WRITE
+- Summary: UpdateOrder
+- Parameters:
+  - `order_id` in `path` required
+- Body: JSON request body accepted.
+
+### list_order_custom_attributes
+
+- Operation ID: `list_order_custom_attributes`
+- Route: `GET /v2/orders/{order_id}/custom-attributes`
+- Mode: READ
+- Summary: ListOrderCustomAttributes
+- Parameters:
+  - `order_id` in `path` required
+  - `visibility_filter` in `query`
+  - `cursor` in `query`
+  - `limit` in `query`
+  - `with_definitions` in `query`
+
+### delete_order_custom_attribute
+
+- Operation ID: `delete_order_custom_attribute`
+- Route: `DELETE /v2/orders/{order_id}/custom-attributes/{custom_attribute_key}`
+- Mode: WRITE
+- Summary: DeleteOrderCustomAttribute
+- Parameters:
+  - `order_id` in `path` required
+  - `custom_attribute_key` in `path` required
+
+### retrieve_order_custom_attribute
+
+- Operation ID: `retrieve_order_custom_attribute`
+- Route: `GET /v2/orders/{order_id}/custom-attributes/{custom_attribute_key}`
+- Mode: READ
+- Summary: RetrieveOrderCustomAttribute
+- Parameters:
+  - `order_id` in `path` required
+  - `custom_attribute_key` in `path` required
+  - `version` in `query`
+  - `with_definition` in `query`
+
+### upsert_order_custom_attribute
+
+- Operation ID: `upsert_order_custom_attribute`
+- Route: `POST /v2/orders/{order_id}/custom-attributes/{custom_attribute_key}`
+- Mode: WRITE
+- Summary: UpsertOrderCustomAttribute
+- Parameters:
+  - `order_id` in `path` required
+  - `custom_attribute_key` in `path` required
+- Body: JSON request body accepted.
+
+### pay_order
+
+- Operation ID: `pay_order`
+- Route: `POST /v2/orders/{order_id}/pay`
+- Mode: WRITE
+- Summary: PayOrder
+- Parameters:
+  - `order_id` in `path` required
+- Body: JSON request body accepted.

skills/payments/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: payments-routes
+description: Handle 7 OpenAPI operation(s) under /v2/payments for the payments route group.
+---
+
+# payments API Routes
+
+Handle 7 OpenAPI operation(s) under /v2/payments for the payments route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_payments
+
+- Operation ID: `list_payments`
+- Route: `GET /v2/payments`
+- Mode: READ
+- Summary: ListPayments
+- Parameters:
+  - `begin_time` in `query`
+  - `end_time` in `query`
+  - `sort_order` in `query`
+  - `cursor` in `query`
+  - `location_id` in `query`
+  - `total` in `query`
+  - `last_4` in `query`
+  - `card_brand` in `query`
+  - `limit` in `query`
+  - `is_offline_payment` in `query`
+  - `offline_begin_time` in `query`
+  - `offline_end_time` in `query`
+  - `updated_at_begin_time` in `query`
+  - `updated_at_end_time` in `query`
+  - `sort_field` in `query`
+
+### create_payment
+
+- Operation ID: `create_payment`
+- Route: `POST /v2/payments`
+- Mode: WRITE
+- Summary: CreatePayment
+- Body: JSON request body accepted.
+
+### cancel_payment_by_idempotency_key
+
+- Operation ID: `cancel_payment_by_idempotency_key`
+- Route: `POST /v2/payments/cancel`
+- Mode: WRITE
+- Summary: CancelPaymentByIdempotencyKey
+- Body: JSON request body accepted.
+
+### get_payment
+
+- Operation ID: `get_payment`
+- Route: `GET /v2/payments/{payment_id}`
+- Mode: READ
+- Summary: GetPayment
+- Parameters:
+  - `payment_id` in `path` required
+
+### update_payment
+
+- Operation ID: `update_payment`
+- Route: `PUT /v2/payments/{payment_id}`
+- Mode: WRITE
+- Summary: UpdatePayment
+- Parameters:
+  - `payment_id` in `path` required
+- Body: JSON request body accepted.
+
+### cancel_payment
+
+- Operation ID: `cancel_payment`
+- Route: `POST /v2/payments/{payment_id}/cancel`
+- Mode: WRITE
+- Summary: CancelPayment
+- Parameters:
+  - `payment_id` in `path` required
+
+### complete_payment
+
+- Operation ID: `complete_payment`
+- Route: `POST /v2/payments/{payment_id}/complete`
+- Mode: WRITE
+- Summary: CompletePayment
+- Parameters:
+  - `payment_id` in `path` required
+- Body: JSON request body accepted.

skills/payouts/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: payouts-routes
+description: Handle 3 OpenAPI operation(s) under /v2/payouts for the payouts route group.
+---
+
+# payouts API Routes
+
+Handle 3 OpenAPI operation(s) under /v2/payouts for the payouts route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_payouts
+
+- Operation ID: `list_payouts`
+- Route: `GET /v2/payouts`
+- Mode: READ
+- Summary: ListPayouts
+- Parameters:
+  - `location_id` in `query`
+  - `status` in `query`
+  - `begin_time` in `query`
+  - `end_time` in `query`
+  - `sort_order` in `query`
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### get_payout
+
+- Operation ID: `get_payout`
+- Route: `GET /v2/payouts/{payout_id}`
+- Mode: READ
+- Summary: GetPayout
+- Parameters:
+  - `payout_id` in `path` required
+
+### list_payout_entries
+
+- Operation ID: `list_payout_entries`
+- Route: `GET /v2/payouts/{payout_id}/payout-entries`
+- Mode: READ
+- Summary: ListPayoutEntries
+- Parameters:
+  - `payout_id` in `path` required
+  - `sort_order` in `query`
+  - `cursor` in `query`
+  - `limit` in `query`

skills/refunds/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: refunds-routes
+description: Handle 3 OpenAPI operation(s) under /v2/refunds for the refunds route group.
+---
+
+# refunds API Routes
+
+Handle 3 OpenAPI operation(s) under /v2/refunds for the refunds route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_payment_refunds
+
+- Operation ID: `list_payment_refunds`
+- Route: `GET /v2/refunds`
+- Mode: READ
+- Summary: ListPaymentRefunds
+- Parameters:
+  - `begin_time` in `query`
+  - `end_time` in `query`
+  - `sort_order` in `query`
+  - `cursor` in `query`
+  - `location_id` in `query`
+  - `status` in `query`
+  - `source_type` in `query`
+  - `limit` in `query`
+  - `updated_at_begin_time` in `query`
+  - `updated_at_end_time` in `query`
+  - `sort_field` in `query`
+
+### refund_payment
+
+- Operation ID: `refund_payment`
+- Route: `POST /v2/refunds`
+- Mode: WRITE
+- Summary: RefundPayment
+- Body: JSON request body accepted.
+
+### get_payment_refund
+
+- Operation ID: `get_payment_refund`
+- Route: `GET /v2/refunds/{refund_id}`
+- Mode: READ
+- Summary: GetPaymentRefund
+- Parameters:
+  - `refund_id` in `path` required

skills/sites/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: sites-routes
+description: Handle 4 OpenAPI operation(s) under /v2/sites for the sites route group.
+---
+
+# sites API Routes
+
+Handle 4 OpenAPI operation(s) under /v2/sites for the sites route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_sites
+
+- Operation ID: `list_sites`
+- Route: `GET /v2/sites`
+- Mode: READ
+- Summary: ListSites
+
+### delete_snippet
+
+- Operation ID: `delete_snippet`
+- Route: `DELETE /v2/sites/{site_id}/snippet`
+- Mode: WRITE
+- Summary: DeleteSnippet
+- Parameters:
+  - `site_id` in `path` required
+
+### retrieve_snippet
+
+- Operation ID: `retrieve_snippet`
+- Route: `GET /v2/sites/{site_id}/snippet`
+- Mode: READ
+- Summary: RetrieveSnippet
+- Parameters:
+  - `site_id` in `path` required
+
+### upsert_snippet
+
+- Operation ID: `upsert_snippet`
+- Route: `POST /v2/sites/{site_id}/snippet`
+- Mode: WRITE
+- Summary: UpsertSnippet
+- Parameters:
+  - `site_id` in `path` required
+- Body: JSON request body accepted.

skills/subscriptions/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: subscriptions-routes
+description: Handle 12 OpenAPI operation(s) under /v2/subscriptions for the subscriptions route group.
+---
+
+# subscriptions API Routes
+
+Handle 12 OpenAPI operation(s) under /v2/subscriptions for the subscriptions route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### create_subscription
+
+- Operation ID: `create_subscription`
+- Route: `POST /v2/subscriptions`
+- Mode: WRITE
+- Summary: CreateSubscription
+- Body: JSON request body accepted.
+
+### bulk_swap_plan
+
+- Operation ID: `bulk_swap_plan`
+- Route: `POST /v2/subscriptions/bulk-swap-plan`
+- Mode: WRITE
+- Summary: BulkSwapPlan
+- Body: JSON request body accepted.
+
+### search_subscriptions
+
+- Operation ID: `search_subscriptions`
+- Route: `POST /v2/subscriptions/search`
+- Mode: WRITE
+- Summary: SearchSubscriptions
+- Body: JSON request body accepted.
+
+### retrieve_subscription
+
+- Operation ID: `retrieve_subscription`
+- Route: `GET /v2/subscriptions/{subscription_id}`
+- Mode: READ
+- Summary: RetrieveSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+  - `include` in `query`
+
+### update_subscription
+
+- Operation ID: `update_subscription`
+- Route: `PUT /v2/subscriptions/{subscription_id}`
+- Mode: WRITE
+- Summary: UpdateSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.
+
+### delete_subscription_action
+
+- Operation ID: `delete_subscription_action`
+- Route: `DELETE /v2/subscriptions/{subscription_id}/actions/{action_id}`
+- Mode: WRITE
+- Summary: DeleteSubscriptionAction
+- Parameters:
+  - `subscription_id` in `path` required
+  - `action_id` in `path` required
+
+### change_billing_anchor_date
+
+- Operation ID: `change_billing_anchor_date`
+- Route: `POST /v2/subscriptions/{subscription_id}/billing-anchor`
+- Mode: WRITE
+- Summary: ChangeBillingAnchorDate
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.
+
+### cancel_subscription
+
+- Operation ID: `cancel_subscription`
+- Route: `POST /v2/subscriptions/{subscription_id}/cancel`
+- Mode: WRITE
+- Summary: CancelSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+
+### list_subscription_events
+
+- Operation ID: `list_subscription_events`
+- Route: `GET /v2/subscriptions/{subscription_id}/events`
+- Mode: READ
+- Summary: ListSubscriptionEvents
+- Parameters:
+  - `subscription_id` in `path` required
+  - `cursor` in `query`
+  - `limit` in `query`
+
+### pause_subscription
+
+- Operation ID: `pause_subscription`
+- Route: `POST /v2/subscriptions/{subscription_id}/pause`
+- Mode: WRITE
+- Summary: PauseSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.
+
+### resume_subscription
+
+- Operation ID: `resume_subscription`
+- Route: `POST /v2/subscriptions/{subscription_id}/resume`
+- Mode: WRITE
+- Summary: ResumeSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.
+
+### swap_plan
+
+- Operation ID: `swap_plan`
+- Route: `POST /v2/subscriptions/{subscription_id}/swap-plan`
+- Mode: WRITE
+- Summary: SwapPlan
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.

skills/team-members/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: team-members-routes
+description: Handle 12 OpenAPI operation(s) under /v2/team-members for the team members route group.
+---
+
+# team members API Routes
+
+Handle 12 OpenAPI operation(s) under /v2/team-members for the team members route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### create_team_member
+
+- Operation ID: `create_team_member`
+- Route: `POST /v2/team-members`
+- Mode: WRITE
+- Summary: CreateTeamMember
+- Body: JSON request body accepted.
+
+### bulk_create_team_members
+
+- Operation ID: `bulk_create_team_members`
+- Route: `POST /v2/team-members/bulk-create`
+- Mode: WRITE
+- Summary: BulkCreateTeamMembers
+- Body: JSON request body accepted.
+
+### bulk_update_team_members
+
+- Operation ID: `bulk_update_team_members`
+- Route: `POST /v2/team-members/bulk-update`
+- Mode: WRITE
+- Summary: BulkUpdateTeamMembers
+- Body: JSON request body accepted.
+
+### list_jobs
+
+- Operation ID: `list_jobs`
+- Route: `GET /v2/team-members/jobs`
+- Mode: READ
+- Summary: ListJobs
+- Parameters:
+  - `cursor` in `query`
+
+### create_job
+
+- Operation ID: `create_job`
+- Route: `POST /v2/team-members/jobs`
+- Mode: WRITE
+- Summary: CreateJob
+- Body: JSON request body accepted.
+
+### retrieve_job
+
+- Operation ID: `retrieve_job`
+- Route: `GET /v2/team-members/jobs/{job_id}`
+- Mode: READ
+- Summary: RetrieveJob
+- Parameters:
+  - `job_id` in `path` required
+
+### update_job
+
+- Operation ID: `update_job`
+- Route: `PUT /v2/team-members/jobs/{job_id}`
+- Mode: WRITE
+- Summary: UpdateJob
+- Parameters:
+  - `job_id` in `path` required
+- Body: JSON request body accepted.
+
+### search_team_members
+
+- Operation ID: `search_team_members`
+- Route: `POST /v2/team-members/search`
+- Mode: WRITE
+- Summary: SearchTeamMembers
+- Body: JSON request body accepted.
+
+### retrieve_team_member
+
+- Operation ID: `retrieve_team_member`
+- Route: `GET /v2/team-members/{team_member_id}`
+- Mode: READ
+- Summary: RetrieveTeamMember
+- Parameters:
+  - `team_member_id` in `path` required
+
+### update_team_member
+
+- Operation ID: `update_team_member`
+- Route: `PUT /v2/team-members/{team_member_id}`
+- Mode: WRITE
+- Summary: UpdateTeamMember
+- Parameters:
+  - `team_member_id` in `path` required
+- Body: JSON request body accepted.
+
+### retrieve_wage_setting
+
+- Operation ID: `retrieve_wage_setting`
+- Route: `GET /v2/team-members/{team_member_id}/wage-setting`
+- Mode: READ
+- Summary: RetrieveWageSetting
+- Parameters:
+  - `team_member_id` in `path` required
+
+### update_wage_setting
+
+- Operation ID: `update_wage_setting`
+- Route: `PUT /v2/team-members/{team_member_id}/wage-setting`
+- Mode: WRITE
+- Summary: UpdateWageSetting
+- Parameters:
+  - `team_member_id` in `path` required
+- Body: JSON request body accepted.

skills/terminals/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: terminals-routes
+description: Handle 15 OpenAPI operation(s) under /v2/terminals for the terminals route group.
+---
+
+# terminals API Routes
+
+Handle 15 OpenAPI operation(s) under /v2/terminals for the terminals route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### create_terminal_action
+
+- Operation ID: `create_terminal_action`
+- Route: `POST /v2/terminals/actions`
+- Mode: WRITE
+- Summary: CreateTerminalAction
+- Body: JSON request body accepted.
+
+### search_terminal_actions
+
+- Operation ID: `search_terminal_actions`
+- Route: `POST /v2/terminals/actions/search`
+- Mode: WRITE
+- Summary: SearchTerminalActions
+- Body: JSON request body accepted.
+
+### get_terminal_action
+
+- Operation ID: `get_terminal_action`
+- Route: `GET /v2/terminals/actions/{action_id}`
+- Mode: READ
+- Summary: GetTerminalAction
+- Parameters:
+  - `action_id` in `path` required
+
+### cancel_terminal_action
+
+- Operation ID: `cancel_terminal_action`
+- Route: `POST /v2/terminals/actions/{action_id}/cancel`
+- Mode: WRITE
+- Summary: CancelTerminalAction
+- Parameters:
+  - `action_id` in `path` required
+
+### dismiss_terminal_action
+
+- Operation ID: `dismiss_terminal_action`
+- Route: `POST /v2/terminals/actions/{action_id}/dismiss`
+- Mode: WRITE
+- Summary: DismissTerminalAction
+- Parameters:
+  - `action_id` in `path` required
+
+### create_terminal_checkout
+
+- Operation ID: `create_terminal_checkout`
+- Route: `POST /v2/terminals/checkouts`
+- Mode: WRITE
+- Summary: CreateTerminalCheckout
+- Body: JSON request body accepted.
+
+### search_terminal_checkouts
+
+- Operation ID: `search_terminal_checkouts`
+- Route: `POST /v2/terminals/checkouts/search`
+- Mode: WRITE
+- Summary: SearchTerminalCheckouts
+- Body: JSON request body accepted.
+
+### get_terminal_checkout
+
+- Operation ID: `get_terminal_checkout`
+- Route: `GET /v2/terminals/checkouts/{checkout_id}`
+- Mode: READ
+- Summary: GetTerminalCheckout
+- Parameters:
+  - `checkout_id` in `path` required
+
+### cancel_terminal_checkout
+
+- Operation ID: `cancel_terminal_checkout`
+- Route: `POST /v2/terminals/checkouts/{checkout_id}/cancel`
+- Mode: WRITE
+- Summary: CancelTerminalCheckout
+- Parameters:
+  - `checkout_id` in `path` required
+
+### dismiss_terminal_checkout
+
+- Operation ID: `dismiss_terminal_checkout`
+- Route: `POST /v2/terminals/checkouts/{checkout_id}/dismiss`
+- Mode: WRITE
+- Summary: DismissTerminalCheckout
+- Parameters:
+  - `checkout_id` in `path` required
+
+### create_terminal_refund
+
+- Operation ID: `create_terminal_refund`
+- Route: `POST /v2/terminals/refunds`
+- Mode: WRITE
+- Summary: CreateTerminalRefund
+- Body: JSON request body accepted.
+
+### search_terminal_refunds
+
+- Operation ID: `search_terminal_refunds`
+- Route: `POST /v2/terminals/refunds/search`
+- Mode: WRITE
+- Summary: SearchTerminalRefunds
+- Body: JSON request body accepted.
+
+### get_terminal_refund
+
+- Operation ID: `get_terminal_refund`
+- Route: `GET /v2/terminals/refunds/{terminal_refund_id}`
+- Mode: READ
+- Summary: GetTerminalRefund
+- Parameters:
+  - `terminal_refund_id` in `path` required
+
+### cancel_terminal_refund
+
+- Operation ID: `cancel_terminal_refund`
+- Route: `POST /v2/terminals/refunds/{terminal_refund_id}/cancel`
+- Mode: WRITE
+- Summary: CancelTerminalRefund
+- Parameters:
+  - `terminal_refund_id` in `path` required
+
+### dismiss_terminal_refund
+
+- Operation ID: `dismiss_terminal_refund`
+- Route: `POST /v2/terminals/refunds/{terminal_refund_id}/dismiss`
+- Mode: WRITE
+- Summary: DismissTerminalRefund
+- Parameters:
+  - `terminal_refund_id` in `path` required

skills/transfer-orders/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: transfer-orders-routes
+description: Handle 8 OpenAPI operation(s) under /v2/transfer-orders for the transfer orders route group.
+---
+
+# transfer orders API Routes
+
+Handle 8 OpenAPI operation(s) under /v2/transfer-orders for the transfer orders route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### create_transfer_order
+
+- Operation ID: `create_transfer_order`
+- Route: `POST /v2/transfer-orders`
+- Mode: WRITE
+- Summary: CreateTransferOrder
+- Body: JSON request body accepted.
+
+### search_transfer_orders
+
+- Operation ID: `search_transfer_orders`
+- Route: `POST /v2/transfer-orders/search`
+- Mode: WRITE
+- Summary: SearchTransferOrders
+- Body: JSON request body accepted.
+
+### delete_transfer_order
+
+- Operation ID: `delete_transfer_order`
+- Route: `DELETE /v2/transfer-orders/{transfer_order_id}`
+- Mode: WRITE
+- Summary: DeleteTransferOrder
+- Parameters:
+  - `transfer_order_id` in `path` required
+  - `version` in `query`
+
+### retrieve_transfer_order
+
+- Operation ID: `retrieve_transfer_order`
+- Route: `GET /v2/transfer-orders/{transfer_order_id}`
+- Mode: READ
+- Summary: RetrieveTransferOrder
+- Parameters:
+  - `transfer_order_id` in `path` required
+
+### update_transfer_order
+
+- Operation ID: `update_transfer_order`
+- Route: `PUT /v2/transfer-orders/{transfer_order_id}`
+- Mode: WRITE
+- Summary: UpdateTransferOrder
+- Parameters:
+  - `transfer_order_id` in `path` required
+- Body: JSON request body accepted.
+
+### cancel_transfer_order
+
+- Operation ID: `cancel_transfer_order`
+- Route: `POST /v2/transfer-orders/{transfer_order_id}/cancel`
+- Mode: WRITE
+- Summary: CancelTransferOrder
+- Parameters:
+  - `transfer_order_id` in `path` required
+- Body: JSON request body accepted.
+
+### receive_transfer_order
+
+- Operation ID: `receive_transfer_order`
+- Route: `POST /v2/transfer-orders/{transfer_order_id}/receive`
+- Mode: WRITE
+- Summary: ReceiveTransferOrder
+- Parameters:
+  - `transfer_order_id` in `path` required
+- Body: JSON request body accepted.
+
+### start_transfer_order
+
+- Operation ID: `start_transfer_order`
+- Route: `POST /v2/transfer-orders/{transfer_order_id}/start`
+- Mode: WRITE
+- Summary: StartTransferOrder
+- Parameters:
+  - `transfer_order_id` in `path` required
+- Body: JSON request body accepted.

skills/vendors/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: vendors-routes
+description: Handle 7 OpenAPI operation(s) under /v2/vendors for the vendors route group.
+---
+
+# vendors API Routes
+
+Handle 7 OpenAPI operation(s) under /v2/vendors for the vendors route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### bulk_create_vendors
+
+- Operation ID: `bulk_create_vendors`
+- Route: `POST /v2/vendors/bulk-create`
+- Mode: WRITE
+- Summary: BulkCreateVendors
+- Body: JSON request body accepted.
+
+### bulk_retrieve_vendors
+
+- Operation ID: `bulk_retrieve_vendors`
+- Route: `POST /v2/vendors/bulk-retrieve`
+- Mode: WRITE
+- Summary: BulkRetrieveVendors
+- Body: JSON request body accepted.
+
+### bulk_update_vendors
+
+- Operation ID: `bulk_update_vendors`
+- Route: `PUT /v2/vendors/bulk-update`
+- Mode: WRITE
+- Summary: BulkUpdateVendors
+- Body: JSON request body accepted.
+
+### create_vendor
+
+- Operation ID: `create_vendor`
+- Route: `POST /v2/vendors/create`
+- Mode: WRITE
+- Summary: CreateVendor
+- Body: JSON request body accepted.
+
+### search_vendors
+
+- Operation ID: `search_vendors`
+- Route: `POST /v2/vendors/search`
+- Mode: WRITE
+- Summary: SearchVendors
+- Body: JSON request body accepted.
+
+### retrieve_vendor
+
+- Operation ID: `retrieve_vendor`
+- Route: `GET /v2/vendors/{vendor_id}`
+- Mode: READ
+- Summary: RetrieveVendor
+- Parameters:
+  - `vendor_id` in `path` required
+
+### update_vendor
+
+- Operation ID: `update_vendor`
+- Route: `PUT /v2/vendors/{vendor_id}`
+- Mode: WRITE
+- Summary: UpdateVendor
+- Parameters:
+  - `vendor_id` in `path` required
+- Body: JSON request body accepted.

skills/webhooks/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: webhooks-routes
+description: Handle 8 OpenAPI operation(s) under /v2/webhooks for the webhooks route group.
+---
+
+# webhooks API Routes
+
+Handle 8 OpenAPI operation(s) under /v2/webhooks for the webhooks route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### list_webhook_event_types
+
+- Operation ID: `list_webhook_event_types`
+- Route: `GET /v2/webhooks/event-types`
+- Mode: READ
+- Summary: ListWebhookEventTypes
+- Parameters:
+  - `api_version` in `query`
+
+### list_webhook_subscriptions
+
+- Operation ID: `list_webhook_subscriptions`
+- Route: `GET /v2/webhooks/subscriptions`
+- Mode: READ
+- Summary: ListWebhookSubscriptions
+- Parameters:
+  - `cursor` in `query`
+  - `include_disabled` in `query`
+  - `sort_order` in `query`
+  - `limit` in `query`
+
+### create_webhook_subscription
+
+- Operation ID: `create_webhook_subscription`
+- Route: `POST /v2/webhooks/subscriptions`
+- Mode: WRITE
+- Summary: CreateWebhookSubscription
+- Body: JSON request body accepted.
+
+### delete_webhook_subscription
+
+- Operation ID: `delete_webhook_subscription`
+- Route: `DELETE /v2/webhooks/subscriptions/{subscription_id}`
+- Mode: WRITE
+- Summary: DeleteWebhookSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+
+### retrieve_webhook_subscription
+
+- Operation ID: `retrieve_webhook_subscription`
+- Route: `GET /v2/webhooks/subscriptions/{subscription_id}`
+- Mode: READ
+- Summary: RetrieveWebhookSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+
+### update_webhook_subscription
+
+- Operation ID: `update_webhook_subscription`
+- Route: `PUT /v2/webhooks/subscriptions/{subscription_id}`
+- Mode: WRITE
+- Summary: UpdateWebhookSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.
+
+### update_webhook_subscription_signature_key
+
+- Operation ID: `update_webhook_subscription_signature_key`
+- Route: `POST /v2/webhooks/subscriptions/{subscription_id}/signature-key`
+- Mode: WRITE
+- Summary: UpdateWebhookSubscriptionSignatureKey
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.
+
+### test_webhook_subscription
+
+- Operation ID: `test_webhook_subscription`
+- Route: `POST /v2/webhooks/subscriptions/{subscription_id}/test`
+- Mode: WRITE
+- Summary: TestWebhookSubscription
+- Parameters:
+  - `subscription_id` in `path` required
+- Body: JSON request body accepted.