MCP by spurtcommerce - MCP Server

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

Variable	Description
`SPURTCOMMERCE_API_URL`	Base API URL for your Spurtcommerce backend
`SPURTCOMMERECE_API_KEY`	API key for authenticating requests
`MCP_SERVER_PATH`	(Optional) Absolute path to the built MCP server file for local development

Available Tools

This MCP server provides the following tools:

Tool Name	Description
`get_product_by_sku`	Retrieve detailed product information using SKU
`get_all_category`	Fetch all available product categories
`search_products`	Search products by keyword or filters

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

Prompt Name	Description
`spurtcommerce_product_search`	Helps you search products and fetch relevant product details using available tools

Development

@spurtcommerce/mcp – Monorepo Setup

This repository contains three main parts:

project-root/
│
├── agent/                     # Main backend service (Node.js/Express)
└── servers/
    └── spurtcommerce/         # MCP server (@spurtcommerce/mcp)

1. Install Dependencies

Backend (agent):

cd agent
npm install

MCP Server:

cd servers/spurtcommerce
npm install

2. Environment Variables

Agent (agent/.env):

ANTHROPIC_API_KEY=your_api_key
SOCKET_PORT=3001
# Optional: Directly point to built MCP server
MCP_SERVER_PATH=servers/spurtcommerce/dist/index.js

3. Development

MCP Server (servers/spurtcommerce)

The MCP server is built with the MCP SDK and communicates with the Spurtcommerce API.

Build:

npm run build

Run locally:

node $(pwd)/dist/index.js

4. Running the Project

Start agent backend:

cd agent
npm start