Kibo Commerce MCP Server

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, search orders, look up customer information, and check inventory levels 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.

Use Cases

The MCP Server supports common commerce operations:

Operation	Description
Product search	Query your catalog with filters for category, price, availability
Order lookup	Search orders by customer, status, date range
Customer data	Retrieve customer profiles and order history
Inventory checks	Check stock levels across locations

Prerequisites

Before configuring the MCP Server, ensure you have:

Node.js 18+ installed
Kibo Commerce tenant with API access
Application credentials (Client ID and Shared Secret) from Kibo Admin
Claude Desktop, Cursor, or another MCP-compatible client

Getting Your Credentials

Log into your Kibo Commerce Admin Console
Navigate to System > Applications
Create a new application or use an existing one
Note the following values:
- Application ID (Client ID)
- Shared Secret (Client Secret)
- Tenant ID
- Site ID
- API Host URL (e.g., https://t1000000.sb.usc1.gcp.kibocommerce.com)

Claude Desktop Configuration

Configuration File Location

Platform	Path
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:

{
  "mcpServers": {
    "kibo-commerce": {
      "command": "npx",
      "args": ["@kibocommerce/kibo-commerce-mcp"],
      "env": {
        "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "your_application_id",
        "KIBO_CLIENT_SECRET": "your_shared_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890"
      }
    }
  }
}

Replace the placeholder values with your actual credentials.

Multiple Environments

To connect to both sandbox and production environments:

{
  "mcpServers": {
    "kibo-production": {
      "command": "npx",
      "args": ["@kibocommerce/kibo-commerce-mcp"],
      "env": {
        "KIBO_API_HOST": "https://t1000000.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "prod_client_id",
        "KIBO_CLIENT_SECRET": "prod_client_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890"
      }
    },
    "kibo-sandbox": {
      "command": "npx",
      "args": ["@kibocommerce/kibo-commerce-mcp"],
      "env": {
        "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "sandbox_client_id",
        "KIBO_CLIENT_SECRET": "sandbox_client_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890"
      }
    }
  }
}

Cursor Configuration

Add the MCP server to your .cursor/mcp.json file:

{
  "mcpServers": {
    "kibo-commerce": {
      "command": "npx",
      "args": ["@kibocommerce/kibo-commerce-mcp"],
      "env": {
        "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "your_application_id",
        "KIBO_CLIENT_SECRET": "your_shared_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890"
      }
    }
  }
}

Windsurf Configuration

Add the following to your ~/.codeium/windsurf/mcp_config.json file:

{
  "mcpServers": {
    "kibo-commerce": {
      "command": "npx",
      "args": ["@kibocommerce/kibo-commerce-mcp"],
      "env": {
        "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "your_application_id",
        "KIBO_CLIENT_SECRET": "your_shared_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890"
      }
    }
  }
}

VS Code with GitHub Copilot

Add the following to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "kibo-commerce": {
        "command": "npx",
        "args": ["@kibocommerce/kibo-commerce-mcp"],
        "env": {
          "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
          "KIBO_CLIENT_ID": "your_application_id",
          "KIBO_CLIENT_SECRET": "your_shared_secret",
          "KIBO_TENANT_ID": "1000000",
          "KIBO_SITE_ID": "67890"
        }
      }
    }
  }
}

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?

Available Tools

Product Operations

Tool	Description
`kibo_product_search`	Search products with filtering, pagination, and sorting
`kibo_product_details`	Get detailed product information including variations and pricing
`kibo_category_list`	Retrieve product categories and category tree

Order Operations

Tool	Description
`kibo_order_search`	Search orders by customer, status, or date range
`kibo_order_details`	Get complete order information including items and payments
`kibo_order_status_update`	Update order status with optional notes

Customer Operations

Tool	Description
`kibo_customer_search`	Search customers by email, name, or status
`kibo_customer_details`	Get detailed customer profiles
`kibo_customer_order_history`	Retrieve customer order history

Inventory Operations

Tool	Description
`kibo_inventory_search`	Search inventory levels across products and locations
`kibo_inventory_details`	Get detailed inventory with transaction history
`kibo_stock_availability`	Check stock availability for multiple products

Environment Variables

Variable	Required	Description
`KIBO_API_HOST`	Yes	Your Kibo API host URL
`KIBO_CLIENT_ID`	Yes	Application ID from Kibo Admin
`KIBO_CLIENT_SECRET`	Yes	Shared Secret from Kibo Admin
`KIBO_TENANT_ID`	Yes	Your Kibo tenant ID
`KIBO_SITE_ID`	Yes	Target site ID
`KIBO_MASTER_CATALOG_ID`	No	Master catalog ID (defaults to 1)
`KIBO_LOCALE`	No	Locale code (defaults to en-US)
`KIBO_CURRENCY`	No	Currency code (defaults to USD)
`MCP_LOG_LEVEL`	No	Log level: debug, info, warn, error

Troubleshooting

Authentication Errors

401 Unauthorized

Verify Client ID and Client Secret are correct
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

Debug Mode

Enable detailed logging by adding MCP_LOG_LEVEL to your configuration:

{
  "mcpServers": {
    "kibo-commerce": {
      "command": "npx",
      "args": ["@kibocommerce/kibo-commerce-mcp"],
      "env": {
        "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "your_application_id",
        "KIBO_CLIENT_SECRET": "your_shared_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890",
        "MCP_LOG_LEVEL": "debug"
      }
    }
  }
}

Alternative Installation Methods

Global NPM Install

npm install -g @kibocommerce/kibo-commerce-mcp

Then use kibo-commerce-mcp as the command instead of npx:

{
  "mcpServers": {
    "kibo-commerce": {
      "command": "kibo-commerce-mcp",
      "env": {
        "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "your_application_id",
        "KIBO_CLIENT_SECRET": "your_shared_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890"
      }
    }
  }
}

Local Development

Clone and build from source:

git clone https://github.com/KiboSoftware/kibo-commerce-mcp.git
cd kibo-commerce-mcp
npm install
npm run build

Then reference the built output:

{
  "mcpServers": {
    "kibo-commerce": {
      "command": "node",
      "args": ["/path/to/kibo-commerce-mcp/dist/index.js"],
      "env": {
        "KIBO_API_HOST": "https://t1000000.sb.usc1.gcp.kibocommerce.com",
        "KIBO_CLIENT_ID": "your_application_id",
        "KIBO_CLIENT_SECRET": "your_shared_secret",
        "KIBO_TENANT_ID": "1000000",
        "KIBO_SITE_ID": "67890"
      }
    }
  }
}

Developers

API reference

AI Tools

Use Cases

Prerequisites

Getting Your Credentials

Claude Desktop Configuration

Configuration File Location

Basic Configuration

Multiple Environments

Cursor Configuration

Windsurf Configuration

VS Code with GitHub Copilot

Testing the Connection

Available Tools

Product Operations

Order Operations

Customer Operations

Inventory Operations

Environment Variables

Troubleshooting

Authentication Errors

Network Errors

Missing Data

Debug Mode

Alternative Installation Methods

Global NPM Install

Local Development

Resources

Developers

API reference

AI Tools

​Use Cases

​Prerequisites

​Getting Your Credentials

​Claude Desktop Configuration

​Configuration File Location

​Basic Configuration

​Multiple Environments

​Cursor Configuration

​Windsurf Configuration

​VS Code with GitHub Copilot

​Testing the Connection

​Available Tools

​Product Operations

​Order Operations

​Customer Operations

​Inventory Operations

​Environment Variables

​Troubleshooting

​Authentication Errors

​Network Errors

​Missing Data

​Debug Mode

​Alternative Installation Methods

​Global NPM Install

​Local Development

​Resources

Use Cases

Prerequisites

Getting Your Credentials

Claude Desktop Configuration

Configuration File Location

Basic Configuration

Multiple Environments

Cursor Configuration

Windsurf Configuration

VS Code with GitHub Copilot

Testing the Connection

Available Tools

Product Operations

Order Operations

Customer Operations

Inventory Operations

Environment Variables

Troubleshooting

Authentication Errors

Network Errors

Missing Data

Debug Mode

Alternative Installation Methods

Global NPM Install

Local Development

Resources