com.b2bware/mcp-server
com.b2bware/mcp-serverB2Bware MCP server — access products, orders and customers from Cursor, Claude, Windsurf and more.
Tools · 163
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. Pr…
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_produ…
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_paym…
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 car…
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 meth…
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 duplic…
[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…
[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 …
[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=…
[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] Alias: remove_entity_attribute for products.
[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_custom…
[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_automa…
[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, pus…
[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.
Similar MCP servers embedding-nearest
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"com.b2bware/mcp-server": {
"url": "https://mcp.b2bware.com/mcp",
"transport": "streamable-http"
}
}
}