com.b2bware/mcp-server

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.

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.

Get full details of a single B2Bware product by ID.

List all B2Bware product categories.

Get a single B2Bware category by ID.

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.

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

Get full details of a single order including line items.

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

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

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.

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.

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.

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.

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

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

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

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.

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.

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.

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

Create a new customer account in B2Bware.

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

List all shipping and billing addresses for a customer.

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

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

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

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

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

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

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

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

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

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

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

Register a new customer account.

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

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

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

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

[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] Update a product by ID (partial fields). Supports price, stock, categories, media URLs.

[catalog] Delete a product by ID.

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

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

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

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

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

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

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

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

[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] Update a brand by attribute_value id (brand id from create_brand / list_brands).

[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] List brands with pagination. Optional search matches brand name (partial). Filter is_active is applied client-side when stored in meta_data.

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

[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] Update an attribute definition by id. All storefront/admin flags from create are supported.

[attributes] Delete an attribute definition by id.

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

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

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

[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] 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] Update an attribute value by id.

[attributes] Delete an attribute value by id.

[attributes] Get a single attribute value by id.

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

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

[attributes] Update an attribute group.

[attributes] Delete an attribute group by id.

[attributes] Get an attribute group by id.

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

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

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

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

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

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

[attributes] Read attribute assignments for any entity scope.

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

[attributes] Alias: set_entity_attributes with entity_scope=product.

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

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

[attributes] Read custom attributes on a company.

[attributes] Remove one attribute from a company.

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

[attributes] Read attributes on a customer.

[attributes] Remove one attribute from a customer.

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

[attributes] Read attributes on an order.

[attributes] Remove one attribute from an order.

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

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

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

[b2b] Alias for unlink_customer_from_company.

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

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

[b2b] Update a customer shipping address by ID.

[b2b] Update a customer billing address by ID.

[b2b] Delete a shipping address by ID.

[b2b] Delete a billing address by ID.

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

[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] Create up to 100 orders (partial success). Each item uses the same fields as create_order.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[automation] Get a single flow run by ID. GET /flow-runs/{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.

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

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

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

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

[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] Dispatch a created notification via POST /notifications/{id}/send.

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

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

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

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

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

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

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

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

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

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

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

[attributes] Alias: remove_entity_attribute for products.