- Syncspider B2bware Mcp
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
priceincart_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:
-
Order sorting robustness
- Supports
sort="-id"andsort="-_created_at"for newest-first retrieval - Includes fallback behavior to keep sorting reliable even when upstream sorting is inconsistent
- Supports
-
Custom line-item pricing
upsert_cartsupports optionalpriceper cart item for negotiated pricing or discounts
-
Configurable product guidance
- Clarifies that
configurableproducts are parent containers (not directly orderable) - Encourages filtering to orderable
simpleproducts usingexclude_configurable=true
- Clarifies that
-
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.
Server Config
{
"mcpServers": {
"b2bware": {
"url": "https://mcp.b2bware.com/mcp",
"headers": {
"Authorization": "Bearer <B2BWARE_API_KEY>"
}
}
}
}