com.b2bware/mcp-server

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

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.

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

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

[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).

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.

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.

[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.

[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.

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

[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] Create a B2Bware product category. Call list_categories first to obtain parent_id values for subcategories. Use for demo catalog provisioning.

[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).

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

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.

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

[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.

[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.

[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.

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

[attributes] Delete an attribute definition by id.

[attributes] Delete an attribute group by id.

[attributes] Delete an attribute value by id.

[b2b] Delete a billing address by ID.

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

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

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

[b2b] Delete a customer by ID.

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

[catalog] Delete a product by ID.

[b2b] Delete a shipping address by ID.

[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.