B2bware MCP Server

[attributes] Create an attribute definition in AttributesHub. Set entity_scope (product, customer, order, company, category) or group_id. Brands use a product-scoped attribute (e.g. Brand/Manufacturer) with values via create_attribute_value / create_brand.

[attributes] Create an attribute group for a scope (usually pre-seeded per tenant).

[attributes] Create a predefined option (select/multiselect/swatch). swatch_value is forwarded to DataHub but may return null until backend persists it (verify with list_attribute_values). For colors without hex support, use value labels (e.g. "blue") and assign via auto_create_value on products.

[attributes] Delete an attribute definition by id.

[attributes] Delete an attribute group by id.

[attributes] Delete an attribute value by id.

[attributes] Get an attribute by id. Include values,group for full context.

[attributes] Get an attribute group by id.

[attributes] Get a single attribute value by id.

[attributes] List valid attribute group type strings from the API.

[attributes] List attribute groups (Product, Category, Order, Customer, Company). Use entity_scope to filter.

[attributes] List valid attribute definition types from AttributesHub (e.g. select, text, datetime, swatch).

[attributes] List values for an attribute_id (all options for that field).

[attributes] Update an attribute definition by id. All storefront/admin flags from create are supported.

[attributes] Update an attribute group.

[attributes] Update an attribute value by id.

[attributes] Create up to 100 attribute values in one call (partial success, parallel). Same fields as create_attribute_value per item. No DataHub bulk route — MCP orchestrates POSTs.

[attributes] Bulk create/update attribute definitions (AttributesHub insert/bulk). Max 100 items.

[catalog] Create up to 100 brands (partial success). Same fields as create_brand per item.

[catalog] Create up to 100 categories in one call (partial success). Items should list parents before children or include parent_id; order is normalized top-down.

[customer] Create up to 100 companies (partial success). Same fields as create_company per item.

[b2b] Create up to 100 customers (partial success). Same shape as create_customer_full per item.

[orders-admin] Create up to 100 orders (partial success). Each item uses the same fields as create_order.

[catalog] Create or upsert up to 100 products (partial success). Uses SKU upsert per item for idempotency.

[catalog] Bulk upsert stock records (POST /stock/upsert/bulk, max ~1000).

[catalog] Bulk upsert prices (POST /prices/upsert/bulk, max ~1000).

[orders-admin] Create an order directly in OrderHub (demo/backfill). Does NOT run cart checkout — use for historical or manual orders. Call list_shipping_methods, list_billing_methods, and list_customer_addresses first. Valid status: draft, pending, processing, completed, canceled, invoiced, shipped, paid, etc.

[orders-admin] Add a comment to an existing order (POST /order-comments). Use for customer notes or internal support annotations.

[orders-admin] Permanently delete an order by ID.

Get full details of a single order including line items.

[attributes] Read attributes on an order.

[attributes] Remove one attribute from an order.

[attributes] Assign attributes on an order (Order Attributes group).

[orders-admin] Update order fields (status, addresses, methods, order_date, external_reference). Does not replace line items — use update_order_line_items for that.

[orders-admin] Replace or update line items on an existing order via PUT /orders/{id}. Same line_items shape as create_order.

Update the status of an existing order. Valid statuses: draft, pending, processing, completed, canceled, invoiced, shipped, paid, refunded, partially_refunded, pending_payment.

[customer] Create a B2B company in CustomerHub. Optional address fields map to the company record. Requires admin/write scope.

[customer] Create shipping and/or billing address for a company (type: billing | shipping | both).

[customer] Delete a company by ID. CustomerHub DELETE /companies/{id}.

[customer] Get a company by ID from CustomerHub. Default includes: customers, shippingAddresses, billingAddresses. Add attributeValues,attributeValues.value for custom company attributes.

[attributes] Read custom attributes on a company.

[customer] List customers linked to a company (company_id on customer records).

[attributes] Remove one attribute from a company.

[attributes] Assign AttributesHub fields on a CustomerHub company (entity_scope=company, group id 5).

[customer] Update a company by ID (partial fields). CustomerHub PUT /companies/{id}.

Create a new customer account in B2Bware.

[b2b] Create a customer with optional company link and billing/shipping addresses in one call. Use list_companies or search_companies first if you need an existing company_id.

[b2b] Delete a customer by ID.

Get full details of a single customer by ID, including their shipping and billing addresses.

[attributes] Read attributes on a customer.

List all shipping and billing addresses for a customer.

[attributes] Remove one attribute from a customer.

[attributes] Assign attributes on a customer (Customer Attributes group).

Update an existing customer account (name, phone, status, company_id, role_id, etc.).

[catalog] Create a new simple product with price, stock, categories, optional images and tier prices. Call list_categories first for valid category_ids. SKU must be unique.

[catalog] Add a quantity tier price to an existing product. Fetches current tiers and appends one row.

[catalog] Delete a product by ID.

Get full details of a single B2Bware product by ID.

[attributes] Alias: get_entity_attributes for products (includes brand summary).

[catalog] List child variations and variation attributes for a configurable parent product.

[attributes] Alias: remove_entity_attribute for products.

[attributes] Alias: set_entity_attributes with entity_scope=product.

[catalog] Update a product by ID (partial fields). Supports price, stock, categories, media URLs.

Add one product line to a cart via POST /cart-items (preferred for admin/test carts). Provide cart_id OR session_uuid (and optional customer_id). Returns the cart item.

Retrieve the current cart contents for a session by session_uuid. Uses API filter when supported; otherwise may require multiple list calls when many carts exist.

[rulehub] Get a cart price rule by ID. RuleHub GET /cart-price-rules/{id}.

[rulehub] List cart-level price rules. RuleHub GET /cart-price-rules.

[rulehub] List cart validation rules (checkout constraints). RuleHub GET /cart-validation-rules.

Remove a single item from a cart by cart-item ID.

Update quantity or price on an existing cart line via PATCH /cart-items/{id}.

[eventhub] Create a webhook subscription. EventHub POST /event-subscriptions. Pass the full API body (name, event_slug, target_url, payload_includes, conditions, …).

[eventhub] Get a single delivery attempt with request/response details. EventHub GET /event-delivery-logs/{id}.

[eventhub] Get a webhook subscription by ID. EventHub GET /event-subscriptions/{id}.

[eventhub] List webhook delivery attempts (audit log). EventHub GET /event-delivery-logs.

[eventhub] List webhook subscriptions with pagination. EventHub GET /event-subscriptions.

[eventhub] Update a webhook subscription by ID. EventHub PUT /event-subscriptions/{id}.

Create a billing address for a customer. Country accepts ISO-2 (e.g. "DE") or full name (e.g. "Germany") — both are normalised automatically.

[b2b] Delete a billing address by ID.

List all available payment / billing methods. Call this before checkout to retrieve valid method IDs required for the checkout call.

[b2b] Update a customer billing address by ID.

[catalog] Create a product brand/manufacturer. Brands are stored as attribute values on the Brand/Manufacturer attribute (AttributesHub). Names should be unique. Call list_brands first to avoid duplicates. Returns { id, name, slug, ... } where id is the attribute_value id for use as brand_id on create_product.

[catalog] Delete a brand (attribute value). Fails with 409 if products still use it unless force=true.

[catalog] Get a brand by id (attribute_value id).

[catalog] Update a brand by attribute_value id (brand id from create_brand / list_brands).

[catalog] Create a B2Bware product category. Call list_categories first to obtain parent_id values for subcategories. Use for demo catalog provisioning.

[catalog] Delete a category by ID. May fail if products are still assigned.

Get a single B2Bware category by ID.

[catalog] Update a category by ID (partial fields).

[notification] Create a notification in NotificationHub. Requires notification_type_id (from list_notification_types), notifiable target, title, message. Channels: email, database, broadcast, sms, push, slack.

[notification] Get a single notification by ID from NotificationHub.

[notification] Aggregate notification statistics from GET /notifications/stats.

[notification] List notification types (templates, channels, slugs) from GET /types.

Create a shipping address for a customer. Country accepts ISO-2 (e.g. "AT") or full name (e.g. "Austria") — both are normalised automatically.

[b2b] Delete a shipping address by ID.

List all available shipping methods. Call this before checkout to retrieve valid method IDs required for the checkout call.

[b2b] Update a customer shipping address by ID.

[automation] Create a new automation flow. POST /flows. Pass the full flow payload as body (trigger, actions, conditions, name, etc.). Call list_available_automation_triggers and list_available_automation_actions first.

[automation] Get a single automation flow by ID. GET /flows/{id}.

[automation] List automation flows (paginated). GET /api/v1/apps/automation-hub/flows. Filter by name or status when supported.

[automation] List actions available for flow steps. GET /flows/available-actions/list (falls back to /available-actions/grouped).

[automation] List triggers available for new flows (discovered at runtime). GET /flows/available-triggers/list.

[eventhub] List event slugs available for webhook subscriptions. EventHub GET /event-subscriptions/available-events/list.

[rulehub] Create a coupon. RuleHub POST /coupons. Pass the full API body (code, cart_price_rule_ids, …).

[rulehub] Get a coupon by ID. RuleHub GET /coupons/{id}.

[rulehub] Update a coupon by ID. RuleHub PUT /coupons/{id}.

[attributes] Read attribute assignments for any entity scope.

[attributes] Remove one attribute from an entity by attribute_id.

[attributes] Assign attributes on any entity: product, category, order, customer, or company. For select/swatch use attribute_value_id (value is resolved automatically) or attribute_id + value. merge=true keeps other attributes on the entity.

[b2b] Alias for link_customer_to_company (spec-compatible name).

[catalog] Attach variation attributes to a configurable parent product. Required before generate_product_variations.

[customer] List B2B companies from CustomerHub (/companies). No separate CompanyHub. Use search_companies for multi-field lookup. Custom fields via set_company_attributes (AttributesHub company group).

[customer] Search companies by name, email, VAT number, or company_number (partial match, deduplicated). CustomerHub /companies endpoint.

List all B2Bware customers with pagination, sorting and filtering. Valid sort fields: id, -id, _created_at, -_created_at, email, first_name.

Search customers by name, email or customer number (partial match). Searches across email, first_name, last_name and customer_number simultaneously. For listing all customers use list_customers.

[dashboard] Get the current saved dashboard layout for the installation. GET /api/v1/apps/dashboard-hub/layout. Read-only.

[dashboard] List all widgets the current installation may render on the dashboard. GET /api/v1/apps/dashboard-hub/available-widgets. Read-only.

[automation] Get a single flow run by ID. GET /flow-runs/{id}.

[automation] List flow execution runs (paginated). GET /flow-runs. Filter by flow_id or status when needed.

[license] Generate license keys via POST /license-keys/generate. Template uses X as random placeholder (e.g. XXXX-XXXX-XXXX-XXXX). Max quantity 1000.

[catalog] Generate child variation products from a configurable parent (PUT /createVariations).

[license] Get a single license key by ID from LicenseHub.

[license] List license keys from LicenseHub (paginated, filterable). Statuses: available, assigned, activated, expired, revoked. Include usageLogs,pool,product,order.

[media] Get a single media record by ID from MediaHub.

[media] List media records from MediaHub. Filter by mediable_type, mediable_id, media_type, is_primary.

List B2Bware products with optional filters and pagination. Use this for full catalogue browsing — supports 23.000+ products via pagination. To browse products of a specific category, use search_products with the category name as query. Products of type 'configurable' are parent containers without prices and cannot be added to cart. Only 'simple' products are orderable. Use exclude_configurable=true to filter out non-orderable parent products.

Search B2Bware products by name, SKU, EAN/GTIN, or category name. Returns a merged, deduplicated list (max ~100 results). For full catalogue browsing or large result sets use list_products instead. Products of type 'configurable' are parent containers without prices and cannot be added to cart. Only 'simple' products are orderable. Use exclude_configurable=true to filter out non-orderable parent products.

[attributes] Queue background resync for one sortable/admin-filterable attribute. Returns 202 or 422 if flags not enabled.

[attributes] Queue background resync for all attributes with use_for_sorting or use_for_admin_filtering. Returns 202 Accepted.

[settings] Get a single configuration entry by ID. GET /config/{id}.

[settings] List platform configuration entries (paginated). GET /api/v1/apps/settings-hub/config. Filter by config_code (partial match).

Create or replace cart contents via PATCH /carts. Prefer add_cart_item for adding single lines (PATCH may accumulate quantities). Pass a stable session_uuid to update an existing cart. Returns the cart with its ID for checkout or admin review. Optionally pass 'price' per line item to override the catalogue price.

[catalog] Create or update a product by SKU (idempotent). Prefer for imports and MCP retries. Same fields as create_product.

[license] Activate a license key via POST /license-keys/{id}/activate.

[attributes] List attribute definitions. Filter by entity_scope or group_id. Product group includes Brand/Manufacturer and all catalog facets.

[catalog] List brands with pagination. Optional search matches brand name (partial). Filter is_active is applied client-side when stored in meta_data.

Calculate tax for line items given customer context (country, region, customer_group, vat_number). Uses TaxHub rule engine. Returns tax amounts per line and total. Useful before checkout or for quotes.

[orders-admin] Cancel an order (status → canceled). Optional reason stored as order comment.

List carts (open/abandoned carts for operator queries). Filter by customer_id. Use with list_orders (sort=-id) for recent purchases vs open carts.

List all B2Bware product categories.

Execute checkout on an existing cart and create an order. Requires a cart_id, shipping and billing address IDs, and method IDs. IMPORTANT: Before calling checkout, always fetch available shipping methods via list_shipping_methods and billing methods via list_billing_methods if the IDs are not already known. Both shipping_method_id AND billing_method_id are required for a successful checkout. Use list_customer_addresses to fetch existing addresses for a customer.

[settings] Clear application cache for a specific installation. DELETE /clearAppCache/{installation_key}. Requires admin/write scope.

[settings] List all countries with name, iso2, and iso3 codes. GET /api/v1/apps/settings-hub/countries.

[rulehub] List promotion coupons. RuleHub GET /coupons.

[settings] List all currencies (live rates from openexchangerates.org with fallback). GET /api/v1/apps/settings-hub/currencies.

[orders-admin] Deploy the built-in ProductHub demo catalog (categories + sample products). Use on empty demo instances only — may duplicate data if run twice.

[b2b] Alias for unlink_customer_from_company.

[b2b] Assign a customer to a company. Use list_roles for valid role_id values. Sets company_id (and optional role_id) on the customer record.

[settings] List all available locales from SettingsHub (e.g. en_US, de_DE). GET /api/v1/apps/settings-hub/locales.

Authenticate a customer with email and password. Returns a bearer token that can be used for subsequent requests.

[notification] List notifications from NotificationHub (paginated, filterable). Filter by status, priority, notifiable_type/id. Include notificationType,attempts,creator.

List B2Bware orders with optional filters, sorting, and pagination. Valid statuses: draft, pending, processing, completed, canceled, invoiced, shipped, paid, refunded, partially_refunded, pending_payment. Valid sort fields: id, -id, _created_at, -_created_at, total_price, -total_price, status, customer_id. Use sort='-id' or sort='-_created_at' to get the NEWEST order first. Date format: YYYY-MM-DD.

[eventhub] Pause a subscription (stop dispatching). EventHub POST /event-subscriptions/{id}/pause.

Preview checkout for a cart: returns calculated totals, shipping, and tax without completing the order. Use before calling checkout to show the customer the final amounts.

[media] Set a media record as primary for its parent via POST /media/{id}/primary.

Register a new customer account.

[eventhub] Resume a paused subscription. EventHub POST /event-subscriptions/{id}/resume.

[b2b] List customer roles (for link_customer_to_company role_id).

[rulehub] Get condition-builder schema for rule targets. RuleHub GET /conditions/schema or /conditions/schema/{target}. Targets: cart, catalog, shipping, validation.

[notification] Dispatch a created notification via POST /notifications/{id}/send.

[eventhub] Send a synthetic test delivery. EventHub POST /event-subscriptions/{id}/test.

[b2b] Remove a customer from their company (clears company_id).

[media] Upload or attach media via POST /media. Provide file (base64) for CDN ingest or media_url for URL reference. mediable_type examples: Products, Companies.

[license] Validate a license key via POST /license-keys/{id}/validate.