adjust_stock
ChatGPTApply a relative stock adjustment to one product: quantity is a signed change in units, NOT the final stock quantity (positive adds units, negative removes units). Requires product_id (or productId) and quantity; supply a reason for the stock history. The resulting stock is clamped at zero. This write changes recorded inventory and cannot be automatically undone. Vendor access is limited to the signed-in merchant's own products; admin and warehouse access remain subject to their existing permissions.
admin_get_action_logs
ChatGPTList user action logs across the platform, filterable by resource type, with actor, action, timestamp and IP address. Read-only, administrators only.
admin_get_admin_audit_logs
ChatGPTGet admin action audit logs with filters by action_type and entity_type.
admin_get_app_config
ChatGPTGet non-sensitive application configuration by category or key.
admin_get_audit_log
ChatGPTList administrative actions performed on the platform, with the administrator, the action type, the affected entity and the timestamp. Read-only, administrators only.
admin_get_blocked_entities
ChatGPTList blocked customers and blocked IP addresses with the reason and the date they were blocked. Read-only, administrators only.
admin_get_carrier_configs
ChatGPTGet carrier configurations (API endpoints, codes, active status).
admin_get_carrier_remittances
ChatGPTList carrier remittance records with expected amount, received amount, reconciliation status and variance in TND. Read-only, administrators only.
admin_get_carrier_stats
ChatGPTReturn per-carrier performance statistics: parcels handled, delivered rate, failure rate and average delivery time. Read-only, administrators only.
admin_get_carrier_status_history
ChatGPTReturn the carrier status history of a parcel or an order: every status change with timestamp and source. Read-only, administrators only.
admin_get_carrier_webhook_logs
ChatGPTList carrier webhook events received by the platform, with carrier, event type, tracking number and processing status. Read-only, administrators only.
admin_get_categories
ChatGPTGet product categories with optional parent_id and status filters.
admin_get_charge_lines
ChatGPTList service fee lines per merchant with fee type, order reference, amount in TND and billing period. Accepts a vendor_id filter. Read-only, administrators only.
admin_get_confirmation_attempts
ChatGPTList confirmation call attempts for one order or across all orders, with agent, channel, outcome and timestamp. Read-only, administrators only.
admin_get_connection_logs
ChatGPTGet user connection logs (login/logout/failed) with filters by role.
admin_get_daily_payments
ChatGPTList daily payout records per merchant with gross amount, fee breakdown and net amount in TND. Accepts a vendor_id filter. Read-only reporting, administrators only; cannot initiate a payment.
admin_get_daily_stats
ChatGPTReturn the daily platform dashboard: orders created, delivered and cancelled today, revenue in TND and comparison with the previous day. Read-only, administrators only.
admin_get_delivery_failure_analysis
ChatGPTGet delivery failure analysis by carrier, reason, and governorate.
admin_get_finance_summary
ChatGPTReturn the consolidated financial view of the platform: revenue, service fees, merchant payouts and outstanding balances in TND. Read-only, administrators only.
admin_get_flash_deals
ChatGPTList currently active promotional deals with the product, the discount percentage and the validity window. Read-only, administrators only.
admin_get_homepage_config
ChatGPTGet homepage sections, banners, and featured vendors configuration.
admin_get_job_logs
ChatGPTGet background job execution logs with filters by status and job_name.
admin_get_mcp_tools_registry
ChatGPTReturn the full MCP tool registry stored in the database, with each tool's profile, access type and enabled flag. Read-only, administrators only.
admin_get_mcp_usage
ChatGPTReturn MCP usage statistics: calls per tool, per profile and per day, with success and error counts. Read-only, administrators only.
admin_get_notification_config
ChatGPTGet notification configuration (in-app, email, WhatsApp) by category.
admin_get_notifications_config
ChatGPTReturn the platform notification configuration: which events trigger an email, SMS or push message, and to which recipients. Read-only, administrators only.
admin_get_onboarding_stats
ChatGPTReturn merchant onboarding completion statistics: how many accounts completed each step and where candidates drop off. Read-only, administrators only.
admin_get_order_history
ChatGPTReturn the complete status history of one order, with every transition, the actor who triggered it and the timestamp. Requires order_id. Read-only, administrators only.
admin_get_orders_by_governorate
ChatGPTReturn the breakdown of orders by Tunisian governorate, with counts, revenue in TND, delivered and cancelled figures. Read-only, administrators only.
admin_get_orders_by_payment_method
ChatGPTReturn the breakdown of orders by payment method, with counts, revenue in TND and paid versus pending figures. Cash on delivery is the only method in use. Read-only, administrators only.
admin_get_orders_by_source
ChatGPTGet order breakdown by source channel (website, app, manual, etc.).
admin_get_platform_health
ChatGPTGet real-time platform health: orders, vendors, stock, jobs, webhooks.
admin_get_purge_configs
ChatGPTReturn the data retention and purge configuration, with the last purge run and the number of rows removed. Read-only, administrators only.
admin_get_sync_status
ChatGPTReturn the synchronisation status of every connected external shop, with last run, items processed and pending errors. Read-only, administrators only.
admin_get_top_products
ChatGPTReturn the best-selling products over a period expressed in days, ranked by revenue in TND, with units sold and the merchant. Read-only, administrators only.
admin_get_top_vendors
ChatGPTRank merchants over a rolling window of days by delivered revenue in TND or by number of orders, returning shop name, status, order count and revenue for each. Answers questions such as the top five merchants over the last ninety days. Read-only, administrators only.
admin_get_training_videos
ChatGPTList the training videos available in the platform, filterable by page key and language. Read-only, administrators only.
admin_get_user_stats
ChatGPTReturn user statistics by role, account status and recent activity, with totals and new registrations. Read-only, administrators only.
admin_get_users
ChatGPTGet user accounts with filters by role, status, and search query.
admin_get_vendor_activity
ChatGPTGet vendor activity (orders, revenue) over a period of days.
admin_get_vendor_details
ChatGPTReturn the full record of one merchant: shop name, contact, status, plan, activity and financial summary. Requires vendor_id. Read-only, administrators only.
admin_get_vendor_onboarding_stats
ChatGPTReturn merchant onboarding statistics grouped by status, business type and plan. Read-only, administrators only.
admin_get_vendors_created_today
ChatGPTList the merchant accounts created today, with shop name, contact and onboarding status. Read-only, administrators only.
admin_get_warehouse_overview
ChatGPTReturn the warehouse overview: stock volume held, tasks in progress, parcels awaiting pickup and occupancy per zone. Read-only, administrators only.
admin_get_withholding_tax
ChatGPTList withholding tax entries by merchant and declaration month, with base, rate, amount in TND and declaration status. Read-only, administrators only.
admin_list_all_orders
ChatGPTList orders across every merchant on the platform. Pass vendor_id to restrict the result to a single merchant, otherwise the figures cover all merchants. Supports status, date and paging filters. Read-only, administrators only.
admin_list_vendors
ChatGPTList all merchants registered on the platform with shop name, status, plan and activity summary. Supports status and search filters. Read-only, administrators only.
admin_suspend_vendor
ChatGPTSuspend a merchant account, which prevents new orders while preserving existing data. Requires vendor_id and a reason. Write action, administrators only.
cancel_order
ChatGPTCancel one of your own orders that has not shipped yet. Requires the order id and a cancellation reason. Write action, scoped to the signed-in merchant; orders already shipped or delivered cannot be cancelled.
compare_periods
ChatGPTCompare the last N days with the N days immediately before, returning order count and delivered revenue for both windows plus the absolute and percentage change. When the earlier window has no order the percentage is returned as null instead of a misleading figure. Read-only, scoped to the signed-in merchant; administrators may pass vendor_id.
complete_warehouse_task
ChatGPTMark a warehouse task (picking, packing, put-away, quality control) as completed. Write action, warehouse operators only.
confirm_order
ChatGPTConfirm an order after reaching the customer by phone, so it can move to fulfilment. Requires the order id. Write action, confirmation agents only.
create_collection_request
ChatGPTCreate a request for bryny to collect goods from your premises and bring them into the fulfilment warehouse. Write action, scoped to the signed-in merchant.
create_product
ChatGPTAdd a new product to your own catalogue with name, price, stock and category. Write action, scoped to the signed-in merchant. Does not publish anything for sale inside the assistant.
create_stock_reprise
ChatGPTRequest the return of your stock currently held in the bryny warehouse back to you. Write action, scoped to the signed-in merchant.
get_billing_summary
ChatGPTReturn a monthly summary of the fulfilment and logistics fees invoiced to you by bryny: storage, picking, shipping and return handling, with totals in TND. Read-only, scoped to the signed-in merchant.
get_blocked_customers
ChatGPTList customers currently blocked across the platform, with the reason and the date they were blocked. Read-only, support agents only.
get_categories_public
ChatGPTList the active product categories of the public bryny marketplace. Read-only, no authentication required, no parameters. Returns each category with its numeric id and display name. Use it before search_products_public whenever the user asks for a specific kind of product, because search_products_public expects a numeric category_id rather than a category name. Example: the user asks for sport equipment, call this tool, find the matching category and pass its id to search_products_public.
get_charges
ChatGPTList the individual service fees charged to you (storage, picking, packing, shipping, returns) with date, type and amount in TND. Read-only, scoped to the signed-in merchant.
get_client_history
ChatGPTReturn a customer's order history across all merchants: number of orders, delivered, refused and cancelled, used to assess reliability before confirming. Read-only, confirmation agents only.
get_cod_summary
ChatGPTReturn a single consolidated cash-on-delivery summary over a rolling window of days: number of orders, gross amount, amount already collected on delivered orders, amount still in transit, amount lost on cancelled or returned orders, and the collection rate, all in TND. Answers questions such as how much cash was collected this month without listing every order. Read-only, scoped to the signed-in merchant; administrators may pass vendor_id to focus on one merchant.
get_collection_requests
ChatGPTList your requests for bryny to collect goods from your premises, with their current status and scheduled dates. Read-only, scoped to the signed-in merchant.
get_confirmation_queue
ChatGPTList the orders waiting for a confirmation call, with customer, amount and how many attempts were already made. Read-only, confirmation agents only.
get_confirmation_stats
ChatGPTReturn confirmation service indicators: orders confirmed, rejected and pending, confirmation rate and average attempts per order. Read-only, confirmation agents only.
get_delegations
ChatGPTList the delegations (second-level administrative districts) of one Tunisian governorate, used by bryny for delivery addresses. Read-only, no authentication required. Requires governorate_id, the numeric id returned by get_governorates. Returns each delegation with its numeric id and name. Example: the user mentions a district near Tunis, call get_governorates, take the id of Tunis, then call this tool with that governorate_id.
get_delivery_performance
ChatGPTReturn delivery performance indicators for your own orders: delivered rate, failed delivery rate, average delivery time and counts per outcome. Read-only, scoped to the signed-in merchant.
get_exchanges
ChatGPTList product exchange requests raised on your own orders, with status, reason and the items involved. Read-only, scoped to the signed-in merchant.
get_governorates
ChatGPTList the active Tunisian governorates (first-level administrative regions) used by bryny for delivery addresses. Read-only, no authentication required, no parameters. Returns each governorate with its numeric id and name. Use it as the first step when a delivery address must be described, then call get_delegations with the chosen governorate id.
get_inbound_shipments
ChatGPTList the shipments you have sent into the bryny warehouse, with expected quantities, reception status and dates. Read-only, scoped to the signed-in merchant.
get_inventory
ChatGPTReturn your current inventory held in the bryny fulfilment warehouse: quantity on hand, reserved and available per product and per location. Read-only, scoped to the signed-in merchant.
get_invoices
ChatGPTList the invoices bryny issued to you for fulfilment and logistics services, with number, period, amount in TND and payment status. Read-only, scoped to the signed-in merchant.
get_my_profile
ChatGPTReturn the authenticated user's own bryny account profile: display name, role in the platform, and preferred language. Read-only, no parameters. Use it only when the user explicitly asks about their own bryny account or which role they are connected with. It never returns another user's data, and never returns passwords, tokens, or payment information.
get_order_details
ChatGPTReturn the full detail of one order belonging to the authenticated merchant's own bryny shop. Read-only, never modifies the order. Requires order_id (numeric id) or order_number (human-readable reference), both obtainable from list_orders. Returns the ordered line items with quantities and unit prices, the delivery address, the dated status history, the delivery state, and the payment method, which on bryny is cash on delivery. Example: after list_orders returns order number CMD-1042, call this tool with order_number CMD-1042. If the order does not belong to the authenticated merchant, access is denied.
get_order_stats
ChatGPTReturn read-only key performance indicators for the authenticated merchant's own bryny shop: total number of orders, breakdown by status, and aggregated revenue in TND. No parameters are required, since the merchant's scope is taken from the authenticated session. Use it when the user asks how their shop is performing, how many orders they received, or what their delivery success rate is. It never modifies data and never returns another merchant's figures.
get_packs
ChatGPTList the product bundles (packs) defined in your catalogue, with their composition and price. Read-only, scoped to the signed-in merchant.
get_parcel_tracking
ChatGPTReturn the full tracking timeline of one of your parcels: every carrier scan with date, location and status label. Read-only, scoped to the signed-in merchant.
get_parcels
ChatGPTList the parcels created for your own orders, with tracking number, current delivery status and destination city. Read-only, scoped to the signed-in merchant.
get_parcels_to_ship
ChatGPTList the parcels prepared and waiting for carrier pickup, with destination and assigned carrier. Read-only, warehouse operators only.
get_payments
ChatGPTList the payouts bryny transferred to you, with date, amount in TND, payment method and reference. Read-only, scoped to the signed-in merchant. This only reports past payouts; it cannot initiate any payment.
get_platform_info
ChatGPTReturn non-sensitive service information about the bryny assistant integration: platform name, service version, supported user roles, and documentation URL. Read-only, no authentication required, no parameters. Use it only when the user explicitly asks what the bryny connector is or which capabilities it offers; it returns no business or personal data.
get_product_details
ChatGPTReturn the full record of one of your products: name, description, price, stock, category, variants and images. Requires the product id. Read-only, scoped to the signed-in merchant.
get_product_lifecycle
ChatGPTGet lifecycle events for a product (stock in/out, orders, returns).
get_product_variants
ChatGPTList the variants (colour, size and other options) of one of your products, with their own price and stock. Read-only, scoped to the signed-in merchant.
get_returns
ChatGPTList the return requests received by the authenticated merchant's own bryny shop. Read-only: it never approves, refuses, or creates a return. Returns for each request the related order reference, the reason given, the current processing state, and the request date. Use it when the user asks about their returns or after-sales requests.
get_revenue_by_period
ChatGPTReturn revenue broken down into day, week or month buckets over a rolling window, with order count, gross revenue and delivered revenue per bucket plus overall totals in TND. Use it for trend questions such as revenue per week over the last three months. Read-only, scoped to the signed-in merchant; administrators may pass vendor_id.
get_shop_connections
ChatGPTReturn the status of your external shop integrations (Converty, WooCommerce, YouCan, TiktakPro), with last sync date and connection health. Read-only, scoped to the signed-in merchant.
get_shop_overview
ChatGPTReturn a one-call overview of a shop: all-time order count and gross revenue with the exact breakdown per order status, the recent period figures, and catalogue health with product count, out-of-stock and low-stock counts. When the catalogue is empty the payload says so explicitly, so an empty catalogue is never reported as no stock alerts. Read-only, scoped to the signed-in merchant; administrators may pass vendor_id.
get_stock_alerts
ChatGPTReturn the products of the authenticated merchant's own bryny catalogue that are out of stock or below their low-stock threshold, so the merchant knows what to restock first. Read-only, no parameters required. Returns for each flagged product the name, the remaining quantity, and the alert threshold. If every product is comfortably in stock, an empty list is returned, which means there is nothing to restock. Example: the user asks which products are running low, call this tool directly.
get_stock_levels
ChatGPTReturn the current inventory of the authenticated merchant's own bryny catalogue, product by product and variant by variant. Read-only: it reports quantities but never adjusts them. No parameters are required, the merchant scope comes from the authenticated session. Returns for each product or variant the name, the available quantity, and the low-stock threshold. Use it when the user asks what they have in stock. To focus only on products that need restocking, use get_stock_alerts instead.
get_stock_movements
ChatGPTList stock movements for your products (inbound, outbound, adjustment, transfer) with date, quantity, reason and resulting balance. Read-only, scoped to the signed-in merchant.
get_stock_reprises
ChatGPTList your requests to have stock returned from the bryny warehouse, with status and scheduled dates. Read-only, scoped to the signed-in merchant.
get_sync_connections
ChatGPTGet sync connections (Converty, YouCan, TiktakPro) for a vendor.
get_sync_logs
ChatGPTReturn the synchronisation history between your external shops and bryny: date, channel, items processed and any error. Read-only, scoped to the signed-in merchant.
get_sync_logs_detailed
ChatGPTGet detailed sync logs per platform (converty/youcan/tiktakpro).
get_ticket_details
ChatGPTReturn the full content of a support ticket: subject, status, priority, related order and the complete message thread. Requires the ticket id. Read-only, support agents only.
get_unit_items
ChatGPTList individually tracked unit items in the warehouse with their serial or unit code, product and current location. Read-only, warehouse operators only.
get_vendor_accounting_journal
ChatGPTRead a vendor's accounting journal entries: dates, credits/debits, entry types, labels, amounts and related references, with filters and pagination. This is the existing MPE accounting ledger, not a payment or transaction action. Vendors see only their own ledger. Administrators should supply vendor_id to select one vendor. Read-only.
get_vendor_accounting_summary
ChatGPTRead a vendor's accounting summary: total credits, total debits, net ledger balance, entry count, breakdown by entry type and accounting settings. This summarizes the existing MPE ledger; it does not initiate payments or modify entries. Vendors see only their own ledger. Administrators should supply vendor_id to select one vendor. Read-only.
get_vendor_sales_channels
ChatGPTList the sales channels attached to your shop (own website, external marketplaces) with their activation status. Read-only, scoped to the signed-in merchant.
get_vendor_shop_config
ChatGPTGet shop configuration (theme, colors, social links) for a vendor.
get_wallet_balance
ChatGPTReturn the current fulfilment payout balance of your bryny wallet in TND, with the pending and available amounts. Read-only, scoped to the signed-in merchant. Reporting only; no payment can be initiated.
get_wallet_transactions
ChatGPTList the movements on your bryny wallet: credits from delivered cash-on-delivery orders, service fee debits and payouts, each with date, label and amount in TND. Read-only, scoped to the signed-in merchant.
get_warehouse_locations
ChatGPTReturn the warehouse location map: aisles, racks and bins with the stock currently stored in each. Read-only, warehouse operators only.
get_warehouse_packages
ChatGPTList packages in the warehouse with an optional status filter (being packed, ready, handed to carrier). Read-only, warehouse operators only.
get_warehouse_scan_events
ChatGPTList barcode scan events recorded in the warehouse, with timestamp, operator, scanned code and resulting action. Read-only, warehouse operators only.
get_warehouse_storage_stats
ChatGPTReturn warehouse storage capacity and occupancy statistics: used and free capacity per zone, and overall fill rate. Read-only, warehouse operators only.
get_warehouse_tasks
ChatGPTList picking and packing tasks currently in progress, with assignee, priority and related order. Read-only, warehouse operators only.
get_warehouse_zones
ChatGPTList the warehouse storage zones with their occupancy rate and the type of goods they hold. Read-only, warehouse operators only.
get_warehouses
ChatGPTList the active bryny fulfilment warehouses with their code, city and operating status. Read-only, warehouse operators only.
list_orders
ChatGPTList the orders of the authenticated merchant's own bryny shop, most recent first. Read-only: it never creates, modifies, or cancels an order. Data scope is enforced server-side, so a merchant can only ever see their own orders. Accepts optional filters: status (for example pending, confirmed, shipped, delivered, cancelled), date (YYYY-MM-DD), page (default 1) and limit (default 20, maximum 100). Returns for each order: order number, customer first name, city, status, total amount in TND, and creation date. Example: the user asks for their pending orders of today, call this tool with status pending and today's date. Use get_order_details afterwards to open one specific order.
list_products
ChatGPTList the products in your own catalogue with name, price, stock level and status. Supports paging and a status filter. Read-only, scoped to the signed-in merchant.
list_support_tickets
ChatGPTList open support tickets with subject, status, priority and the merchant or customer concerned. Read-only, support agents only.
reject_order
ChatGPTReject an order after the confirmation call failed or the customer cancelled. Requires the order id and a reason. Write action, confirmation agents only.
reply_to_ticket
ChatGPTAdd a reply to an existing support ticket. Requires the ticket id and the message body. Write action, support agents only.
request_exchange
ChatGPTOpen an exchange request for one delivered order of the authenticated customer on bryny, for example to swap a size or a colour. This is a WRITE action: it creates an after-sales request that the merchant will then process, so ask the user for an explicit confirmation before calling it. Requires the order identifier and the reason for the exchange. It does not move any money and takes no payment. Returns the created request with its reference and initial state.
request_return
ChatGPTOpen a return request for one delivered order of the authenticated customer on bryny. This is a WRITE action: it creates an after-sales request that the merchant will then process, so ask the user for an explicit confirmation before calling it. Requires the order identifier and a reason for the return. It does not move any money: bryny orders are paid cash on delivery, and any refund is handled offline by the merchant. Returns the created request with its reference and initial state. It cannot be used on an order that has not been delivered.
scan_barcode
ChatGPTIdentify a product, parcel or storage location from a scanned barcode and return the matching record. Read-only lookup, warehouse operators only.
search_orders
ChatGPTSearch your own orders by customer name, phone, order number or city, with optional status and date filters. Read-only, scoped to the signed-in merchant.
search_products
ChatGPTSearch your own product catalogue by name, reference or category. Read-only, scoped to the signed-in merchant.
search_products_public
ChatGPTSearch the public bryny marketplace catalogue of PHYSICAL products sold by Tunisian merchants. Read-only: this tool only returns catalogue information and can never place an order, add to a cart, or take a payment. Accepts optional filters: query (free text matched against the product name), category_id (numeric id obtained from get_categories_public), min_price and max_price (in Tunisian Dinar, TND) and limit (1-50, default 20). Returns for each product: id, name, price in TND, compare-at price, images, current stock quantity, category id and name, and shipping fee. Example: to find sport items under 100 TND, first call get_categories_public to obtain the category id, then call search_products_public with that category_id and max_price 100. If no product matches the filters, an empty products list is returned.
track_parcel
ChatGPTTrack the delivery progress of a single bryny marketplace parcel from its tracking number. Read-only, and strictly limited to parcels shipped through the bryny platform: it cannot track parcels from Amazon, AliExpress, or any other platform or carrier. Accepts tracking_number (the bryny tracking reference, required) or alternatively order_id. Returns the current delivery state and the dated history of tracking events. Example: the user asks where their bryny parcel BRY123456 is, call this tool with tracking_number BRY123456. If the tracking number does not exist on bryny, an explicit not-found message is returned.
trigger_sync
ChatGPTStart a manual synchronisation between one of your connected external shops and bryny. Write action, scoped to the signed-in merchant.
update_order_status
ChatGPTChange the operational status of one of your own orders, for example from confirmed to ready to ship. Requires the order id and the target status. Write action, scoped to the signed-in merchant.
update_product
ChatGPTUpdate selected fields of an existing product identified by product_id (or productId): name, description, SKU, price, comparison price, stock, status or low-stock threshold. Omitted fields are unchanged. This write overwrites stored values and can materially affect inventory, pricing or product availability; there is no automatic undo. Vendor access is limited to the signed-in merchant's own products; administrators retain their existing scope.
