Skip to main content
The Kibo Commerce MCP Server enables AI agents to securely access your live commerce data through the Model Context Protocol (MCP). MCP is an open standard that allows AI applications to connect to external data sources and tools through a unified interface. With the Kibo MCP Server, AI assistants like Claude Desktop, Cursor, Windsurf, or VS Code with GitHub Copilot can query your product catalog, manage orders, look up customer information, configure shipping, adjust site settings, and much more — directly from your Kibo Commerce tenant. All requests are authenticated through your existing Kibo API credentials, and data access follows your tenant’s permission model.
Looking for documentation access? This page covers the Commerce MCP Server for accessing your catalog, orders, and inventory data. If you want AI tools to access Kibo documentation, see Using Kibo Documentation with AI for the Documentation MCP Server.

Prerequisites

Before configuring the MCP Server, ensure you have:
  • Kibo Commerce tenant with API access
  • Application credentials (Application Key and Client Secret) from Kibo Dev Center
  • Claude Desktop, Cursor, or another MCP-compatible client
  • Node.js 18+ (only required if using the MCP Inspector for debugging)

Getting Your Credentials

  1. Log into your Kibo Commerce Admin Console
  2. Navigate to System > Applications
  3. Create a new application or use an existing one
  4. Note the following values:
    • Application Key (also called Client ID)
    • Client Secret
    • Tenant ID
    • Site ID (if needed for site-scoped operations)
    • API Host URL (e.g., https://t1000000.sb.usc1.gcp.kibocommerce.com)

MCP Server URL

The Kibo MCP Server is a hosted HTTP endpoint available on your Kibo Commerce tenant. The endpoint URL follows this pattern:
https://{host}/mcp/admin/{toolCategories?}

With Tenant + Site ID

Include both the tenant and site identifiers when you need site-scoped operations:
https://t1000000-s12345.sb.usc1.gcp.kibocommerce.com/mcp/admin/
URL PartMeaning
t1000000Tenant ID
s12345Site ID

With Tenant Only

Omit the site identifier for tenant-level operations:
https://t1000000.sb.usc1.gcp.kibocommerce.com/mcp/admin/
Some API operations require a site context. If a tool call fails with a missing site error, switch to the tenant + site URL format.

Authorization Methods

Every request to the MCP endpoint must include an Authorization header. The server supports two methods.

Method 1: Basic Authentication (Base64-Encoded Credentials)

Use your Application Key and Client Secret, separated by a colon and Base64-encoded, in a standard HTTP Basic auth header. Steps:
  1. Obtain your Application Key and Client Secret from the Kibo Dev Center.
  2. Concatenate them with a colon separator:
    {applicationKey}:{clientSecret}
    
  3. Base64-encode the result.
  4. Send the encoded value in the Authorization header with the Basic scheme.
Example:
Application Key: my_app_key
Client Secret:   my_client_secret
# Encode
echo -n "my_app_key:my_client_secret" | base64
# Result: bXlfYXBwX2tleTpteV9jbGllbnRfc2VjcmV0
Authorization: Basic bXlfYXBwX2tleTpteV9jbGllbnRfc2VjcmV0

Method 2: JWT Bearer Token (Kibo API Auth)

This is the standard Kibo API authentication flow. You exchange your Application Key and Client Secret for a short-lived JWT access token using the Kibo OAuth endpoint, then pass that token as a Bearer credential. Steps:
  1. Request an access token from the Kibo authentication endpoint:
    POST https://home.kibocommerce.com/api/platform/applications/authtickets/oauth
    
    With the request body:
    {
      "client_id": "{applicationKey}",
      "client_secret": "{clientSecret}",
      "grant_type": "client_credentials"
    }
    
  2. Extract the access_token from the response.
  3. Send the token in the Authorization header with the Bearer scheme.
Example:
# 1. Obtain token
curl -X POST https://home.kibocommerce.com/api/platform/applications/authtickets/oauth \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "my_app_key",
    "client_secret": "my_client_secret",
    "grant_type": "client_credentials"
  }'
{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "bearer",
  "expires_in": 3600
}
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Bearer tokens expire (typically in 1 hour). Your MCP client should handle token refresh automatically or re-authenticate when a 401 response is received.

Client Configuration

Configure your MCP client to connect to the Kibo MCP Server hosted endpoint.

Claude Desktop

Configuration File Location

PlatformPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

Basic Configuration

Add the following to your claude_desktop_config.json, replacing the URL and authorization value with your own:
{
  "mcpServers": {
    "kibo-commerce": {
      "url": "https://t1000000-s12345.sb.usc1.gcp.kibocommerce.com/mcp/admin/",
      "headers": {
        "Authorization": "Basic bXlfYXBwX2tleTpteV9jbGllbnRfc2VjcmV0"
      }
    }
  }
}

Multiple Environments

To connect to both sandbox and production environments:
{
  "mcpServers": {
    "kibo-production": {
      "url": "https://t1000000-s12345.usc1.gcp.kibocommerce.com/mcp/admin/",
      "headers": {
        "Authorization": "Basic cHJvZF9rZXk6cHJvZF9zZWNyZXQ="
      }
    },
    "kibo-sandbox": {
      "url": "https://t1000000-s12345.sb.usc1.gcp.kibocommerce.com/mcp/admin/",
      "headers": {
        "Authorization": "Basic c2FuZGJveF9rZXk6c2FuZGJveF9zZWNyZXQ="
      }
    }
  }
}

Cursor

Add the MCP server to your .cursor/mcp.json file:
{
  "mcpServers": {
    "kibo-commerce": {
      "url": "https://t1000000-s12345.sb.usc1.gcp.kibocommerce.com/mcp/admin/",
      "headers": {
        "Authorization": "Basic bXlfYXBwX2tleTpteV9jbGllbnRfc2VjcmV0"
      }
    }
  }
}

Windsurf

Add the following to your ~/.codeium/windsurf/mcp_config.json file:
{
  "mcpServers": {
    "kibo-commerce": {
      "url": "https://t1000000-s12345.sb.usc1.gcp.kibocommerce.com/mcp/admin/",
      "headers": {
        "Authorization": "Basic bXlfYXBwX2tleTpteV9jbGllbnRfc2VjcmV0"
      }
    }
  }
}

VS Code with GitHub Copilot

Add the following to your VS Code settings.json:
{
  "mcp": {
    "servers": {
      "kibo-commerce": {
        "url": "https://t1000000-s12345.sb.usc1.gcp.kibocommerce.com/mcp/admin/",
        "headers": {
          "Authorization": "Basic bXlfYXBwX2tleTpteV9jbGllbnRfc2VjcmV0"
        }
      }
    }
  }
}

Filtering Tools by Category

By default, connecting to /mcp/admin/ exposes all registered tools (500+ operations). You can limit the tools returned to your MCP client by appending a comma-separated list of category names to the URL path.

Single Category

https://t1000000.sb.usc1.gcp.kibocommerce.com/mcp/admin/categories.read
Returns only the tools in the categories.read category.

Multiple Categories

https://t1000000.sb.usc1.gcp.kibocommerce.com/mcp/admin/categories.read,categories.update
Returns tools from both categories.read and categories.update.

All Tools (Default)

https://t1000000.sb.usc1.gcp.kibocommerce.com/mcp/admin/
Returns every tool across all categories.
Request only the categories you need. Fewer tools means faster discovery for your AI assistant and lower token usage when the tool list is sent as context.

Testing the Connection

After configuration, restart your AI client and test with a query:
Search for products containing "shirt"
To verify the tools are loaded:
What Kibo Commerce tools are available?

Using the MCP Inspector

The MCP Inspector is a visual debugging tool for interacting with MCP servers. It lets you discover tools, execute them, and inspect the request/response cycle.

Quick Start

  1. Launch the inspector against your Kibo MCP Server:
    npx @modelcontextprotocol/inspector --url https://t1000000.sb.usc1.gcp.kibocommerce.com/mcp/admin/
    
    # Or with specific categories
    npx @modelcontextprotocol/inspector --url https://t1000000.sb.usc1.gcp.kibocommerce.com/mcp/admin/products.read,categories.read
    
  2. The inspector UI will open in your browser. From there you can:
    • List Tools — view all tools exposed by the server
    • Call a Tool — fill in parameters and execute a tool call
    • View Responses — inspect the raw JSON returned by each tool

Configuring the URL

Enter your Kibo MCP Server URL in the inspector’s URL field:
MCP Inspector URL configuration

Adding Authorization

Provide the Authorization header in the inspector’s Headers configuration section before initializing the session. Enter the header exactly as you would in an HTTP request:
Authorization: Basic bXlfYXBwX2tleTpteV9jbGllbnRfc2VjcmV0
or
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
MCP Inspector authorization configuration

Listing Tools

Once connected, use the List Tools button to see all available tools for the configured categories:
MCP Inspector tool list

Available Tool Categories

Categories follow the naming convention {resource}.{operation}, where operation is one of create, read, update, or delete.

Commerce Runtime

CategoryDescription
cart.createAdd items to carts, create carts
cart.deleteRemove cart items, coupons, messages
cart.readGet carts, cart items, summaries
cart.updateUpdate carts, apply coupons, modify items
channel.createCreate channels
channel.deleteDelete channels
channel.readGet channels
channel.updateUpdate channels
channelgroup.createCreate channel groups
channelgroup.deleteDelete channel groups
channelgroup.readGet channel groups
channelgroup.updateUpdate channel groups
checkout.createCreate checkouts, perform checkout actions
checkout.deleteRemove checkout items, coupons
checkout.readGet checkouts, checkout items
checkout.updateUpdate checkouts, set shipping/billing
job.createCreate jobs
order.createCreate orders, add order items
order.deleteRemove order items, adjustments
order.readGet orders, order items, shipments
order.updateUpdate orders, fulfillment, payments
orderattributedefinitions.createCreate order attribute definitions
orderattributedefinitions.readGet order attribute definitions
orderattributedefinitions.updateUpdate order attribute definitions
ordervalidationcapability.createCreate order validation capabilities
quote.createCreate quotes
quote.deleteDelete quotes
quote.readGet quotes
quote.updateUpdate quotes
return.createCreate returns
return.deleteDelete returns
return.readGet returns, return items
return.updateUpdate returns
returnattributedefinitions.createCreate return attribute definitions
returnattributedefinitions.readGet return attribute definitions
returnattributedefinitions.updateUpdate return attribute definitions
wishlist.createCreate wishlists
wishlist.deleteDelete wishlists
wishlist.readGet wishlists
wishlist.updateUpdate wishlists

Customer

CategoryDescription
accountrankingrule.createCreate account ranking rules
accountrankingrule.deleteDelete account ranking rules
accountrankingrule.readGet account ranking rules
accountrankingrule.updateUpdate account ranking rules
addressvalidation.createValidate addresses
addressvalidationcapability.createCreate address validation capabilities
authticket.createCreate auth tickets
authticket.readGet auth tickets
authticket.updateUpdate auth tickets
b2baccount.createCreate B2B accounts
b2baccount.deleteDelete B2B accounts
b2baccount.readGet B2B accounts
b2baccount.updateUpdate B2B accounts
b2bcontact.readGet B2B contacts
credit.createCreate credits
credit.deleteDelete credits
credit.readGet credits
credit.updateUpdate credits
customeraccount.createCreate customer accounts
customeraccount.deleteDelete customer accounts
customeraccount.readGet customer accounts
customeraccount.updateUpdate customer accounts
customeraccountattributedefinitions.createCreate customer account attribute definitions
customeraccountattributedefinitions.readGet customer account attribute definitions
customeraccountattributedefinitions.updateUpdate customer account attribute definitions
customerattributedefinition.createCreate customer attribute definitions
customerattributedefinition.readGet customer attribute definitions
customerattributedefinition.updateUpdate customer attribute definitions
customersegment.createCreate customer segments
customersegment.deleteDelete customer segments
customersegment.readGet customer segments
customersegment.updateUpdate customer segments
customerset.readGet customer sets
customervisit.createCreate customer visits
customervisit.readGet customer visits
customervisit.updateUpdate customer visits
instocknotificationsubscription.createCreate in-stock notification subscriptions
instocknotificationsubscription.deleteDelete in-stock notification subscriptions
instocknotificationsubscription.readGet in-stock notification subscriptions

Import / Export

CategoryDescription
batchjob.createCreate batch jobs
batchjob.deleteDelete batch jobs
batchjob.readGet batch jobs
batchjob.updateUpdate batch jobs
export.createCreate exports
export.deleteDelete exports
export.readGet exports
files.createUpload files
files.readGet files
import.createCreate imports
import.deleteDelete imports
import.readGet imports

Location

CategoryDescription
location.readGet locations (storefront and admin)
locationadmin.createCreate locations
locationadmin.deleteDelete locations
locationadmin.readGet location admin details
locationadmin.updateUpdate locations
locationattributedefinitions.createCreate location attribute definitions
locationattributedefinitions.readGet location attribute definitions
locationattributedefinitions.updateUpdate location attribute definitions
locationgroup.createCreate location groups
locationgroup.deleteDelete location groups
locationgroup.readGet location groups
locationgroup.updateUpdate location groups
locationgroupconfiguration.readGet location group configurations
locationgroupconfiguration.updateUpdate location group configurations
locationinventoryattributedefinition.createCreate location inventory attribute definitions
locationinventoryattributedefinition.readGet location inventory attribute definitions
locationinventoryattributedefinition.updateUpdate location inventory attribute definitions
locationsettings.readGet location settings
locationsettings.updateUpdate location settings
locationtype.createCreate location types
locationtype.deleteDelete location types
locationtype.readGet location types
locationtype.updateUpdate location types
transfertimes.createCreate transfer times
transfertimes.deleteDelete transfer times
transfertimes.readGet transfer times
transfertimes.updateUpdate transfer times
vendor.createCreate vendors
vendor.deleteDelete vendors
vendor.readGet vendors
vendor.updateUpdate vendors

Pricing Runtime

CategoryDescription
discounts.createEvaluate discounts
discounts.readGet discounts
products.createPrice products
products.readGet product prices
taxes.createCalculate taxes

Product Admin

CategoryDescription
categories.createCreate categories
categories.deleteDelete categories
categories.readGet categories
categories.updateUpdate categories
categoryattributedefinition.createCreate category attribute definitions
categoryattributedefinition.readGet category attribute definitions
categoryattributedefinition.updateUpdate category attribute definitions
couponsets.createCreate coupon sets
couponsets.deleteDelete coupon sets
couponsets.readGet coupon sets
couponsets.updateUpdate coupon sets
currency.createCreate currencies
currency.deleteDelete currencies
currency.readGet currencies
currency.updateUpdate currencies
discounts.createCreate discounts
discounts.deleteDelete discounts
discounts.readGet discounts
discounts.updateUpdate discounts
discountsettings.readGet discount settings
discountsettings.updateUpdate discount settings
facets.createCreate facets
facets.deleteDelete facets
facets.readGet facets
facets.updateUpdate facets
mastercatalogpublishsettings.readGet master catalog publish settings
mastercatalogpublishsettings.updateUpdate master catalog publish settings
pickwaveruleevaluate.createEvaluate pick wave rules
pickwaverules.createCreate pick wave rules
pickwaverules.deleteDelete pick wave rules
pickwaverules.readGet pick wave rules
pickwaverules.updateUpdate pick wave rules
pricelistentries.createCreate price list entries
pricelistentries.deleteDelete price list entries
pricelistentries.readGet price list entries
pricelistentries.updateUpdate price list entries
pricelists.createCreate price lists
pricelists.deleteDelete price lists
pricelists.readGet price lists
pricelists.updateUpdate price lists
productattributes.createCreate product attributes
productattributes.deleteDelete product attributes
productattributes.readGet product attributes
productattributes.updateUpdate product attributes
productextras.createCreate product extras
productextras.deleteDelete product extras
productextras.readGet product extras
productextras.updateUpdate product extras
productoptions.createCreate product options
productoptions.deleteDelete product options
productoptions.readGet product options
productoptions.updateUpdate product options
productproperties.createCreate product properties
productproperties.deleteDelete product properties
productproperties.readGet product properties
productproperties.updateUpdate product properties
productpublishing.createPublish products
productpublishing.deleteDiscard product publishing drafts
productpublishing.readGet product publishing status
productquickedit.createQuick edit products
productrules.createCreate product rules
productrules.deleteDelete product rules
productrules.readGet product rules
productrules.updateUpdate product rules
productruleusages.readGet product rule usages
products.createCreate products
products.deleteDelete products
products.readGet products
products.updateUpdate products
productsortdefinitions.createCreate product sort definitions
productsortdefinitions.deleteDelete product sort definitions
productsortdefinitions.readGet product sort definitions
productsortdefinitions.updateUpdate product sort definitions
producttypes.createCreate product types
producttypes.deleteDelete product types
producttypes.readGet product types
producttypes.updateUpdate product types
productvariations.createCreate product variations
productvariations.deleteDelete product variations
productvariations.readGet product variations
productvariations.updateUpdate product variations
purchaselimitrules.createCreate purchase limit rules
purchaselimitrules.deleteDelete purchase limit rules
purchaselimitrules.readGet purchase limit rules
purchaselimitrules.updateUpdate purchase limit rules
returnrules.createCreate return rules
returnrules.deleteDelete return rules
returnrules.readGet return rules
returnrules.updateUpdate return rules
safetystockrules.createCreate safety stock rules
safetystockrules.deleteDelete safety stock rules
safetystockrules.readGet safety stock rules
safetystockrules.updateUpdate safety stock rules
searchcategorysuggestsettings.deleteDelete search category suggest settings
searchcategorysuggestsettings.readGet search category suggest settings
searchcategorysuggestsettings.updateUpdate search category suggest settings
searchlistingsettings.deleteDelete search listing settings
searchlistingsettings.readGet search listing settings
searchlistingsettings.updateUpdate search listing settings
searchmerchandizingrule.createCreate search merchandizing rules
searchmerchandizingrule.deleteDelete search merchandizing rules
searchmerchandizingrule.readGet search merchandizing rules
searchmerchandizingrule.updateUpdate search merchandizing rules
searchproductsuggestsettings.deleteDelete search product suggest settings
searchproductsuggestsettings.readGet search product suggest settings
searchproductsuggestsettings.updateUpdate search product suggest settings
searchredirect.createCreate search redirects
searchredirect.deleteDelete search redirects
searchredirect.readGet search redirects
searchredirect.updateUpdate search redirects
searchsettings.createCreate search settings
searchsettings.deleteDelete search settings
searchsettings.readGet search settings
searchsettings.updateUpdate search settings
searchsynonyms.createCreate search synonyms
searchsynonyms.deleteDelete search synonyms
searchsynonyms.readGet search synonyms
searchsynonyms.updateUpdate search synonyms
searchtuningrules.createCreate search tuning rules
searchtuningrules.deleteDelete search tuning rules
searchtuningrules.readGet search tuning rules
searchtuningrules.updateUpdate search tuning rules
shipmentrules.createCreate shipment rules
shipmentrules.deleteDelete shipment rules
shipmentrules.readGet shipment rules
shipmentrules.updateUpdate shipment rules
tag.createCreate tags
tag.deleteDelete tags
tag.readGet tags
tag.updateUpdate tags

Shipping Admin

CategoryDescription
carrierconfiguration.createCreate carrier configurations
carrierconfiguration.deleteDelete carrier configurations
carrierconfiguration.readGet carrier configurations
carrierconfiguration.updateUpdate carrier configurations
carrierconfigurationglobal.readGet global carrier configurations
carriercredential.createCreate carrier credentials
carriercredential.deleteDelete carrier credentials
carriercredential.readGet carrier credentials
carriercredential.updateUpdate carrier credentials
carriercredentialset.createCreate carrier credential sets
carriercredentialset.deleteDelete carrier credential sets
carriercredentialset.readGet carrier credential sets
carriercredentialset.updateUpdate carrier credential sets
carrierdefinition.readGet carrier definitions
shipmentattributedefinition.createCreate shipment attribute definitions
shipmentattributedefinition.readGet shipment attribute definitions
shipmentattributedefinition.updateUpdate shipment attribute definitions
shippingprofile.createCreate shipping profiles
shippingprofile.deleteDelete shipping profiles
shippingprofile.readGet shipping profiles
shippingprofile.updateUpdate shipping profiles
targetrules.createCreate target rules
targetrules.deleteDelete target rules
targetrules.readGet target rules
targetrules.updateUpdate target rules

Shipping Runtime

CategoryDescription
shipping.createCalculate shipping rates
shipping.readGet shipping information

Site Settings

CategoryDescription
cartsettings.createCreate cart settings
cartsettings.readGet cart settings
cartsettings.updateUpdate cart settings
checkoutsettings.deleteDelete checkout settings
checkoutsettings.readGet checkout settings
checkoutsettings.updateUpdate checkout settings
fulfillmentsettings.createCreate fulfillment settings
fulfillmentsettings.readGet fulfillment settings
fulfillmentsettings.updateUpdate fulfillment settings
generalsettings.createCreate general settings
generalsettings.deleteDelete general settings
generalsettings.readGet general settings
generalsettings.updateUpdate general settings
inventorysettings.createCreate inventory settings
inventorysettings.readGet inventory settings
inventorysettings.updateUpdate inventory settings
returnsettings.createCreate return settings
returnsettings.readGet return settings
returnsettings.updateUpdate return settings
shippingsettings.createCreate shipping settings
shippingsettings.readGet shipping settings
shippingsettings.updateUpdate shipping settings
subscriptionsettings.createCreate subscription settings
subscriptionsettings.readGet subscription settings
subscriptionsettings.updateUpdate subscription settings

Subscription

CategoryDescription
subscription.createCreate subscriptions
subscription.deleteDelete subscriptions
subscription.readGet subscriptions
subscription.updateUpdate subscriptions

Troubleshooting

Authentication Errors

401 Unauthorized
  • Verify your Application Key and Client Secret are correct
  • If using Basic auth, check that the Base64 encoding is correct
  • If using Bearer tokens, the token may have expired — request a new one
  • Check that the application has required API permissions in Kibo Admin
  • Confirm Tenant ID and Site ID match your environment
403 Forbidden
  • Verify your application has access to the requested resources
  • Check that your Site ID is correct for the operation

Network Errors

Connection Timeout
  • Check your internet connection
  • Verify the API Host URL is accessible
  • Check firewall or proxy settings

Missing Data

Empty Results
  • Verify data exists in your Kibo Commerce tenant
  • Check that you are querying the correct site and catalog
  • Try different search parameters
  • If the error mentions a missing site context, switch to the tenant + site URL format

Resources