Spurtcommerce MCP Server

This project implements a Model Context Protocol (MCP) server that interacts with Spurtcommerce.
The protocol supports various tools to interact with Spurtcommerce APIs for product search and category browsing.

At the moment, the following APIs are supported:

• Product API
• Store API
• Categories API

---

Setup

Run from npm package (recommended for production)

To run the Spurtcommerce MCP server using npx, use the following command:

npx -y @spurtcommerce/mcp@latest

Run from local build (for development)

If you are working on the MCP server locally, you can run it by setting the MCP_SERVER_PATH environment variable to the absolute path of your built server file:

export MCP_SERVER_PATH="/absolute/path/to/build/index.js"

If MCP_SERVER_PATH is not set or is empty, the client will fall back to:

npx @spurtcommerce/mcp@latest

---

Usage with Cursor or Claude Desktop

Add the following configuration to your settings.json.
For more information, read the Cursor MCP documentation or the Claude Desktop MCP guide.

{
  "mcpServers": {
    "spurtcommerce-mcp": {
      "command": "npx",
      "args": ["-y", "@spurtcommerce/mcp@latest"],
      "env": {
        "SPURTCOMMERCE_API_URL": "https://your_backend/api",
        "SPURTCOMMERECE_API_KEY": "your_api_key_here"
      }
    }
  }
}

---

Windows Configuration

On Windows, you may need this alternative setup:

{
  "mcpServers": {
    "spurtcommerce-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@spurtcommerce/mcp@latest"],
      "env": {
        "SPURTCOMMERCE_API_URL": "https://your_backend/api",
        "SPURTCOMMERECE_API_KEY": "your_api_key_here"
      }
    }
  }
}

---

Environment Variables

---

Available Tools

This MCP server provides the following tools:

---

Tool Usage Guidelines

• get_product_by_sku → Use when you know the SKU and want full product details.
• get_all_category → Use when you need a list of categories for navigation or filtering.
• search_products → Use when searching products by name, category, or other filters.

---

Available Prompts