Bizzkit MCP server

Overview

The Bizzkit MCP (Model Context Protocol) server exposes AI Assistant capabilities to MCP-compliant clients.

For an introduction to the protocol, see the official MCP documentation.

Prerequisites

Your Ecommerce Search Host must have a scope named mcp (case-sensitive).

If the scope does not exist refer to the scopes documentation.

Without this scope, MCP server calls will fail.

API endpoint

The MCP client connects to:

1

GET https://baia-mcp.bizzk.cloud/{tenantId}/{segmentId}

Replace {tenantId} with your tenant identifier and {segmentId} with your segment identifier.

Tools

The server exposes a unified product search tool.

Product search tool

Name: search

Purpose: Perform a unified product search and return up to 5 matching products.

Input parameters:

• phrase (string, required): Search phrase

Behaviour:

• Returns top 5 products (server-side limit)
• Returns a products array of simplified product objects

Response schema

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
    "products": [
        {
            "title": "string",
            "description": "string",
            "imageUrl": "string",
            "price": 100
        }
    ]
}

Fields:

• title: Product display name
• description: Short description (may be null)
• imageUrl: First media resource URI from the product
• price: Unit price from the first SKU

Integration guides

How to add ECS search MCP server to GitHub Copilot

GitHub Copilot supports MCP servers through VS Code extensions and configuration.

Prerequisites:

• Visual Studio Code with GitHub Copilot extension installed
• Access to your tenant's MCP server endpoint
• Valid tenant ID and segment ID

Steps:

1. In the main search field, type > to open the command palette
2. Search for mcp and select MCP: List servers
3. Click Add server
4. Select HTTP and paste the address: https://baia-mcp.bizzk.cloud/{tenantId}/{segmentId}
5. Replace {tenantId} and {segmentId} with your actual values
6. Give your server a name and choose the scope
7. Restart VS Code or reload the window
8. GitHub Copilot can now access the search tool when you ask product-related questions

Example usage:

In your chat, you can ask:

"Use {name for your MCP server} to search for popcorn"

GitHub Copilot will use the MCP server to search your product catalog and return relevant results.

Example result: