MCP.so
ログイン

Syncspider B2bware Mcp

@SyncSpider-GmbH

リポジトリ

Syncspider B2bware Mcp について

B2Bware MCP server that connects MCP-compatible AI clients to the B2Bware Datahub API. Supports product search/listing, customer lookup, cart upsert with optional custom line-item pricing, robust order sorting (e.g. -id, -_created_at), and checkout with explicit shipping/billing

#b2bware#mcp#ecommerce#orders#products#customers#cart#checkout

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

SyncSpider-GmbH

投稿者

nnpro

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "b2bware": {
      "url": "https://mcp.b2bware.com/mcp",
      "headers": {
        "Authorization": "Bearer <B2BWARE_API_KEY>"
      }
    }
  }
}

ツール

25

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: pending, processing, completed, cancelled. 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: pending, processing, completed, cancelled.

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.

Create or update a shopping cart. Pass a stable session_uuid to update an existing cart. Returns the cart with its ID for use in checkout. Optionally pass 'price' per line item to override the catalogue price (e.g. for customer-specific pricing or discounts).

Retrieve the current cart contents for a session. Filters by session_uuid client-side.

List all carts, optionally filtered by customer ID.

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.

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, etc.).

List all shipping and billing addresses for a customer.

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.

概要

What is Syncspider B2bware Mcp?

Syncspider B2bware Mcp connects MCP-compatible AI clients (Claude, Cursor, Windsurf, Continue, and others) directly to the B2Bware Datahub API, enabling AI agents to work with real B2B ecommerce data and workflows in a structured, tool-based way.

How to use Syncspider B2bware Mcp?

Use the hosted endpoint at https://mcp.b2bware.com/mcp (streamable HTTP) or https://mcp.b2bware.com/sse (legacy SSE) with an Authorization: Bearer <B2BWARE_API_KEY> header, or run locally with npx -y b2bware-mcp@latest and set the B2BWARE_API_KEY environment variable (optional: B2BWARE_LANGUAGE, B2BWARE_BASE_URL).

Key features of Syncspider B2bware Mcp

  • Search products by name, SKU, EAN/GTIN, or category
  • List, filter, sort, and update orders
  • Create/update carts with stable sessions and optional custom pricing
  • Search, list, create, and update customers and addresses
  • Customer login and registration for token-based user context
  • Checkout requires explicit IDs for addresses and shipping/billing methods

Use cases of Syncspider B2bware Mcp

  • Find orderable products for a search query and exclude configurable parents
  • Create or update a cart for a customer with a custom negotiated item price
  • Get the latest order reliably using sort='-id' with per_page=1
  • Prepare checkout by first fetching valid addresses and shipping/billing methods

FAQ from Syncspider B2bware Mcp

What runtime or dependencies does it require?

It runs on Node.js and is invoked via npx. No additional runtime dependencies are mentioned beyond an MCP-compatible client (e.g., Claude, Cursor, Windsurf, Continue).

Where does data live and how is it accessed?

Data resides in the B2Bware Datahub. The server connects to it through the B2Bware API using a bearer token (B2BWARE_API_KEY).

What transports and authentication methods are supported?

It supports streamable HTTP and legacy SSE transports. Authentication is via an Authorization: Bearer header using a B2Bware API key.

Are there any known limits or guardrails?

The server includes explicit tool descriptions, required checkout fields, fallback sorting logic, and guidance to filter configurable products. No hard limits (e.g., rate limits, page size caps) are stated.

How does it differ from writing custom integration code?

It provides a unified MCP interface for products, orders, customers, carts, and auth, avoiding the need to write custom integration code in each AI client.

コメント

「その他」の他のコンテンツ

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Servers

modelcontextprotocol

Model Context Protocol Servers

88.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K