Syncspider B2bware Mcp

SyncSpider B2Bware MCP Server

The B2Bware MCP Server connects MCP-compatible AI clients (Claude, Cursor, Windsurf, Continue, and others) directly to the B2Bware Datahub API.

It enables AI agents to work with real B2B ecommerce data and workflows in a structured, tool-based way: product discovery, customer lookup, cart management, order retrieval, and checkout preparation.

Why this server is useful

This server is designed for teams that want reliable AI-assisted commerce operations without custom integration code in every client.

It provides:

• A unified MCP interface for products, orders, customers, carts, and auth
• Compatibility with both local MCP clients (npx) and hosted remote MCP endpoints
• Practical guardrails for common ecommerce pitfalls (sorting, configurable products, checkout prerequisites)
• Better agent reliability through explicit tool descriptions and required checkout fields

Core capabilities

Product Hub

• Search products by name, SKU, EAN/GTIN, or category (search_products)
• List and paginate large catalogs (list_products)
• Fetch product/category details (get_product, list_categories, get_category)

Order Hub

• List/filter/sort orders (list_orders)
• Get full order details (get_order)
• Update order status (update_order_status)
• List shipping and billing methods (list_shipping_methods, list_billing_methods)

Cart + Checkout

• Create/update carts with stable sessions (upsert_cart)
• Retrieve cart by session (get_cart)
• Optional custom line-item pricing via price in cart_items
• Checkout with explicit required IDs (cart, addresses, shipping method, billing method)

Customer Hub

• Search/list/get customers
• Create/update customers
• List and create shipping/billing addresses

Auth Hub

• Customer login and registration flows for token-based user context

Reliability improvements included

This server includes practical improvements to reduce agent mistakes and failed flows:

1. Order sorting robustness

   • Supports sort="-id" and sort="-_created_at" for newest-first retrieval
   • Includes fallback behavior to keep sorting reliable even when upstream sorting is inconsistent

2. Custom line-item pricing

   • upsert_cart supports optional price per cart item for negotiated pricing or discounts

3. Configurable product guidance

   • Clarifies that configurable products are parent containers (not directly orderable)
   • Encourages filtering to orderable simple products using exclude_configurable=true

4. Checkout prerequisites made explicit

   • Checkout requires shipping/billing address IDs and shipping/billing method IDs
   • Tool guidance points agents to fetch these IDs first (list_customer_addresses, list_shipping_methods, list_billing_methods)

Typical AI workflows

• “Find orderable products for query X and exclude configurable parents”
• “Create/update cart for customer Y with custom negotiated item price”
• “Get the latest order reliably (per_page=1, sort='-id')”
• “Prepare checkout by fetching valid addresses + shipping/billing methods first”

Integration options

Remote MCP (hosted)

Use the hosted endpoint:

• https://mcp.b2bware.com/mcp (streamable HTTP)
• https://mcp.b2bware.com/sse (legacy SSE)

Auth:

• Authorization: Bearer <B2BWARE_API_KEY>

Local MCP (npx)

Use:

• npx -y b2bware-mcp@latest

Environment:

• B2BWARE_API_KEY (required)
• B2BWARE_LANGUAGE (optional)
• B2BWARE_BASE_URL (optional)

Open source and maintenance

• Repository: https://github.com/SyncSpider-GmbH/b2bware-mcp
• License: MIT
• Maintainer: SyncSpider GmbH

The project is actively maintained with versioned releases and explicit server metadata for MCP ecosystem compatibility.